{"id":6013,"date":"2026-02-23T15:42:43","date_gmt":"2026-02-23T14:42:43","guid":{"rendered":"https:\/\/www.trans.eu\/api\/?p=6013"},"modified":"2026-04-15T14:52:31","modified_gmt":"2026-04-15T12:52:31","slug":"update-freight","status":"publish","type":"post","link":"https:\/\/www.trans.eu\/api\/freights-section\/update-freight\/","title":{"rendered":"Update freight"},"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>Updat\u00ading exist\u00ading freight. <br>Updates are pos\u00adsi\u00adble only to freights that have not yet been pub\u00adlished. Dur\u00ading the update, you can pub\u00adlish freight at the same time.<br>With\u00adout pub\u00adli\u00adca\u00adtion, only the freight fields describ\u00ading the load and vehi\u00adcle para\u00adme\u00adters can be updat\u00aded, the fields relat\u00ading to pub\u00adli\u00adca\u00adtion para\u00adme\u00adters can\u00adnot be updat\u00aded. <br>Updat\u00ading exist\u00ading freights&nbsp;over\u00adwrites&nbsp;com\u00adplete\u00adly freight. If any val\u00adue is not set and allowed as null, it will be con\u00adsid\u00adered as null val\u00adue and over\u00adwrit\u00adten.<br>Freight can be updat\u00aded (also with the option of pub\u00adlish\u00ading) with a request oth\u00ader than the one it was cre\u00adat\u00aded with.<br>If a freight has been added using automa\u00adtion rules (with\u00adout pub\u00adlish), you can\u00adnot pub\u00adlish that freight by updat\u00ading it.<\/p>\n\n\n\n<!--more-->\n\n\n\n<p><br>The <code>freight-id<\/code> iden\u00adti\u00adfi\u00adca\u00adtion num\u00adber in method call can be tak\u00aden from response after pre\u00advi\u00adous\u00adly cre\u00adat\u00ading the freight or by down\u00adload\u00ading the freight list.<\/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>PUT<\/strong><br>\/ext\/freights-api\/v1\/freights\/{freight-id}<br><strong>PUT<\/strong><br>\/ext\/freights-api\/v1\/freight-exchange\/{freight-id}<br><strong>PUT<\/strong><br>\/ext\/freights-api\/v1\/private-exchange\/{freight-id}<br><strong>PUT<\/strong><br>\/ext\/freights-api\/v1\/freight-corporate\/{freight-id}<br><strong>PUT<\/strong><br>\/ext\/freights-api\/v1\/freight-companies\/{freight-id}<br><strong>PUT<\/strong><br>\/ext\/freights-api\/v1\/freight-employees\/{freight-id}<br><strong>PUT<\/strong><br>\/ext\/freights-api\/v1\/freight-auto\/{freight-id}<\/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 (example)<\/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-plain\"><code>PUT \/ext\/freights-api\/v1\/freight-exchange\/{freight-id} 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>car\u00adri\u00aders<\/td><td>Array of Object<\/td><td>Descrip\u00adtion of the object in <a href=\"https:\/\/www.trans.eu\/api\/freights-section\/publish-to-selected-partners\/\" target=\"_blank\" rel=\"noopener\" title>Pub\u00adlish to select\u00aded part\u00adners<\/a><\/td><td>No<\/td><td>A list of carrier\u2019s com\u00adpa\u00adny iden\u00adti\u00adfiers (at least one of com\u00adpa\u00adny id\u2019s must be valid).<br>Updat\u00ading this field is only pos\u00adsi\u00adble with the <code>publish=true<\/code> option and <code>\/ext\/freights-api\/v1\/freight-companies\/{freight-id}<\/code> request.<\/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.<br>Updat\u00ading this field is only pos\u00adsi\u00adble with the <code>publish=true<\/code> option.<\/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.<br>Updat\u00ading this field is only pos\u00adsi\u00adble with the <code>publish=true<\/code> option.<\/td><\/tr><tr><td>employ\u00adees<\/td><td>Array of String<\/td><td>[\u201c13452\u20131\u201d,\u201c28443\u20132\u201d]<\/td><td>No<\/td><td>List of users to whom the pub\u00adli\u00adca\u00adtion is addressed. The pub\u00adli\u00adca\u00adtion will only be effec\u00adtive for users on the pub\u00adlish\u00ader\u2019s Mes\u00adsen\u00adger con\u00adtact list.<br>Updat\u00ading this field is only pos\u00adsi\u00adble with the <code>publish=true<\/code> option and <code>\/ext\/freights-api\/v1\/freight-employees\/{freight-id}<\/code> request.<\/td><\/tr><tr><td>exchanges<\/td><td>Object<\/td><td>Descrip\u00adtion of the object in<a href=\"https:\/\/www.trans.eu\/api\/freights-section\/publish-to-private-exchange\/\" target=\"_blank\" rel=\"noopener\" title> Pub\u00adlish to pri\u00advate exchanges<\/a> or <a href=\"https:\/\/www.trans.eu\/api\/freights-section\/publish-to-branded-private-exchange\/\" target=\"_blank\" rel=\"noopener\" title>Pub\u00adlish to brand\u00aded pri\u00advate exchanges<\/a><\/td><td>No<\/td><td>Con\u00adtain\u00ader with pri\u00advate exchange ids.<br>Updat\u00ading this field is only pos\u00adsi\u00adble with the <code>publish=true<\/code> option and <code>\/ext\/freights-api\/v1\/freight-corporate\/{freight-id}<\/code> or <code>\/ext\/freights-api\/v1\/private-exchange\/{freight-id}<\/code> 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.<br>Updat\u00ading this field is only pos\u00adsi\u00adble with the <code>publish=true<\/code> option (but not with <code>\/ext\/freights-api\/v1\/freight-exchange\/{freight-id}<\/code> request).<\/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. 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>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.<br>Updat\u00ading this field is only pos\u00adsi\u00adble with the <code>publish=true<\/code> option<\/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 updat\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.<br>Updat\u00ading this field is only pos\u00adsi\u00adble with the <code>publish=true<\/code> option.<\/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.<br>Updat\u00ading this field is only pos\u00adsi\u00adble with the <code>publish=true<\/code> option.<\/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\" id=\"requestbody\">\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\">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>\/\/ Example request for PUT \/ext\/freights-api\/v1\/freight-exchange\/3830568\n{\n  \"callback_url\": \"http:\/\/example.com\/msg\",  \n  \"capacity\": 12,\n  \"loads\": [ {\n      \"type_of_load\": \"europalette\",\n      \"name\": \"Load nr 1\",\n      \"load_id\": \"1123dfd121_1\",\n      \"amount\":2,\n      \"is_exchangeable\": true\n  }],\n  \"payment\": {\n    \"price\": {\n        \"value\": 552,\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      \"box\"\n    ],\n    \"required_ways_of_loading\": [ \n        \"side\" \n    ],\n    \"vehicle_size\": \"solo\"\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-23T16:30:58+01:00\",\n            \"end\": \"2026-02-23T17: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-26T17:30:58+01:00\",\n            \"end\": \"2026-02-26T18:30:58+01:00\"\n          }\n        }\n      ],\n      \"place\": {\n        \"address\": {\n          \"country\": \"IT\",\n          \"postal_code\": \"20097\",\n          \"locality\": \"Milan\"\n        }\n      }\n    }\n  ]\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 can 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\/?p=5293&amp;preview=true\" 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_receivers<\/td><td>Array of String<\/td><td>[\u201c13452\u20131\u201d,\u201c28443\u20132\u201d]<\/td><td>List of users to whom the pub\u00adli\u00adca\u00adtion is addressed.<br>Field appears only for update with the <code>publish=true<\/code> option and <code>\/ext\/freights-api\/v1\/freight-employees\/{freight-id}<\/code> request.<\/td><\/tr><tr><td>publication_status<\/td><td>String<\/td><td>new<\/td><td>Sta\u00adtus of the pub\u00adli\u00adca\u00adtion. The val\u00adue is always <code>null <\/code>in this 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&nbsp;<code>new&nbsp;<\/code>in this request. See for&nbsp;<a href=\"https:\/\/www.trans.eu\/api\/use-case\/freight-creation#freightstatuses\" target=\"_blank\" rel=\"noreferrer noopener\">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. 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>\/\/ Example response for for PUT \/ext\/freights-api\/v1\/freight-exchange\/3830568\n{\n    \"accepted_price\": null,\n    \"capacity\": 12,\n    \"carrier\": null,\n    \"contact_employees\": [\n        {\n            \"last_name\": \"Demczyszak\",\n            \"name\": \"Barbara\",\n            \"trans_id\": \"1007374-1\"\n        }\n    ],\n    \"distance\": 1185000,\n    \"end_reason\": null,\n    \"height\": null,\n    \"id\": 3830568,\n    \"is_first_buy\": false,\n    \"length\": null,\n    \"loading_meters\": null,\n    \"loads\": [\n        {\n            \"amount\": 2,\n            \"description\": null,\n            \"height\": null,\n            \"id\": 3766404,\n            \"is_exchangeable\": true,\n            \"is_stackable\": false,\n            \"length\": null,\n            \"load_id\": \"3766404\",\n            \"name\": \"Load nr 1\",\n            \"type_of_load\": \"europalette\",\n            \"volume\": null,\n            \"weight\": null,\n            \"width\": null\n        }\n    ],\n    \"publication_price\": {\n        \"currency\": \"eur\",\n        \"value\": 552\n    },\n    \"publication_status\": null,\n    \"reference_number\": \"FR\/2026\/02\/23\/221K\",\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            \"box\"\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\": \"solo\"\n    },\n    \"shipment_external_id\": \"1123dfd121\",\n    \"spots\": [\n        {\n            \"description\": \"\",\n            \"name\": null,\n            \"operations\": [\n                {\n                    \"loads\": [\n                        {\n                            \"load_id\": \"3766404\",\n                            \"weight\": null\n                        }\n                    ],\n                    \"operation_order\": 1,\n                    \"operation_time\": null,\n                    \"timespans\": {\n                        \"begin\": \"2026-02-23T16:30:58+01:00\",\n                        \"begin_local\": \"2026-02-23T16:30:58+01:00\",\n                        \"end\": \"2026-02-23T17:30:58+01:00\",\n                        \"end_local\": \"2026-02-23T17: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                        {\n                            \"load_id\": \"3766404\",\n                            \"weight\": null\n                        }\n                    ],\n                    \"operation_order\": 1,\n                    \"operation_time\": null,\n                    \"timespans\": {\n                        \"begin\": \"2026-02-26T17:30:58+01:00\",\n                        \"begin_local\": \"2026-02-26T17:30:58+01:00\",\n                        \"end\": \"2026-02-26T18:30:58+01:00\",\n                        \"end_local\": \"2026-02-26T18:30:58+01:00\",\n                        \"timezone\": \"Europe\/San_Marino\"\n                    },\n                    \"type\": \"unloading\"\n                }\n            ],\n            \"place\": {\n                \"address\": {\n                    \"country\": \"it\",\n                    \"description\": null,\n                    \"locality\": \"Milan\",\n                    \"number\": null,\n                    \"postal_code\": \"20097\",\n                    \"street\": null\n                },\n                \"coordinates\": {\n                    \"latitude\": 45.397205283,\n                    \"longitude\": 9.21659417\n                }\n            },\n            \"spot_order\": 2\n        }\n    ],\n    \"status\": \"new\",\n    \"surcharges\": [],\n    \"transit_time\": null,\n    \"volume\": null,\n    \"width\": null\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 freight sta\u00adtus<\/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\": \"You cant update freight (id: 3823550) with status: 'in_progress'\",\n    \"status\": 403,\n    \"title\": \"Forbidden\",\n    \"type\": \"http:\/\/www.w3.org\/Protocols\/rfc2616\/rfc2616-sec10.html\"\n}<\/code><\/pre><\/div>\n<\/div>\n<\/div>\n\n\n\n<p><\/p>\n","protected":false},"excerpt":{"rendered":"<p class=\"dont-break-out\">Updat\u00ading exist\u00ading freight. Updates are pos\u00adsi\u00adble only to freights that have not yet been pub\u00adlished. Dur\u00ading the update, you can \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":[143,141],"tags":[],"class_list":["post-6013","post","type-post","status-publish","format-standard","hentry","category-freight-n","category-freights-section"],"acf":[],"aioseo_notices":[],"lang":"en","translations":{"en":6013},"pll_sync_post":[],"_links":{"self":[{"href":"https:\/\/www.trans.eu\/api\/wp-json\/wp\/v2\/posts\/6013","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=6013"}],"version-history":[{"count":10,"href":"https:\/\/www.trans.eu\/api\/wp-json\/wp\/v2\/posts\/6013\/revisions"}],"predecessor-version":[{"id":6494,"href":"https:\/\/www.trans.eu\/api\/wp-json\/wp\/v2\/posts\/6013\/revisions\/6494"}],"wp:attachment":[{"href":"https:\/\/www.trans.eu\/api\/wp-json\/wp\/v2\/media?parent=6013"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.trans.eu\/api\/wp-json\/wp\/v2\/categories?post=6013"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.trans.eu\/api\/wp-json\/wp\/v2\/tags?post=6013"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}