{"id":1813,"date":"2020-05-22T12:50:37","date_gmt":"2020-05-22T10:50:37","guid":{"rendered":"https:\/\/www.trans.eu\/api\/?p=1813"},"modified":"2026-01-08T14:37:39","modified_gmt":"2026-01-08T13:37:39","slug":"searching-for-a-carrier-without-given-price","status":"publish","type":"post","link":"https:\/\/www.trans.eu\/api\/use-cases\/searching-for-a-carrier-without-given-price\/","title":{"rendered":"Searching for a carrier without given price"},"content":{"rendered":"\n<p>Descrip\u00adtion of adding a freight for select\u00aded com\u00adpa\u00adnies, with\u00adout declar\u00ading the freight price.<\/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>car\u00adri\u00ader is yet to be deter\u00admined<\/li>\n\n\n\n<li>car\u00adri\u00ader\u2019s Tran\u00adsId is avail\u00adable in exter\u00adnal TMS<\/li>\n\n\n\n<li>price was not giv\u00aden<\/li>\n\n\n\n<li>car\u00adri\u00ader is using Trans.eu Plat\u00adform only, with no addi\u00adtion\u00adal freight man\u00adage\u00adment soft\u00adware involved<\/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>price nego\u00adti\u00ada\u00adtion process is avail\u00adable from the exter\u00adnal app<\/li>\n<\/ul>\n\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\">Create new freight<\/h2>\n\n\n\n<p>Each freight must 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<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=\"1024\" height=\"464\" src=\"https:\/\/www.trans.eu\/api\/wp-content\/uploads\/publikacja-do-carriera-z-negocjacj-1-1024x464.png\" alt class=\"wp-image-3395\" srcset=\"https:\/\/www.trans.eu\/api\/wp-content\/uploads\/publikacja-do-carriera-z-negocjacj-1-1024x464.png 1024w, https:\/\/www.trans.eu\/api\/wp-content\/uploads\/publikacja-do-carriera-z-negocjacj-1-300x136.png 300w, https:\/\/www.trans.eu\/api\/wp-content\/uploads\/publikacja-do-carriera-z-negocjacj-1-768x348.png 768w, https:\/\/www.trans.eu\/api\/wp-content\/uploads\/publikacja-do-carriera-z-negocjacj-1-1536x696.png 1536w, https:\/\/www.trans.eu\/api\/wp-content\/uploads\/publikacja-do-carriera-z-negocjacj-1-2048x928.png 2048w\" sizes=\"auto, (max-width: 1024px) 100vw, 1024px\"><\/figure>\n<\/div>\n\n\n<h2 class=\"wp-block-heading\">Request<\/h2>\n\n\n\n<p>To cre\u00adate new freight for select\u00aded com\u00adpa\u00adnies, there should be <a href=\"https:\/\/www.trans.eu\/api\/freights\/new-freight-to-group\/\">send freight to com\u00adpa\u00adnies pub\u00adli\u00adca\u00adtion method<\/a> used.<\/p>\n\n\n\n<div class=\"hcb_wrap\"><pre class=\"prism line-numbers lang-json\" data-lang=\"JSON\"><code>POST https:\/\/api.platform.trans.eu\/ext\/freights-api\/v1\/freight-companies<\/code><\/pre><\/div>\n\n\n\n<h2 class=\"wp-block-heading\"><strong>Request example:&nbsp;<\/strong><\/h2>\n\n\n\n<p>Exam\u00adple freight post\u00ading request:<\/p>\n\n\n\n<div class=\"hcb_wrap\"><pre class=\"prism line-numbers lang-json\" data-lang=\"JSON\"><code>{\n  \"capacity\": 12,\n  \"requirements\": {\n    \"is_ftl\": false,\n    \"required_truck_bodies\": [\n      \"curtainsider\"\n    ],\n    \"loads\": []\n  },\n  \"carriers\": [\n    {\n      \"company_id\": 10\n    }\n  ],\n  \"spots\": [\n    {\n      \"spot_order\": 1,\n      \"place\": {\n        \"address\": {\n          \"country\": \"PL\",\n          \"postal_code\": \"12345\",\n          \"locality\": \"Wroclaw\"\n        }\n      },\n      \"operations\": [\n        {\n          \"timespans\": {\n            \"begin\": \"2021-02-03T13:00:00+0100\",\n            \"end\": \"2021-02-03T14:00:00+0100\"\n          },\n          \"type\": \"loading\",\n          \"operation_order\": 1,\n          \"loads\": []\n        }\n      ]\n    },\n    {\n      \"spot_order\": 2,\n      \"place\": {\n        \"address\": {\n          \"country\": \"DE\",\n          \"postal_code\": \"09876\",\n          \"locality\": \"N\u00fcrnberg\"\n        }\n      },\n      \"operations\": [\n        {\n          \"timespans\": {\n            \"begin\": \"2021-02-04T08:00:00+0100\",\n            \"end\": \"2021-02-04T08:00:00+0100\"\n          },\n          \"type\": \"unloading\",\n          \"operation_order\": 1,\n          \"loads\": []\n        }\n      ]\n    }\n  ],\n  \"publish\": true\n}<\/code><\/pre><\/div>\n\n\n\n<h2 class=\"wp-block-heading\">Response<\/h2>\n\n\n\n<p>Each car\u00adri\u00ader might respond with price con\u00addi\u00adtions accep\u00adtance. Direct\u00adly after freight pub\u00adli\u00adca\u00adtion there will be an emp\u00adty array of offers received using:<\/p>\n\n\n\n<div class=\"hcb_wrap\"><pre class=\"prism line-numbers lang-json\" data-lang=\"JSON\"><code>https:\/\/api.platform.tran.eu\/ext\/freights-api\/v1\/freights\/:freightId\/offers<\/code><\/pre><\/div>\n\n\n\n<p>Once offer is sent by car\u00adri\u00ader, it will fill out this array, for exam\u00adple:<\/p>\n\n\n\n<div class=\"hcb_wrap\"><pre class=\"prism line-numbers lang-json\" data-lang=\"JSON\"><code>[\n  {\n    \"company_id\": 1111111,\n    \"created_at\": \"2021-07-23T13:25:02+02:00\",\n    \"freight_id\": 820262,\n    \"id\": 1892813,\n    \"legal_name\": \"Firma Testowa Przewo\u017anik\",\n    \"price\": {\n      \"currency\": \"eur\",\n      \"value\": 130\n    },\n    \"status\": \"waiting_for_accept\",\n    \"trans_id\": \"1111111-1\",\n    \"vat_id\": \"1111111111\",\n    \"version\": 3\n  }\n]<\/code><\/pre><\/div>\n\n\n\n<h2 class=\"wp-block-heading\">Conditions:<\/h2>\n\n\n\n<ul class=\"wp-block-list\">\n<li>each offer has own unique id<\/li>\n\n\n\n<li>each car\u00adri\u00ader is allowed to send one offer<\/li>\n\n\n\n<li>each offer can be respond\u00aded to<\/li>\n<\/ul>\n","protected":false},"excerpt":{"rendered":"<p class=\"dont-break-out\">Descrip\u00adtion of adding a freight for select\u00aded com\u00adpa\u00adnies, with\u00adout declar\u00ading the freight price.<\/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":[56],"tags":[],"class_list":["post-1813","post","type-post","status-publish","format-standard","hentry","category-use-cases"],"acf":[],"aioseo_notices":[],"lang":"en","translations":{"en":1813},"pll_sync_post":[],"_links":{"self":[{"href":"https:\/\/www.trans.eu\/api\/wp-json\/wp\/v2\/posts\/1813","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=1813"}],"version-history":[{"count":1,"href":"https:\/\/www.trans.eu\/api\/wp-json\/wp\/v2\/posts\/1813\/revisions"}],"predecessor-version":[{"id":5556,"href":"https:\/\/www.trans.eu\/api\/wp-json\/wp\/v2\/posts\/1813\/revisions\/5556"}],"wp:attachment":[{"href":"https:\/\/www.trans.eu\/api\/wp-json\/wp\/v2\/media?parent=1813"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.trans.eu\/api\/wp-json\/wp\/v2\/categories?post=1813"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.trans.eu\/api\/wp-json\/wp\/v2\/tags?post=1813"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}