{"id":1826,"date":"2020-05-25T11:26:48","date_gmt":"2020-05-25T09:26:48","guid":{"rendered":"https:\/\/www.trans.eu\/api\/?p=1826"},"modified":"2025-12-29T11:06:31","modified_gmt":"2025-12-29T10:06:31","slug":"integration-scenario-for-carrier","status":"publish","type":"post","link":"https:\/\/www.trans.eu\/api\/use-cases\/integration-scenario-for-carrier\/","title":{"rendered":"Example of a carrier integration scenario"},"content":{"rendered":"\n<p>Descrip\u00adtion of receiv\u00ading new goods trans\u00adport pro\u00adpos\u00adals direct\u00adly from the client (ship\u00adper, freight for\u00adwarder) along with price nego\u00adti\u00ada\u00adtions and their accep\u00adtance.<\/p>\n\n\n\n<!--more-->\n\n\n\n<h2 class=\"wp-block-heading\">Scenario<\/h2>\n\n\n\n<ul class=\"wp-block-list\">\n<li>The client (e.g. a freight for\u00adwarder or ship\u00adper) pub\u00adlish\u00ades an offer (freight) direct\u00adly to a car\u00adri\u00ader or a group of car\u00adri\u00aders,<\/li>\n\n\n\n<li>car\u00adri\u00ader uses Trans.eu to receive new coop\u00ader\u00ada\u00adtion pro\u00adpos\u00adals,<\/li>\n\n\n\n<li>car\u00adri\u00ader active\u00adly uses Plat\u00adform for freight man\u00adage\u00adment,<\/li>\n\n\n\n<li>both freight for\u00adwarder and car\u00adri\u00aders have exist\u00ading and valid Trans.eu account,<\/li>\n\n\n\n<li>car\u00adri\u00ader down\u00adloads all freight coop\u00ader\u00ada\u00adtion pro\u00adpos\u00adals from Trans.eu to exter\u00adnal TMS,<\/li>\n\n\n\n<li>nego\u00adti\u00ada\u00adtion process is moved to exter\u00adnal TMS,<\/li>\n\n\n\n<li>freight accep\u00adtance is moved to exter\u00adnal TMS,<\/li>\n\n\n\n<li>for accept\u00aded freight there is a trans\u00adport order received.<\/li>\n<\/ul>\n\n\n\n<h2 class=\"wp-block-heading\"><strong>Diagram<\/strong><\/h2>\n\n\n<div class=\"wp-block-image\">\n<figure class=\"aligncenter\"><img loading=\"lazy\" decoding=\"async\" width=\"644\" height=\"371\" src=\"https:\/\/www.trans.eu\/api\/wp-content\/uploads\/Carrier-scenario.png\" alt class=\"wp-image-2016\" srcset=\"https:\/\/www.trans.eu\/api\/wp-content\/uploads\/Carrier-scenario.png 644w, https:\/\/www.trans.eu\/api\/wp-content\/uploads\/Carrier-scenario-300x173.png 300w\" sizes=\"auto, (max-width: 644px) 100vw, 644px\"><\/figure>\n<\/div>\n\n\n<h2 class=\"wp-block-heading\">Authorize access<\/h2>\n\n\n\n<p>Before it is pos\u00adsi\u00adble to send any request, user needs to <a href=\"https:\/\/www.trans.eu\/api\/general-information\/authorization-process\/\" title>autho\u00adrize access<\/a>.<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>client app was reg\u00adis\u00adtered using reg\u00adis\u00adtra\u00adtion form<\/li>\n\n\n\n<li>exter\u00adnal app was grant\u00aded api keys (client_id and client_secret)<\/li>\n\n\n\n<li>autho\u00adriza\u00adtion process has been imple\u00adment\u00aded in exter\u00adnal app<\/li>\n<\/ul>\n\n\n\n<h2 class=\"wp-block-heading\">Receive new freights<\/h2>\n\n\n\n<p>Each freight will con\u00adsist of:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>array of car\u00adri\u00aders\u2019 ids<\/li>\n\n\n\n<li>load\u00ading loca\u00adtion and time<\/li>\n\n\n\n<li>unload\u00ading loca\u00adtion and time<\/li>\n\n\n\n<li>required truck body type<\/li>\n\n\n\n<li>sum\u00adma\u00adry of freight\u2019s loads weight<\/li>\n\n\n\n<li>ftl\/ltl para\u00adme\u00adter<\/li>\n<\/ul>\n\n\n\n<p>Exam\u00adple pay\u00adload can be found <a href=\"https:\/\/www.trans.eu\/api\/freights\/create-new-freight\/\">here<\/a>.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Negotiate freight conditions<\/h2>\n\n\n\n<p>If freight pric\u00ading con\u00addi\u00adtions did not meet car\u00adri\u00aders expec\u00adta\u00adtion, they&nbsp; might be allowed to nego\u00adti\u00adate the price.<\/p>\n\n\n\n<p>Each price nego\u00adti\u00ada\u00adtion offer con\u00adsists of:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>price val\u00adue<\/li>\n\n\n\n<li>price cur\u00adren\u00adcy<\/li>\n\n\n\n<li>iden\u00adti\u00adfi\u00adca\u00adtion of offer cre\u00adator<\/li>\n\n\n\n<li>ver\u00adsion of offer<\/li>\n\n\n\n<li>date and time of offer cre\u00adation<\/li>\n<\/ul>\n\n\n\n<p>Freight nego\u00adti\u00ada\u00adtion details can be found <a href=\"https:\/\/www.trans.eu\/api\/freights\/negotiation-process\/\">here<\/a>.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Receive transport order<\/h2>\n\n\n\n<p>Accept\u00aded freight cre\u00adates trans\u00adport order, which con\u00adsists of:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>freight details (freight id, loca\u00adtions, loads, require\u00adments, etc)<\/li>\n\n\n\n<li>car\u00adri\u00ader details (address and VAT num\u00adber)<\/li>\n\n\n\n<li>freight for\u00adwarder details (address and VAT num\u00adber)<\/li>\n\n\n\n<li>dri\u00adver details<\/li>\n\n\n\n<li>vehi\u00adcle details<\/li>\n<\/ul>\n\n\n\n<p>For more details about trans\u00adport orders please click <a href=\"https:\/\/www.trans.eu\/api\/orders\/list-of-received-orders\/\">here<\/a>.<\/p>\n","protected":false},"excerpt":{"rendered":"<p class=\"dont-break-out\">Descrip\u00adtion of receiv\u00ading new goods trans\u00adport pro\u00adpos\u00adals direct\u00adly from the client (ship\u00adper, freight for\u00adwarder) along with price nego\u00adti\u00ada\u00adtions and their \u2026<\/p>\n","protected":false},"author":4,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"wp_typography_post_enhancements_disabled":false,"footnotes":""},"categories":[58,56],"tags":[],"class_list":["post-1826","post","type-post","status-publish","format-standard","hentry","category-integration-scenarios","category-use-cases"],"acf":[],"aioseo_notices":[],"lang":"en","translations":{"en":1826},"pll_sync_post":[],"_links":{"self":[{"href":"https:\/\/www.trans.eu\/api\/wp-json\/wp\/v2\/posts\/1826","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.trans.eu\/api\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.trans.eu\/api\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.trans.eu\/api\/wp-json\/wp\/v2\/users\/4"}],"replies":[{"embeddable":true,"href":"https:\/\/www.trans.eu\/api\/wp-json\/wp\/v2\/comments?post=1826"}],"version-history":[{"count":2,"href":"https:\/\/www.trans.eu\/api\/wp-json\/wp\/v2\/posts\/1826\/revisions"}],"predecessor-version":[{"id":5541,"href":"https:\/\/www.trans.eu\/api\/wp-json\/wp\/v2\/posts\/1826\/revisions\/5541"}],"wp:attachment":[{"href":"https:\/\/www.trans.eu\/api\/wp-json\/wp\/v2\/media?parent=1826"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.trans.eu\/api\/wp-json\/wp\/v2\/categories?post=1826"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.trans.eu\/api\/wp-json\/wp\/v2\/tags?post=1826"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}