{"id":5942,"date":"2026-02-23T12:43:47","date_gmt":"2026-02-23T11:43:47","guid":{"rendered":"https:\/\/www.trans.eu\/api\/?p=5942"},"modified":"2026-04-15T14:54:09","modified_gmt":"2026-04-15T12:54:09","slug":"publish-to-private-exchange","status":"publish","type":"post","link":"https:\/\/www.trans.eu\/api\/freights-section\/publish-to-private-exchange\/","title":{"rendered":"Publish to private exchange"},"content":{"rendered":"\n<div class=\"wp-block-columns is-layout-flex wp-container-core-columns-is-layout-9d6595d7 wp-block-columns-is-layout-flex\">\n<div class=\"wp-block-column is-layout-flow wp-block-column-is-layout-flow\">\n<p>Cre\u00adat\u00ading a new freight and pub\u00adlish\u00ading it to the pri\u00advate exchange defined for your com\u00adpa\u00adny.<br>Your com\u00adpa\u00adny\u2019s pri\u00advate exchange is vis\u00adi\u00adble in the Con\u00adtrac\u00adtors mod\u00adule at Plat\u00adform.<\/p>\n\n\n\n<!--more-->\n\n\n\n<p>After suc\u00adcess\u00adful\u00adly exe\u00adcut\u00ading the method, you receive in response the freight details with the unique freight iden\u00adti\u00adfi\u00adca\u00adtion num\u00adber <strong>id <\/strong>assigned when cre\u00adat\u00ading the new freight.<br>This method can also be used to sim\u00adply cre\u00adate a work\u00ading copy of the freight for sub\u00adse\u00adquent man\u00adu\u00adal pub\u00adli\u00adca\u00adtion using any method on the Plat\u00adform.<br>See more infor\u00adma\u00adtion about <a href=\"https:\/\/www.trans.eu\/api\/freights-section\/freight-publication\/\" target=\"_blank\" rel=\"noopener\" title>freight pub\u00adli\u00adca\u00adtion<\/a>.<\/p>\n<\/div>\n\n\n\n<div class=\"wp-block-column is-layout-flow wp-block-column-is-layout-flow\">\n<pre class=\"wp-block-preformatted\"><strong>POST<\/strong><br>\/ext\/freights-api\/v1\/private-exchange<\/pre>\n<\/div>\n<\/div>\n\n\n\n<div style=\"height:56px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<div class=\"wp-block-columns has-background is-layout-flex wp-container-core-columns-is-layout-9d6595d7 wp-block-columns-is-layout-flex\" style=\"background-color:#eaeaea\">\n<div class=\"wp-block-column is-vertically-aligned-center is-layout-flow wp-block-column-is-layout-flow\" style=\"flex-basis:25%\">\n<h6 class=\"wp-block-heading has-text-align-right\" style=\"font-style:normal;font-weight:700\"> Request Authorization<\/h6>\n<\/div>\n\n\n\n<div class=\"wp-block-column is-layout-flow wp-block-column-is-layout-flow\" style=\"flex-basis:75%\">\n<p>Every request MUST include a valid access token obtained dur\u00ading <a href=\"https:\/\/www.trans.eu\/api\/general-information\/authorization-process\/\" target=\"_blank\" rel=\"noopener\" title>the user autho\u00adriza\u00adtion process<\/a>, pro\u00advid\u00aded using the Bear\u00ader token scheme in the Autho\u00adriza\u00adtion head\u00ader.<\/p>\n<\/div>\n<\/div>\n\n\n\n<div class=\"wp-block-columns has-background is-layout-flex wp-container-core-columns-is-layout-9d6595d7 wp-block-columns-is-layout-flex\" style=\"background-color:#eaeaea\">\n<div class=\"wp-block-column is-vertically-aligned-top is-layout-flow wp-block-column-is-layout-flow\" style=\"flex-basis:25%\">\n<h6 class=\"wp-block-heading has-text-align-right\" style=\"font-style:normal;font-weight:700\"> Request<\/h6>\n<\/div>\n\n\n\n<div class=\"wp-block-column is-layout-flow wp-block-column-is-layout-flow\" style=\"flex-basis:75%\">\n<div class=\"wp-block-columns is-layout-flex wp-container-core-columns-is-layout-9d6595d7 wp-block-columns-is-layout-flex\">\n<div class=\"wp-block-column is-vertically-aligned-center is-layout-flow wp-block-column-is-layout-flow\">\n<p><a href=\"#requestheader\" title>Request Head\u00ader<\/a><\/p>\n<\/div>\n\n\n\n<div class=\"wp-block-column is-vertically-aligned-center is-layout-flow wp-block-column-is-layout-flow\">\n<p><a href=\"#requeststructure\" title>Request Para\u00adme\u00adters<\/a><\/p>\n<\/div>\n\n\n\n<div class=\"wp-block-column is-vertically-aligned-bottom is-layout-flow wp-block-column-is-layout-flow\">\n<p><a href=\"#requestbody\" title>Request Body<\/a><\/p>\n<\/div>\n<\/div>\n<\/div>\n<\/div>\n\n\n\n<div class=\"wp-block-columns has-background is-layout-flex wp-container-core-columns-is-layout-9d6595d7 wp-block-columns-is-layout-flex\" style=\"background-color:#eaeaea\">\n<div class=\"wp-block-column is-vertically-aligned-top is-layout-flow wp-block-column-is-layout-flow\" style=\"flex-basis:25%\">\n<h6 class=\"wp-block-heading has-text-align-right\" style=\"font-style:normal;font-weight:700\"> Successful Response<\/h6>\n<\/div>\n\n\n\n<div class=\"wp-block-column is-vertically-aligned-center is-layout-flow wp-block-column-is-layout-flow\" style=\"flex-basis:75%\">\n<div class=\"wp-block-columns is-layout-flex wp-container-core-columns-is-layout-9d6595d7 wp-block-columns-is-layout-flex\">\n<div class=\"wp-block-column is-vertically-aligned-center is-layout-flow wp-block-column-is-layout-flow\">\n<p><a href=\"#responsefields\" title>Response Fields<\/a><\/p>\n<\/div>\n\n\n\n<div class=\"wp-block-column is-vertically-aligned-center is-layout-flow wp-block-column-is-layout-flow\">\n<p><a href=\"#responsebody\" title=\"Response Body\">Response Body<\/a><\/p>\n<\/div>\n\n\n\n<div class=\"wp-block-column is-layout-flow wp-block-column-is-layout-flow\">\n<p><\/p>\n<\/div>\n<\/div>\n<\/div>\n<\/div>\n\n\n\n<div class=\"wp-block-columns has-background is-layout-flex wp-container-core-columns-is-layout-9d6595d7 wp-block-columns-is-layout-flex\" style=\"background-color:#eaeaea\">\n<div class=\"wp-block-column is-vertically-aligned-top is-layout-flow wp-block-column-is-layout-flow\" style=\"flex-basis:25%\">\n<h6 class=\"wp-block-heading has-text-align-right\" style=\"font-style:normal;font-weight:700\"> Error Response<\/h6>\n<\/div>\n\n\n\n<div class=\"wp-block-column is-layout-flow wp-block-column-is-layout-flow\" style=\"flex-basis:75%\">\n<div class=\"wp-block-columns is-layout-flex wp-container-core-columns-is-layout-9d6595d7 wp-block-columns-is-layout-flex\">\n<div class=\"wp-block-column is-vertically-aligned-center is-layout-flow wp-block-column-is-layout-flow\">\n<p><a href=\"#validationerrors\" title>Client errors (400)<\/a><\/p>\n<\/div>\n\n\n\n<div class=\"wp-block-column is-layout-flow wp-block-column-is-layout-flow\">\n<p><\/p>\n<\/div>\n\n\n\n<div class=\"wp-block-column is-vertically-aligned-center is-layout-flow wp-block-column-is-layout-flow\">\n<p><a href=\"https:\/\/www.trans.eu\/api\/general-information\/enpoint-and-validation-errors\/\" target=\"_blank\" rel=\"noopener\" title>Gen\u00ader\u00adal API errors<\/a><\/p>\n<\/div>\n<\/div>\n<\/div>\n<\/div>\n\n\n\n<div style=\"height:56px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<div class=\"wp-block-columns is-layout-flex wp-container-core-columns-is-layout-9d6595d7 wp-block-columns-is-layout-flex\" id=\"requestheader\">\n<div class=\"wp-block-column is-vertically-aligned-center is-layout-flow wp-block-column-is-layout-flow\" style=\"flex-basis:25%\">\n<h6 class=\"wp-block-heading\" style=\"font-style:normal;font-weight:700\">Request Header<\/h6>\n<\/div>\n\n\n\n<div class=\"wp-block-column is-layout-flow wp-block-column-is-layout-flow\" style=\"flex-basis:75%\">\n<div class=\"hcb_wrap\"><pre class=\"prism line-numbers lang-json\" data-lang=\"JSON\"><code>POST \/ext\/freights-api\/v1\/private-exchange HTTP\/1.1 \nHost: api.platform.trans.eu \nContent-Type: application\/json\nAccept: application\/json\nAuthorization: Bearer {access_token) \nApi-key: {unique_app_api-key}<\/code><\/pre><\/div>\n<\/div>\n<\/div>\n\n\n\n<h6 class=\"wp-block-heading\" id=\"requeststructure\" style=\"font-style:normal;font-weight:700\">Request Parameters<\/h6>\n\n\n\n<figure class=\"wp-block-table has-small-font-size\"><table><tbody><tr><td>Attribute<\/td><td>Type<\/td><td>Exam\u00adple<\/td><td>Manda\u00adto\u00adry<\/td><td>Descrip\u00adtion<\/td><\/tr><tr><td>callback_url<\/td><td>String<\/td><td>http:\/\/example.com\/msg<\/td><td>No<\/td><td>The return address pro\u00advid\u00aded by the client to receive freight and pub\u00adli\u00adca\u00adtion event sta\u00adtus\u00ades. See <a href=\"https:\/\/www.trans.eu\/api\/general-information\/api-callback-urls\/\" target=\"_blank\" rel=\"noopener\" title>list of avail\u00adable event sta\u00adtus\u00ades<\/a>.<\/td><\/tr><tr><td>capac\u00adi\u00adty<\/td><td>Float<\/td><td>24<\/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>contact_employees<\/td><td>Array of String<\/td><td>[\u201c13443\u20131\u201d,\u201c13443\u20132\u201d]<\/td><td>No<\/td><td>The default con\u00adtact per\u00adson is always the pub\u00adlish\u00ader. If the field is sent, the con\u00adtact per\u00adsons will be only the ID\u2019s sent in it.<\/td><\/tr><tr><td>decision_date<\/td><td>Time\u00adstamp<\/td><td>2025\u201308\u201303T13:00:00+0000<\/td><td>No<\/td><td>Defines time up to which car\u00adri\u00aders can send offers. Cal\u00adcu\u00adlat\u00aded auto\u00admat\u00adi\u00adcal\u00adly for freight-exchange pub\u00adli\u00adca\u00adtion \u2014 it can be max 23:00 on the day of unload\u00ading.<br>Required con\u00addi\u00adtion: decision_date &gt; publish_date<\/td><\/tr><tr><td>exchanges<\/td><td>Object<\/td><td><\/td><td>No<\/td><td>Con\u00adtain\u00ader with pri\u00advate exchange id<\/td><\/tr><tr><td>exchanges.exchange_id<\/td><td>String<\/td><td><\/td><td>No<\/td><td>Pri\u00advate exchange id. The val\u00adue can be checked using <a href=\"https:\/\/www.trans.eu\/api\/freights-section\/get-private-exchanges-list-2\/\" target=\"_blank\" rel=\"noopener\" title>Get pri\u00advate exchanges list<\/a> request.<\/td><\/tr><tr><td>height<\/td><td>Int or Float<\/td><td>3.2<\/td><td>No<\/td><td>Expected\/required vehi\u00adcle height (range: 0.01\u201310)<\/td><\/tr><tr><td>is_first_buy<\/td><td>Boolean<\/td><td>False<\/td><td>No<\/td><td>Defines if price can be nego\u00adti\u00adat\u00aded or only accept\u00aded by car\u00adri\u00ader.<\/td><\/tr><tr><td>length<\/td><td>Int or Float<\/td><td>5<\/td><td>No<\/td><td>Expected\/required vehi\u00adcle length (range: 0.01\u2013100)<\/td><\/tr><tr><td>loading_meters<\/td><td>Float<\/td><td>13.6<\/td><td>No<\/td><td>Total freight load\u00ading meters (range: 0,01 \u2014 417)<\/td><\/tr><tr><td>loads (<a href=\"https:\/\/www.trans.eu\/api\/objects\/object-loads\/\" target=\"_blank\" rel=\"noopener\" title>see details<\/a>)<\/td><td>Array of Objects<\/td><td><\/td><td>No<\/td><td>Col\u00adlec\u00adtion of freight loads. <\/td><\/tr><tr><td>pay\u00adment (<a href=\"https:\/\/www.trans.eu\/api\/objects\/object-payment\/\" target=\"_blank\" rel=\"noopener\" title>see details<\/a>)<\/td><td>Object<\/td><td><\/td><td>No<\/td><td>Pay\u00adment con\u00addi\u00adtions for pub\u00adli\u00adca\u00adtion<\/td><\/tr><tr><td>pub\u00adlish<\/td><td>Boolean<\/td><td>True<\/td><td>Yes<\/td><td>Deter\u00admines if the freight is auto\u00admat\u00adi\u00adcal\u00adly pub\u00adlished (True) or only cre\u00adat\u00aded (False)<\/td><\/tr><tr><td>publish_date<\/td><td>Time\u00adstamp<\/td><td>2025\u201308\u201303T13:00:00+0000<\/td><td>No<\/td><td>Pub\u00adli\u00adca\u00adtion (acti\u00adva\u00adtion) date \u2014 must be greater or equal today, NULL \u2014 imme\u00addi\u00adate pub\u00adli\u00adca\u00adtion<\/td><\/tr><tr><td>require\u00adments (<a href=\"https:\/\/www.trans.eu\/api\/objects\/object-requirements\/\" target=\"_blank\" rel=\"noopener\" title>see details<\/a>)<\/td><td>Object<\/td><td><\/td><td>Yes<\/td><td>Main freight require\u00adments<\/td><\/tr><tr><td>send_order_proposal_<br>auto\u00admat\u00adi\u00adcal\u00adly<\/td><td>Boolean<\/td><td>False<\/td><td>No<\/td><td>Sends the order con\u00addi\u00adtions auto\u00admat\u00adi\u00adcal\u00adly. This means that when the car\u00adri\u00ader accepts such freight, an order is cre\u00adat\u00aded with the terms of the order, and the ship\u00adper does not have to com\u00adplete them man\u00adu\u00adal\u00adly.<\/td><\/tr><tr><td>shipment_external_id<\/td><td>String<\/td><td>2023\/NWX\/1\/3<\/td><td>No<\/td><td>Exter\u00adnal iden\u00adti\u00adfi\u00adca\u00adtion num\u00adber<\/td><\/tr><tr><td>spots (<a href=\"https:\/\/www.trans.eu\/api\/objects\/object-spots\/\" target=\"_blank\" rel=\"noopener\" title>see details<\/a>)<\/td><td>Array of Objects<\/td><td><\/td><td>Yes<\/td><td>Col\u00adlec\u00adtion of freights\u2019 spots \u2013 at least one load\u00ading and one unload\u00ading is required<\/td><\/tr><tr><td>transit_time<\/td><td>Int or Float<\/td><td>280<\/td><td>No<\/td><td>Time expressed in min\u00adutes (pos\u00adi\u00adtive inte\u00adger) for trans\u00adport. Must be less than the dif\u00adfer\u00adence between the last unload\u00ading and the first load\u00ading.<\/td><\/tr><tr><td>vol\u00adume<\/td><td>Int or Float<\/td><td>21<\/td><td>No<\/td><td>Expected\/required vehi\u00adcle vol\u00adume (range: 0.01\u201310000)<\/td><\/tr><tr><td>width<\/td><td>Int or Float<\/td><td>3.1<\/td><td>No<\/td><td>Expected\/required vehi\u00adcle width (range: 0.01\u201310)<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<div class=\"wp-block-columns is-layout-flex wp-container-core-columns-is-layout-9d6595d7 wp-block-columns-is-layout-flex\">\n<div class=\"wp-block-column is-vertically-aligned-center is-layout-flow wp-block-column-is-layout-flow\" style=\"flex-basis:25%\" id=\"requestbody\">\n<h6 class=\"wp-block-heading\" style=\"font-style:normal;font-weight:700\">Example Request Body<\/h6>\n<\/div>\n\n\n\n<div class=\"wp-block-column is-layout-flow wp-block-column-is-layout-flow\" style=\"flex-basis:75%\">\n<div class=\"hcb_wrap\"><pre class=\"prism line-numbers lang-json\" data-lang=\"JSON\"><code>{\n  \"callback_url\": \"http:\/\/example.com\/msg\",  \n  \"capacity\": 12,\n  \"decision_date\": \"2026-02-23T16:55:00+0100\",\n  \"exchanges\": [\n    {\n        \"exchange_id\": \"49b9aa2b-1987-48d9-9a77-147f97594233\"\n    }\n  ],\n  \"height\":4.3,\n  \"length\":5.8,\n  \"loading_meters\": 10.1,\n  \"payment\": {\n    \"price\": {\n        \"value\": 450,\n        \"currency\": \"eur\",\n        \"period\": { \n            \"payment\": \"deferred\", \n            \"days\": 21\n        }\n    }\n  },\n  \"publish\": true,\n  \"publish_date\": null,\n  \"requirements\": {\n    \"is_ftl\": true,\n    \"required_truck_bodies\": [\n      \"curtainsider\"\n    ],\n    \"required_ways_of_loading\": [ \n        \"side\" \n    ],\n    \"vehicle_size\": \"any_size\"\n  },\n  \"send_order_proposal_automatically\": true,\n  \"shipment_external_id\": \"1123dfd121\",\n  \"spots\": [\n    {\n      \"spot_order\": 1,\n      \"operations\": [\n        {\n          \"operation_order\": 1,\n          \"type\": \"loading\",\n          \"timespans\": {\n            \"begin\": \"2026-02-23T13:30:58+01:00\",\n            \"end\": \"2026-02-23T15:30:58+01:00\"\n          }\n        }\n      ],\n      \"place\": {\n        \"address\": {\n          \"country\": \"PL\",\n          \"postal_code\": \"54-128\",\n          \"locality\": \"Wroclaw\"\n        }\n      }\n    },\n    {\n      \"spot_order\": 2,\n      \"operations\": [\n        {\n          \"operation_order\": 1,\n          \"type\": \"unloading\",\n          \"timespans\": {\n            \"begin\": \"2026-02-26T15:30:58+01:00\",\n            \"end\": \"2026-02-26T17:30:58+01:00\"\n          }\n        }\n      ],\n      \"place\": {\n        \"address\": {\n          \"country\": \"DE\",\n          \"postal_code\": \"10178\",\n          \"locality\": \"Berlin\"\n        }\n      }\n    }\n  ],\n  \"volume\":12.6,\n  \"width\": 3.1\n}<\/code><\/pre><\/div>\n<\/div>\n<\/div>\n\n\n\n<h6 class=\"wp-block-heading\" id=\"responsefields\" style=\"font-style:normal;font-weight:700\">Response Fields<\/h6>\n\n\n\n<figure class=\"wp-block-table has-small-font-size\"><table><tbody><tr><td>Attribute<\/td><td>Type<\/td><td>Exam\u00adple<\/td><td>Descrip\u00adtion<\/td><\/tr><tr><td>accepted_price<\/td><td>Object<\/td><td>null<\/td><td>Final price for freight accept\u00aded dur\u00ading pub\u00adli\u00adca\u00adtion and nego\u00adti\u00ada\u00adtion process. The val\u00adue is always <code>null <\/code>in this request.<\/td><\/tr><tr><td>capac\u00adi\u00adty<\/td><td>Float<\/td><td>22.1<\/td><td>Total freight capac\u00adi\u00adty in tonnes.<\/td><\/tr><tr><td>car\u00adri\u00ader<\/td><td>Object<\/td><td>null<\/td><td>Car\u00adri\u00ader select\u00aded dur\u00ading nego\u00adti\u00ada\u00adtion process. The val\u00adue is always <code>null <\/code>in this request.<\/td><\/tr><tr><td>contact_employees<\/td><td>Array of Objects<\/td><td><\/td><td>List of employ\u00adees assigned to freight nego\u00adti\u00ada\u00adtion. Default is pub\u00adlish\u00ader.<\/td><\/tr><tr><td>contact_employees.last_name<\/td><td>String<\/td><td>Nowak<\/td><td>Sur\u00adname of assigned employ\u00adee<\/td><\/tr><tr><td>contact_employees.name<\/td><td>String<\/td><td>Jan<\/td><td>First name of assigned employ\u00adee<\/td><\/tr><tr><td>contact_employees.trans_id<\/td><td>String<\/td><td>13443\u20131<\/td><td>Tran\u00adsId of assigned employ\u00adee<\/td><\/tr><tr><td>dis\u00adtance<\/td><td>Int<\/td><td>34000<\/td><td>Dis\u00adtance in meters from the point of load\u00ading to the point of unload\u00ading.<\/td><\/tr><tr><td>end_reason<\/td><td>String<\/td><td>null<\/td><td>Pub\u00adli\u00adca\u00adtion end rea\u00adson. <br>For cor\u00adrect pub\u00adli\u00adca\u00adtion or freight cre\u00adation only <code>null <\/code>is returned. <\/td><\/tr><tr><td>height<\/td><td>Float<\/td><td>3.1<\/td><td>Vehi\u00adcle height (range: 0.01\u201310)<\/td><\/tr><tr><td>id<\/td><td>Int<\/td><td>234923<\/td><td>Freight iden\u00adti\u00adfi\u00adca\u00adtion num\u00adber, assigned auto\u00admat\u00adi\u00adcal\u00adly dur\u00ading cre\u00adation of a new freight.<\/td><\/tr><tr><td>is_first_buy<\/td><td>Boolean<\/td><td>False<\/td><td>Defines if price will be nego\u00adti\u00adat\u00aded or only accept\u00aded by car\u00adri\u00ader. <\/td><\/tr><tr><td>length<\/td><td>Float<\/td><td>12<\/td><td>Vehi\u00adcle length (range: 0.01\u2013100)<\/td><\/tr><tr><td>loading_meters<\/td><td>Float<\/td><td>23<\/td><td>Total freight load\u00ading meters (range: 0,01 \u2014 417)<\/td><\/tr><tr><td>loads (<a href=\"https:\/\/www.trans.eu\/api\/objects\/object-loads\/\" target=\"_blank\" rel=\"noopener\" title>see details<\/a>)<\/td><td>Array of Objects<\/td><td><\/td><td>Col\u00adlec\u00adtion of freight loads.<\/td><\/tr><tr><td>publication_price<\/td><td>Object<\/td><td><\/td><td>Pub\u00adli\u00adca\u00adtion price infor\u00adma\u00adtion<\/td><\/tr><tr><td>publication_price.currency<\/td><td>String<\/td><td>eur<\/td><td>Pub\u00adli\u00adca\u00adtion price cur\u00adren\u00adcy. See <a href=\"https:\/\/www.trans.eu\/api\/general-information\/allowed-values#currency\" target=\"_blank\" rel=\"noopener\" title>cur\u00adren\u00adcy dic\u00adtio\u00adnary<\/a>.<\/td><\/tr><tr><td>publication_price.value<\/td><td>Int<\/td><td>560<\/td><td>Pub\u00adli\u00adca\u00adtion price val\u00adue. The val\u00adue is n<code>ull <\/code>if was not spec\u00adi\u00adfied.<\/td><\/tr><tr><td>publication_status<\/td><td>String<\/td><td>null<\/td><td>Sta\u00adtus of the pub\u00adli\u00adca\u00adtion \u2014 always <code>null <\/code>in pub\u00adlish\u00ading request<\/td><\/tr><tr><td>reference_number<\/td><td>String<\/td><td>FR\/2025\/12\/30\/2NNQ<\/td><td>Freight ref\u00ader\u00adence num\u00adber \u2014 a unique, auto\u00admat\u00adi\u00adcal\u00adly assigned busi\u00adness iden\u00adti\u00adfi\u00ader of the freight<\/td><\/tr><tr><td>require\u00adments (<a href=\"https:\/\/www.trans.eu\/api\/objects\/object-requirements\/\" target=\"_blank\" rel=\"noopener\" title>see details<\/a>)<\/td><td>Object<\/td><td><\/td><td>Main freight require\u00adments<\/td><\/tr><tr><td>shipment_external_id<\/td><td>String<\/td><td>2023\/NWX\/1\/3<\/td><td>Exter\u00adnal iden\u00adti\u00adfi\u00adca\u00adtion num\u00adber<\/td><\/tr><tr><td>spots (<a href=\"https:\/\/www.trans.eu\/api\/objects\/object-spots\/\" target=\"_blank\" rel=\"noopener\" title>see details<\/a>)<\/td><td>Array of Objects<\/td><td><\/td><td>Col\u00adlec\u00adtion of freights\u2019 spots. At least one load\u00ading and one unload\u00ading will occur.<\/td><\/tr><tr><td>sta\u00adtus<\/td><td>String<\/td><td>new<\/td><td>Freight sta\u00adtus. The val\u00adue is always <code>new <\/code>in this request. See for <a href=\"https:\/\/www.trans.eu\/api\/use-case\/freight-creation#freightstatuses\" target=\"_blank\" rel=\"noopener\" title>oth\u00ader pos\u00adsi\u00adble sta\u00adtus\u00ades<\/a>.<\/td><\/tr><tr><td>sur\u00adchages<\/td><td>Object<\/td><td>null<\/td><td>Sur\u00adchages for fixed routes. The val\u00adue is always <code>null <\/code>in this request.<\/td><\/tr><tr><td>transit_time<\/td><td>Int<\/td><td>460<\/td><td>Time expressed in min\u00adutes (pos\u00adi\u00adtive inte\u00adger) for trans\u00adport, if spec\u00adi\u00adfied.<\/td><\/tr><tr><td>vol\u00adume<\/td><td>Float<\/td><td>21<\/td><td>Vehi\u00adcle vol\u00adume (range 0.01\u201310000).<\/td><\/tr><tr><td>width<\/td><td>Float<\/td><td>3.1<\/td><td>Vehi\u00adcle width (range 0.01\u201310).<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<div class=\"wp-block-columns is-layout-flex wp-container-core-columns-is-layout-9d6595d7 wp-block-columns-is-layout-flex\">\n<div class=\"wp-block-column is-vertically-aligned-center is-layout-flow wp-block-column-is-layout-flow\" style=\"flex-basis:25%\" id=\"responsebody\">\n<h6 class=\"wp-block-heading\" style=\"font-style:normal;font-weight:700\">Response Body<\/h6>\n<\/div>\n\n\n\n<div class=\"wp-block-column is-layout-flow wp-block-column-is-layout-flow\" style=\"flex-basis:75%\">\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    \"contact_employees\": [\n        {\n            \"last_name\": \"Nowak\",\n            \"name\": \"Jan\",\n            \"trans_id\": \"1007374-1\"\n        }\n    ],\n    \"distance\": 345000,\n    \"end_reason\": null,\n    \"height\": 4.3,\n    \"id\": 3829827,\n    \"is_first_buy\": false,\n    \"length\": 5.8,\n    \"loading_meters\": 10.1,\n    \"loads\": [],\n    \"publication_price\": {\n        \"currency\": \"eur\",\n        \"value\": 450\n    },\n    \"publication_status\": null,\n    \"reference_number\": \"FR\/2026\/02\/23\/2N55\",\n    \"requirements\": {\n        \"exemption_from_adr\": false,\n        \"is_ftl\": true,\n        \"monitoring\": \"required\",\n        \"other_requirements\": [],\n        \"required_adr_classes\": [],\n        \"required_door_types\": [],\n        \"required_tipper_trailer_additional_equipment\": [],\n        \"required_truck_bodies\": [\n            \"curtainsider\"\n        ],\n        \"required_ways_of_loading\": [\n            \"side\"\n        ],\n        \"shipping_remarks\": null,\n        \"temperature\": {\n            \"max\": null,\n            \"min\": null\n        },\n        \"transport\": {\n            \"count\": null,\n            \"schedule_type\": null,\n            \"settlement\": \"route\",\n            \"settlement_basis\": null,\n            \"total_weight\": null,\n            \"type\": \"ftl\"\n        },\n        \"vehicle_size\": \"any_size\"\n    },\n    \"shipment_external_id\": \"1123dfd121\",\n    \"spots\": [\n        {\n            \"description\": \"\",\n            \"name\": null,\n            \"operations\": [\n                {\n                    \"loads\": [],\n                    \"operation_order\": 1,\n                    \"operation_time\": null,\n                    \"timespans\": {\n                        \"begin\": \"2026-02-23T13:30:58+01:00\",\n                        \"begin_local\": \"2026-02-23T13:30:58+01:00\",\n                        \"end\": \"2026-02-23T15:30:58+01:00\",\n                        \"end_local\": \"2026-02-23T15:30:58+01:00\",\n                        \"timezone\": \"Europe\/Warsaw\"\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\": \"54-128\",\n                    \"street\": null\n                },\n                \"coordinates\": {\n                    \"latitude\": 51.142329074,\n                    \"longitude\": 16.937462521\n                }\n            },\n            \"spot_order\": 1\n        },\n        {\n            \"description\": \"\",\n            \"name\": null,\n            \"operations\": [\n                {\n                    \"loads\": [],\n                    \"operation_order\": 1,\n                    \"operation_time\": null,\n                    \"timespans\": {\n                        \"begin\": \"2026-02-26T15:30:58+01:00\",\n                        \"begin_local\": \"2026-02-26T15:30:58+01:00\",\n                        \"end\": \"2026-02-26T17:30:58+01:00\",\n                        \"end_local\": \"2026-02-26T17:30:58+01:00\",\n                        \"timezone\": \"Europe\/Berlin\"\n                    },\n                    \"type\": \"unloading\"\n                }\n            ],\n            \"place\": {\n                \"address\": {\n                    \"country\": \"de\",\n                    \"description\": null,\n                    \"locality\": \"Berlin\",\n                    \"number\": null,\n                    \"postal_code\": \"10178\",\n                    \"street\": null\n                },\n                \"coordinates\": {\n                    \"latitude\": 52.519971677,\n                    \"longitude\": 13.404467562\n                }\n            },\n            \"spot_order\": 2\n        }\n    ],\n    \"status\": \"new\",\n    \"surcharges\": [],\n    \"transit_time\": null,\n    \"volume\": 12.6,\n    \"width\": 3.1\n}<\/code><\/pre><\/div>\n<\/div>\n<\/div>\n\n\n\n<div style=\"height:50px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<h4 class=\"wp-block-heading\" id=\"validationerrors\" style=\"font-style:normal;font-weight:700\">Client errors (code 400)<\/h4>\n\n\n\n<p>HTTP 4xx sta\u00adtus codes indi\u00adcate client errors, mean\u00ading that the request could not be processed due to an issue on the client side. Below is a list of request-spe\u00adcif\u00adic errors.<\/p>\n\n\n\n<div class=\"wp-block-columns is-layout-flex wp-container-core-columns-is-layout-9d6595d7 wp-block-columns-is-layout-flex\">\n<div class=\"wp-block-column is-vertically-aligned-center is-layout-flow wp-block-column-is-layout-flow\" style=\"flex-basis:25%\" id=\"responsebody\">\n<h6 class=\"wp-block-heading\" style=\"font-style:normal;font-weight:700\">Example error 1<\/h6>\n\n\n\n<p>No manda\u00adto\u00adry val\u00adue in capac\u00adi\u00adty field<\/p>\n<\/div>\n\n\n\n<div class=\"wp-block-column is-layout-flow wp-block-column-is-layout-flow\" style=\"flex-basis:75%\">\n<div class=\"hcb_wrap\"><pre class=\"prism line-numbers lang-json\" data-lang=\"JSON\"><code>{\n    \"detail\": \"Failed Validation\",\n    \"status\": 422,\n    \"title\": \"Unprocessable Entity\",\n    \"type\": \"http:\/\/www.w3.org\/Protocols\/rfc2616\/rfc2616-sec10.html\",\n    \"validation_messages\": {\n        \"capacity\": {\n            \"value\": {\n                \"isEmpty\": \"Value is required and can't be empty\"\n            }\n        }\n    }\n}<\/code><\/pre><\/div>\n<\/div>\n<\/div>\n\n\n\n<div class=\"wp-block-columns is-layout-flex wp-container-core-columns-is-layout-9d6595d7 wp-block-columns-is-layout-flex\">\n<div class=\"wp-block-column is-vertically-aligned-center is-layout-flow wp-block-column-is-layout-flow\" style=\"flex-basis:25%\" id=\"responsebody\">\n<h6 class=\"wp-block-heading\" style=\"font-style:normal;font-weight:700\">Example error 2<\/h6>\n\n\n\n<p>Incor\u00adrect date in spot oper\u00ada\u00adtion<\/p>\n<\/div>\n\n\n\n<div class=\"wp-block-column is-layout-flow wp-block-column-is-layout-flow\" style=\"flex-basis:75%\">\n<div class=\"hcb_wrap\"><pre class=\"prism line-numbers lang-json\" data-lang=\"JSON\"><code>\"validation_messages\": {\n        \"spot_operation\": {\n            \"validation_error\": \"In one of spot.operation begin or end date is lower or equal today (UTC)\"\n        }\n    }<\/code><\/pre><\/div>\n<\/div>\n<\/div>\n\n\n\n<div class=\"wp-block-columns is-layout-flex wp-container-core-columns-is-layout-9d6595d7 wp-block-columns-is-layout-flex\">\n<div class=\"wp-block-column is-vertically-aligned-center is-layout-flow wp-block-column-is-layout-flow\" style=\"flex-basis:25%\" id=\"responsebody\">\n<h6 class=\"wp-block-heading\" style=\"font-style:normal;font-weight:700\">Example error 3<\/h6>\n\n\n\n<p>Vehi\u00adcle type not allowed for vehi\u00adcle size<\/p>\n<\/div>\n\n\n\n<div class=\"wp-block-column is-layout-flow wp-block-column-is-layout-flow\" style=\"flex-basis:75%\">\n<div class=\"hcb_wrap\"><pre class=\"prism line-numbers lang-json\" data-lang=\"JSON\"><code>\"validation_messages\": {\n            \"vehicle_size_id\": {\n                \"invalid\": \"['7_silos'] is not valid for vehicle size: '1_bus'\"\n            }\n        }\n    }<\/code><\/pre><\/div>\n<\/div>\n<\/div>\n\n\n\n<div class=\"wp-block-columns is-layout-flex wp-container-core-columns-is-layout-9d6595d7 wp-block-columns-is-layout-flex\">\n<div class=\"wp-block-column is-vertically-aligned-center is-layout-flow wp-block-column-is-layout-flow\" style=\"flex-basis:25%\" id=\"responsebody\">\n<h6 class=\"wp-block-heading\" style=\"font-style:normal;font-weight:700\">Example error 4<\/h6>\n\n\n\n<p>Incor\u00adrect exchange id<\/p>\n<\/div>\n\n\n\n<div class=\"wp-block-column is-layout-flow wp-block-column-is-layout-flow\" style=\"flex-basis:75%\">\n<div class=\"hcb_wrap\"><pre class=\"prism line-numbers lang-json\" data-lang=\"JSON\"><code>{\n    \"message\": {\n        \"detail\": \"Given private exchanges does not exists (ids: 39b9aa2b-1987-48d9-9a77-147f97594233)\",\n        \"status\": 403,\n        \"title\": \"Forbidden\",\n        \"type\": \"http:\/\/www.w3.org\/Protocols\/rfc2616\/rfc2616-sec10.html\"\n    }\n}<\/code><\/pre><\/div>\n<\/div>\n<\/div>\n\n\n\n<div class=\"wp-block-columns is-layout-flex wp-container-core-columns-is-layout-9d6595d7 wp-block-columns-is-layout-flex\">\n<div class=\"wp-block-column is-vertically-aligned-center is-layout-flow wp-block-column-is-layout-flow\" style=\"flex-basis:25%\" id=\"responsebody\">\n<h6 class=\"wp-block-heading\" style=\"font-style:normal;font-weight:700\">Example error 5<\/h6>\n\n\n\n<p>No exchange id<\/p>\n<\/div>\n\n\n\n<div class=\"wp-block-column is-layout-flow wp-block-column-is-layout-flow\" style=\"flex-basis:75%\">\n<div class=\"hcb_wrap\"><pre class=\"prism line-numbers lang-json\" data-lang=\"JSON\"><code>{\n    \"message\": {\n        \"detail\": \"Failed Validation\",\n        \"status\": 422,\n        \"title\": \"Unprocessable Entity\",\n        \"type\": \"http:\/\/www.w3.org\/Protocols\/rfc2616\/rfc2616-sec10.html\",\n        \"validation_messages\": {\n            \"receivers\": {\n                \"exchanges\": [\n                    {\n                        \"valueNotString\": \"Invalid type given; string expected\"\n                    }\n                ]\n            }\n        }\n    }\n}<\/code><\/pre><\/div>\n<\/div>\n<\/div>\n","protected":false},"excerpt":{"rendered":"<p class=\"dont-break-out\">Cre\u00adat\u00ading a new freight and pub\u00adlish\u00ading it to the pri\u00advate exchange defined for your com\u00adpa\u00adny.Your com\u00adpa\u00adny\u2019s pri\u00advate exchange is vis\u00adi\u00adble \u2026<\/p>\n","protected":false},"author":16,"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":[141,145],"tags":[],"class_list":["post-5942","post","type-post","status-publish","format-standard","hentry","category-freights-section","category-publication-n"],"acf":[],"aioseo_notices":[],"lang":"en","translations":{"en":5942},"pll_sync_post":[],"_links":{"self":[{"href":"https:\/\/www.trans.eu\/api\/wp-json\/wp\/v2\/posts\/5942","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\/16"}],"replies":[{"embeddable":true,"href":"https:\/\/www.trans.eu\/api\/wp-json\/wp\/v2\/comments?post=5942"}],"version-history":[{"count":10,"href":"https:\/\/www.trans.eu\/api\/wp-json\/wp\/v2\/posts\/5942\/revisions"}],"predecessor-version":[{"id":6496,"href":"https:\/\/www.trans.eu\/api\/wp-json\/wp\/v2\/posts\/5942\/revisions\/6496"}],"wp:attachment":[{"href":"https:\/\/www.trans.eu\/api\/wp-json\/wp\/v2\/media?parent=5942"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.trans.eu\/api\/wp-json\/wp\/v2\/categories?post=5942"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.trans.eu\/api\/wp-json\/wp\/v2\/tags?post=5942"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}