{"id":1470,"date":"2020-03-30T11:29:10","date_gmt":"2020-03-30T09:29:10","guid":{"rendered":"https:\/\/www.trans.eu\/api\/?p=1470"},"modified":"2025-12-29T11:13:28","modified_gmt":"2025-12-29T10:13:28","slug":"new-freight-to-group","status":"publish","type":"post","link":"https:\/\/www.trans.eu\/api\/freights\/new-freight-to-group\/","title":{"rendered":"New freight to selected companies"},"content":{"rendered":"\n<p>Cre\u00adat\u00ading new freight in Trans.eu Plat\u00adform and send\u00ading it direct\u00adly to cho\u00adsen car\u00adri\u00aders.<\/p>\n\n\n\n<!--more-->\n\n\n\n<h2 class=\"wp-block-heading\">Url parameters and connection settings<\/h2>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>URL:<\/strong> https:\/\/api.platform.trans.eu<\/li>\n\n\n\n<li><strong>End\u00adpoint:<\/strong> \/ex\u00adt\/freights-api\/v1\/freight-com\u00adpa\u00adnies<\/li>\n\n\n\n<li><strong>Method:<\/strong> POST<\/li>\n<\/ul>\n\n\n\n<h2 class=\"wp-block-heading\">Headers:<\/h2>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Con\u00adtent-type: application\/json<\/li>\n\n\n\n<li>Accept: application\/json<\/li>\n\n\n\n<li>Autho\u00adriza\u00adtion: Bear\u00ader {access_token}<\/li>\n\n\n\n<li>Api-key: {unique_app_api_key}<\/li>\n<\/ul>\n\n\n\n<h2 class=\"wp-block-heading\">Authorization<\/h2>\n\n\n\n<p>Autho\u00adriza\u00adtion process <a href=\"https:\/\/www.trans.eu\/api\/general-information\/authorization-process\/\" target=\"_blank\" rel=\"noopener\" title>is described here<\/a>. Each API request must also con\u00adsist of unique Api-key obtained dur\u00ading appli\u00adca\u00adtion reg\u00adis\u00adtra\u00adtion togeth\u00ader with client_id and client_secret.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Freight publication and content<\/h2>\n\n\n\n<p>For infor\u00adma\u00adtion about freight pay\u00adload please refer to <a href=\"https:\/\/www.trans.eu\/api\/freights\/freight-description\/\">freight descrip\u00adtion<\/a>&nbsp;and <a href=\"https:\/\/www.trans.eu\/api\/freights\/new-freight-to-direct-person\/\" title>freight schema<\/a>.<\/p>\n\n\n\n<p>Pub\u00adli\u00adca\u00adtion of freight to select\u00aded com\u00adpa\u00adnies requires at least one com\u00adpa\u00adny id to be giv\u00aden:<\/p>\n\n\n\n<div class=\"hcb_wrap\"><pre class=\"prism line-numbers lang-json\" data-lang=\"JSON\" data-show-lang=\"1\"><code>\"carriers\" : [ { \"company_id\" : 123 }]<\/code><\/pre><\/div>\n\n\n\n<p>Using this pub\u00adli\u00adca\u00adtion method it is pos\u00adsi\u00adble to use \u201cis_first_buy\u201d method, which allows to auto\u00admat\u00adi\u00adcal\u00adly accept first offer for giv\u00aden price.<\/p>\n\n\n\n<p>Also, please remem\u00adber to set <strong>pub\u00adlish<\/strong> para\u00adme\u00adter to <strong>true<\/strong>.<\/p>\n\n\n\n<figure class=\"wp-block-table\"><table><tbody><tr><td><strong>Json <\/strong><\/td><td><strong>Exam\u00adple<\/strong><\/td><td><strong>Type<\/strong><\/td><td><strong>Is required<\/strong><\/td><td><strong>Descrip\u00adtion<\/strong><\/td><\/tr><tr><td>shipment_external_id<\/td><td>2020\/ABC\/1\/1<\/td><td>String<\/td><td>No<\/td><td>Exter\u00adnal iden\u00adti\u00adfi\u00adca\u00adtion num\u00adber<\/td><\/tr><tr><td>external_source<\/td><td>1_api<\/td><td>String<\/td><td>No<\/td><td>Freight source iden\u00adti\u00adfi\u00ader assigned to client_id pro\u00advid\u00aded by Trans.eu<\/td><\/tr><tr><td>capac\u00adi\u00adty<\/td><td>12<\/td><td>Float<\/td><td>Yes<\/td><td>Total freight capac\u00adi\u00adty in tonnes. This val\u00adue is being val\u00adi\u00addat\u00aded in com\u00adpar\u00adi\u00adson to the sum of all loads weight.<br>Range: 0,001 \u2013 100000<\/td><\/tr><tr><td>is_first_buy<\/td><td>Yes<\/td><td>Boolean<\/td><td>No<\/td><td>Defines if price will be nego\u00adti\u00adat\u00aded or only accept\u00aded by car\u00adri\u00ader<\/td><\/tr><tr><td>pub\u00adlish<\/td><td>True<\/td><td>Boolean<\/td><td>Yes<\/td><td>Deter\u00admines if the freight is auto\u00admat\u00adi\u00adcal\u00adly pub\u00adlished or only cre\u00adat\u00aded<\/td><\/tr><tr><td>pay\u00adment<\/td><td>Object<\/td><td><\/td><td>No<\/td><td>Pay\u00adment con\u00addi\u00adtions for pub\u00adli\u00adca\u00adtion using groups or smart match<\/td><\/tr><tr><td>require\u00adments<\/td><td>Object<\/td><td><\/td><td>Yes<\/td><td>Main freight require\u00adments, includ\u00ading truck body and size adr class\u00ades, ways of load\u00ading<\/td><\/tr><tr><td>car\u00adri\u00aders<\/td><td>&nbsp;Array<\/td><td><\/td><td>Yes<\/td><td>Con\u00adtains a list of carrier\u2019s com\u00adpa\u00adny iden\u00adti\u00adfiers (at least one of com\u00adpa\u00adny id\u2019s must be valid)<\/td><\/tr><tr><td>loads<\/td><td>Array<\/td><td><\/td><td>No<\/td><td>Col\u00adlec\u00adtion of freights\u2019 loads. It is pos\u00adsi\u00adble to send emp\u00adty array of loads, nev\u00ader\u00adthe\u00adless an array has to be set<\/td><\/tr><tr><td>spots<\/td><td>Object<\/td><td><\/td><td>Yes<\/td><td>Col\u00adlec\u00adtion of freights\u2019 spots \u2014 at least one load\u00ading and one unload\u00ading is required<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<h2 class=\"wp-block-heading\">Example request<\/h2>\n\n\n\n<p>Sam\u00adple Json for cre\u00adat\u00ading new freight using required data only<\/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        }\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        }\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<div class=\"hcb_wrap\"><pre class=\"prism line-numbers lang-json\" data-lang=\"JSON\"><code>{\n  \"accepted_price\": null,\n  \"capacity\": 12,\n  \"carrier\": null,\n  \"id\": 592018,\n  \"loading_meters\": null,\n  \"loads\": [],\n  \"publication_price\": null,\n  \"reference_number\": \"FR\/2021\/02\/03\/X64K\",\n  \"requirements\": {\n    \"is_ftl\": false,\n    \"other_requirements\": [],\n    \"required_adr_classes\": [],\n    \"required_truck_bodies\": [\n      \"curtainsider\"\n    ],\n    \"required_ways_of_loading\": [],\n    \"shipping_remarks\": null,\n    \"temperature\": {\n      \"max\": null,\n      \"min\": null\n    },\n    \"vehicle_size\": \"any_size\"\n  },\n  \"shipment_external_id\": null,\n  \"spots\": [\n    {\n      \"description\": null,\n      \"name\": null,\n      \"operations\": [\n        {\n          \"loads\": [],\n          \"operation_order\": 1,\n          \"timespans\": {\n            \"begin\": \"2021-02-03T13:00:00+01:00\",\n            \"end\": \"2021-02-03T14:00:00+01:00\"\n          },\n          \"type\": \"loading\"\n        }\n      ],\n      \"place\": {\n        \"address\": {\n          \"country\": \"PL\",\n          \"description\": null,\n          \"locality\": \"Wroclaw\",\n          \"number\": null,\n          \"postal_code\": \"12345\",\n          \"street\": null\n        },\n        \"coordinates\": {\n          \"latitude\": null,\n          \"longitude\": null\n        }\n      },\n      \"spot_order\": 1\n    },\n    {\n      \"description\": null,\n      \"name\": null,\n      \"operations\": [\n        {\n          \"loads\": [],\n          \"operation_order\": 1,\n          \"timespans\": {\n            \"begin\": \"2021-02-04T08:00:00+01:00\",\n            \"end\": \"2021-02-04T08:00:00+01:00\"\n          },\n          \"type\": \"unloading\"\n        }\n      ],\n      \"place\": {\n        \"address\": {\n          \"country\": \"DE\",\n          \"description\": null,\n          \"locality\": \"N\u00fcrnberg\",\n          \"number\": null,\n          \"postal_code\": \"09876\",\n          \"street\": null\n        },\n        \"coordinates\": {\n          \"latitude\": null,\n          \"longitude\": null\n        }\n      },\n      \"spot_order\": 2\n    }\n  ],\n  \"status\": \"new\"\n}<\/code><\/pre><\/div>\n","protected":false},"excerpt":{"rendered":"<p class=\"dont-break-out\">Cre\u00adat\u00ading new freight in Trans.eu Plat\u00adform and send\u00ading it direct\u00adly to cho\u00adsen car\u00adri\u00aders.<\/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":[83,42],"tags":[],"class_list":["post-1470","post","type-post","status-publish","format-standard","hentry","category-create-new-freight","category-freights"],"acf":[],"aioseo_notices":[],"lang":"en","translations":{"en":1470},"pll_sync_post":[],"_links":{"self":[{"href":"https:\/\/www.trans.eu\/api\/wp-json\/wp\/v2\/posts\/1470","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=1470"}],"version-history":[{"count":2,"href":"https:\/\/www.trans.eu\/api\/wp-json\/wp\/v2\/posts\/1470\/revisions"}],"predecessor-version":[{"id":5563,"href":"https:\/\/www.trans.eu\/api\/wp-json\/wp\/v2\/posts\/1470\/revisions\/5563"}],"wp:attachment":[{"href":"https:\/\/www.trans.eu\/api\/wp-json\/wp\/v2\/media?parent=1470"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.trans.eu\/api\/wp-json\/wp\/v2\/categories?post=1470"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.trans.eu\/api\/wp-json\/wp\/v2\/tags?post=1470"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}