{"id":5790,"date":"2026-02-19T15:31:10","date_gmt":"2026-02-19T14:31:10","guid":{"rendered":"https:\/\/www.trans.eu\/api\/?p=5790"},"modified":"2026-02-26T09:54:15","modified_gmt":"2026-02-26T08:54:15","slug":"freight-creation","status":"publish","type":"post","link":"https:\/\/www.trans.eu\/api\/freights-section\/freight-creation\/","title":{"rendered":"Freight creation"},"content":{"rendered":"\n<p>On the Trans.eu Plat\u00adform, a <strong>freight<\/strong> is used to define and offer a ship\u00adment \/ trans\u00adport job that is to be car\u00adried out by a car\u00adri\u00ader. The freight can then be pub\u00adlished (e.g. on the freight exchange or to select\u00aded car\u00adri\u00aders) to find a con\u00adtrac\u00adtor for the trans\u00adport.<br>In prac\u00adtice, a freight includes key infor\u00adma\u00adtion need\u00aded to com\u00adplete the trans\u00adport, such as:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>the route (load\u00ading and unload\u00ading loca\u00adtions),<\/li>\n\n\n\n<li>dates (load\u00ading and unload\u00ading oper\u00ada\u00adtions),<\/li>\n\n\n\n<li>car\u00adgo require\u00adments and para\u00adme\u00adters,<\/li>\n\n\n\n<li>set\u00adtle\u00adment terms and price.<\/li>\n\n\n\n<li>con\u00adtact employ\u00adees<\/li>\n<\/ul>\n\n\n\n<p>To cre\u00adate a freight, you can use one of sev\u00ader\u00adal API requests, which can also be used simul\u00adta\u00adne\u00adous\u00adly to pub\u00adlish the freight. If you cre\u00adate a freight with\u00adout pub\u00adlish\u00ading it (new sta\u00adtus), it will not be vis\u00adi\u00adble to oth\u00ader users, even with\u00adin your own com\u00adpa\u00adny. A freight cre\u00adat\u00aded this way can be updat\u00aded by API method but it can be pub\u00adlished only from the Trans.eu Plat\u00adform.<br>The rules of <mark style=\"background-color:rgba(0, 0, 0, 0)\" class=\"has-inline-color has-black-color\">of pub\u00adlish\u00ading via the API<\/mark> are described in <a href=\"https:\/\/www.trans.eu\/api\/freights-section\/freight-publication\/\" target=\"_blank\" rel=\"noopener\" title>Freight pub\u00adli\u00adca\u00adtion<\/a>.<\/p>\n\n\n\n<h5 class=\"wp-block-heading\" style=\"font-style:normal;font-weight:700\">Components of a single freight<\/h5>\n\n\n\n<ol class=\"wp-block-list\">\n<li style=\"font-size:14px\">Route \u2013 a list of con\u00adsec\u00adu\u00adtive loca\u00adtions that the vehi\u00adcle must reach with the car\u00adgo or to pick up car\u00adgo, togeth\u00ader with the oper\u00ada\u00adtion to be per\u00adformed at each route point.\n<ul class=\"wp-block-list\">\n<li>Data from this sec\u00adtion is rep\u00adre\u00adsent\u00aded by the <strong><code>spots<\/code><\/strong> object in the request\/response para\u00adme\u00adters.<\/li>\n\n\n\n<li>At the first route point, the manda\u00adto\u00adry oper\u00ada\u00adtion is <code>loading<\/code>.<\/li>\n\n\n\n<li>At the last route point, the manda\u00adto\u00adry oper\u00ada\u00adtion is <code>unloading<\/code>.<\/li>\n\n\n\n<li>In mul\u00adti-stop routes, more than two route points may occur.<\/li>\n\n\n\n<li>More than one oper\u00ada\u00adtion can be per\u00adformed at a sin\u00adgle route point.<\/li>\n\n\n\n<li>With\u00adin an oper\u00ada\u00adtion, it is pos\u00adsi\u00adble to spec\u00adi\u00adfy the quan\u00adti\u00adty of spe\u00adcif\u00adic loads intend\u00aded for load\u00ading or unload\u00ading \u2014 it is nec\u00ades\u00adsary to main\u00adtain a weight bal\u00adance of the car\u00adgo dur\u00ading load\u00ading and unload\u00ading oper\u00ada\u00adtions so that it is con\u00adsis\u00adtent with the val\u00adues pro\u00advid\u00aded in the <strong>Load details<\/strong> sec\u00adtion.<\/li>\n\n\n\n<li>The chronol\u00ado\u00adgy of the times pro\u00advid\u00aded for indi\u00advid\u00adual oper\u00ada\u00adtions must be increas\u00ading as the route is com\u00adplet\u00aded.<br>    &nbsp;&nbsp;&nbsp; <\/li>\n<\/ul>\n<\/li>\n\n\n\n<li style=\"font-size:14px\">Vehi\u00adcle require\u00adments \u2013 a set of para\u00adme\u00adters describ\u00ading the require\u00adments for the vehi\u00adcle ded\u00adi\u00adcat\u00aded to trans\u00adport\u00ading the car\u00adgo.\n<ul class=\"wp-block-list\">\n<li>Data from this sec\u00adtion is rep\u00adre\u00adsent\u00aded by the <strong><code>requirements<\/code><\/strong> object and a list of indi\u00advid\u00adual attrib\u00adut\u00ades in the request\/response para\u00adme\u00adters.<\/li>\n\n\n\n<li>On the Plat\u00adform, in the <strong>Cre\u00adate freight<\/strong> win\u00addow, the rel\u00ade\u00advant data is entered in the <strong>Vehi\u00adcle require\u00adments<\/strong>, <strong>Trans\u00adport details<\/strong>, and <strong>Vehi\u00adcle details<\/strong> sec\u00adtions.<\/li>\n\n\n\n<li>Some para\u00adme\u00adters in this sec\u00adtion are manda\u00adto\u00adry, while oth\u00aders are option\u00adal, as described for each attribute.<br>&nbsp;&nbsp;<\/li>\n<\/ul>\n<\/li>\n\n\n\n<li style=\"font-size:14px\">Load details \u2013 a detailed descrip\u00adtion of the loads that may be includ\u00aded in the trans\u00adport cov\u00adered by the freight.\n<ul class=\"wp-block-list\">\n<li>Data from this sec\u00adtion is rep\u00adre\u00adsent\u00aded by the <strong><code>loads<\/code><\/strong> object in the request\/response para\u00adme\u00adters.<\/li>\n\n\n\n<li>On the Plat\u00adform, in the <strong>Cre\u00adate freight<\/strong> win\u00addow, the rel\u00ade\u00advant data is entered in the <strong>Load details<\/strong> sec\u00adtion.<\/li>\n\n\n\n<li>The total weight of the spec\u00adi\u00adfied loads must not exceed the val\u00adue spec\u00adi\u00adfied in <strong>Capac\u00adi\u00adty<\/strong>.<\/li>\n\n\n\n<li>The entire Load details sec\u00adtion is option\u00adal \u2014 the min\u00adi\u00admum require\u00adment to describe the size of the freight is the <strong>Capac\u00adi\u00adty<\/strong> field in main para\u00adme\u00adters of request.<br>&nbsp;&nbsp;&nbsp;<\/li>\n<\/ul>\n<\/li>\n\n\n\n<li style=\"font-size:14px\">Pay\u00adment con\u00addi\u00adtions \u2013 attrib\u00adut\u00ades describ\u00ading the pay\u00adment terms pro\u00adposed by the pub\u00adlish\u00ading par\u00adty for the trans\u00adport of the car\u00adgo, includ\u00ading the trans\u00adport price.\n<ul class=\"wp-block-list\">\n<li>Data from this sec\u00adtion is rep\u00adre\u00adsent\u00aded by the <strong><code>payment<\/code><\/strong> object in the request\/response para\u00adme\u00adters.<\/li>\n\n\n\n<li>On the Plat\u00adform, in the <strong>Cre\u00adate freight<\/strong> win\u00addow, the rel\u00ade\u00advant data is entered in the sec\u00adtion on the right-hand side of the win\u00addow.<br>&nbsp;&nbsp;&nbsp;<\/li>\n<\/ul>\n<\/li>\n\n\n\n<li style=\"font-size:14px\">Oth\u00ader freight para\u00adme\u00adters \u2013 includ\u00ading con\u00adtact per\u00adsons, pub\u00adli\u00adca\u00adtion para\u00adme\u00adters, and links to the customer\u2019s exter\u00adnal sys\u00adtem.\n<ul class=\"wp-block-list\">\n<li>Data from this sec\u00adtion is rep\u00adre\u00adsent\u00aded by a list of indi\u00advid\u00adual attrib\u00adut\u00ades in the request\/response para\u00adme\u00adters.<\/li>\n\n\n\n<li>On the Plat\u00adform, in the <strong>Cre\u00adate freight<\/strong> win\u00addow, the rel\u00ade\u00advant data is entered in the sec\u00adtion on the right-hand side of the win\u00addow.<\/li>\n<\/ul>\n<\/li>\n<\/ol>\n\n\n\n<p>A detailed list of freight attrib\u00adut\u00ades is described in the spec\u00adi\u00adfi\u00adca\u00adtion of each func\u00adtion used to cre\u00adate and down\u00adload freights.<\/p>\n\n\n\n<div style=\"height:12px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<h5 class=\"wp-block-heading\" style=\"font-style:normal;font-weight:700\">Multifreights<\/h5>\n\n\n\n<p>Mul\u00adti\u00adfreight allows pub\u00adlish\u00ading a freight offer that includes mul\u00adti\u00adple trans\u00adport oper\u00ada\u00adtions, with set\u00adtle\u00adment per route or per ton of car\u00adgo. To define mul\u00adti\u00adfreight, enter the <code>multi_ftl<\/code> val\u00adue \u200b\u200bin the <strong>requirements.transport.transport.type<\/strong> field and com\u00adplete the remain\u00ading fields in the sec\u00adtion <strong>requirements.transport<\/strong> accord\u00ading\u00adly.<\/p>\n\n\n\n<h5 class=\"wp-block-heading\" style=\"font-style:normal;font-weight:700\">Internal notes<\/h5>\n\n\n\n<p>An inter\u00adnal note can be added to a freight and is only vis\u00adi\u00adble to users from your com\u00adpa\u00adny and is not vis\u00adi\u00adble to car\u00adri\u00aders nego\u00adti\u00adat\u00ading the offer. Only one note can be added to the freight. The note can\u00adnot be longer than 500 char\u00adac\u00adters.<\/p>\n\n\n\n<div style=\"height:12px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<h5 class=\"wp-block-heading\" style=\"font-style:normal;font-weight:700\">Archiving<\/h5>\n\n\n\n<p>Freights for which the planned exe\u00adcu\u00adtion time has passed are moved to the archive so that they do not occu\u00adpy space on the list of cur\u00adrent\u00adly processed freights. <br>The Plat\u00adform runs an auto\u00admat\u00adic freight archiv\u00ading process which, at the end of the day, archives freights whose <strong>load\u00ading date <\/strong>has passed and for which:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li class=\"has-black-color has-text-color has-link-color wp-elements-910afa2eca1cc8622d5bd7f80bada030\">the pub\u00adli\u00adca\u00adtion peri\u00adod ends with\u00adout any offers being sub\u00admit\u00adted for the freight, or<\/li>\n\n\n\n<li>the pub\u00adli\u00adca\u00adtion peri\u00adod ends and at least one offer was sub\u00admit\u00adted by a car\u00adri\u00ader, but the per\u00adson pub\u00adlish\u00ading the freight did not select any offer<\/li>\n<\/ul>\n\n\n\n<p>Freights can also be moved to the archive man\u00adu\u00adal\u00adly, ear\u00adli\u00ader than the auto\u00admat\u00adic process. The freight sta\u00adtus that allows archiv\u00ading: unsuccessful_publication, in_progress.<\/p>\n\n\n\n<p>Ded\u00adi\u00adcat\u00aded API func\u00adtions are avail\u00adable for archiv\u00ading and man\u00adag\u00ading archived freights. The fol\u00adlow\u00ading oper\u00ada\u00adtions are sup\u00adport\u00aded:<br>&nbsp;&nbsp;&nbsp;\u2014 man\u00adu\u00adal archiv\u00ading of a sin\u00adgle freight<br>&nbsp;&nbsp;&nbsp;\u2014 bulk archiv\u00ading of mul\u00adti\u00adple freights<br>&nbsp;&nbsp;&nbsp;\u2014 search\u00ading the list of archived freights<\/p>\n\n\n\n<div style=\"height:27px\" 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=\"freightstatuses\">\n<div class=\"wp-block-column is-vertically-aligned-top is-layout-flow wp-block-column-is-layout-flow\" style=\"flex-basis:25%\">\n<h5 class=\"wp-block-heading\" style=\"font-style:normal;font-weight:700\">Freight statuses<\/h5>\n\n\n\n<p>Val\u00adues \u200b\u200breturned in the sta\u00adtus field in GET method<\/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<figure class=\"wp-block-table is-style-stripes has-small-font-size\"><table class=\"has-black-color has-text-color has-link-color\"><tbody><tr><td>Freight sta\u00adtus<\/td><td>Descrip\u00adtion<\/td><\/tr><tr><td>accept\u00aded<\/td><td>The freight has been accept\u00aded and the car\u00adri\u00ader has been select\u00aded<\/td><\/tr><tr><td>closed<\/td><td>An unac\u00adcept\u00aded freight that is in the archive<\/td><\/tr><tr><td>in_progress<\/td><td>When the freight is being pub\u00adlished, is under nego\u00adti\u00ada\u00adtion or is in the process of select\u00ading offers<\/td><\/tr><tr><td>new<\/td><td>New\u00adly cre\u00adat\u00aded freight<\/td><\/tr><tr><td>unsuccessful_publication<\/td><td>Freight pub\u00adli\u00adca\u00adtion end\u00aded, re-pub\u00adli\u00adca\u00adtion pos\u00adsi\u00adble<\/td><\/tr><tr><td>waiting_for_publication<\/td><td>Freight sched\u00aduled to pub\u00adli\u00adca\u00adtion <\/td><\/tr><\/tbody><\/table><\/figure>\n<\/div>\n<\/div>\n\n\n\n<div style=\"height:12px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<h5 class=\"wp-block-heading\" id=\"requeststructure\" style=\"font-style:normal;font-weight:700\">Dedicated Requests<\/h5>\n\n\n\n<figure class=\"wp-block-table\"><table><tbody><tr><td>Link to details<\/td><td>Descrip\u00adtion<\/td><td>Request<\/td><\/tr><tr><td><a href=\"https:\/\/www.trans.eu\/api\/freights-section\/create-freight\/\" target=\"_blank\" rel=\"noopener\" title>Cre\u00adate freight<\/a><\/td><td>Allows you to cre\u00adate a new freight<\/td><td>POST  \/ex\u00adt\/freights-api\/v1\/freights<br><br>Freight can also be cre\u00adat\u00aded by any pub\u00adli\u00adca\u00adtion request with the <code>\"publish\": false<\/code> attribute set.<\/td><\/tr><tr><td><a href=\"https:\/\/www.trans.eu\/api\/freights-section\/get-freights-list-2\/\" target=\"_blank\" rel=\"noopener\" title>Get freights list<\/a><\/td><td>Allows you to down\u00adload fil\u00adtered list of freights cre\u00adat\u00aded in your own com\u00adpa\u00adny accounts<\/td><td>GET \/ex\u00adt\/freights-api\/v1\/freights<\/td><\/tr><tr><td><a href=\"https:\/\/www.trans.eu\/api\/freights-section\/get-freight-details\/\" target=\"_blank\" rel=\"noopener\" title>Get freight details<\/a><\/td><td>Allows you to down\u00adload details of spec\u00adi\u00adfied freight<\/td><td>GET \/ext\/freights-api\/v1\/freights\/{freight-id}<\/td><\/tr><tr><td><a href=\"https:\/\/www.trans.eu\/api\/freights-section\/get-accepted-freights-list\/\" target=\"_blank\" rel=\"noopener\" title>Get accept\u00aded freights list<\/a><\/td><td>Allows you to down\u00adload fil\u00adtered list of accept\u00aded freights cre\u00adat\u00aded in your own com\u00adpa\u00adny accounts<\/td><td>GET \/ex\u00adt\/freights-api\/v1\/ac\u00adcept\u00aded<\/td><\/tr><tr><td><a href=\"https:\/\/www.trans.eu\/api\/freights-section\/update-freight\/\" target=\"_blank\" rel=\"noopener\" title>Update freight<\/a><\/td><td>Allows you to replace con\u00adtent of spec\u00adi\u00adfied freight that has not yet been pub\u00adlished<\/td><td>PUT \/ext\/freights-api\/v1\/freights\/{freight-id}<br>PUT \/ext\/freights-api\/v1\/freight-exchange\/{freight-id}<br>PUT \/ext\/freights-api\/v1\/private-exchange\/{freight-id}<br>PUT \/ext\/freights-api\/v1\/freight-corporate\/{freight-id}<br>PUT \/ext\/freights-api\/v1\/freight-companies\/{freight-id}<br>PUT \/ext\/freights-api\/v1\/freight-employees\/{freight-id}<br>PUT \/ext\/freights-api\/v1\/freight-auto\/{freight-id}<\/td><\/tr><tr><td><a href=\"https:\/\/www.trans.eu\/api\/freights-section\/delete-freight\/\" target=\"_blank\" rel=\"noopener\" title>Delete freight<\/a><\/td><td>Allows you to delete spec\u00adi\u00adfied freight in draft sta\u00adtus<\/td><td>DELETE \/ext\/freights-api\/v1\/freights\/{freight-id}<\/td><\/tr><tr><td><a href=\"https:\/\/www.trans.eu\/api\/use-case\/request\/add-an-internal-note\/\" target=\"_blank\" rel=\"noopener\" title>Add an inter\u00adnal note<\/a><\/td><td>Allows you to add an inter\u00adnal note to the freight<\/td><td>POST \/ext\/freights-api\/v1\/freights\/{freight-id}\/internal-note<\/td><\/tr><tr><td><a href=\"https:\/\/www.trans.eu\/api\/use-case\/request\/update-an-internal-note\/\" target=\"_blank\" rel=\"noopener\" title>Update an inter\u00adnal note<\/a><\/td><td>Allows you to update inter\u00adnal note cre\u00adat\u00aded for the freight<\/td><td>PUT \/ext\/freights-api\/v1\/freights\/{freight-id}\/internal-note<\/td><\/tr><tr><td><a href=\"https:\/\/www.trans.eu\/api\/use-case\/request\/get-an-internal-note\/\" target=\"_blank\" rel=\"noopener\" title>Get an inter\u00adnal note<\/a><\/td><td>Allows you to down\u00adload con\u00adtent of an inter\u00adnal note cre\u00adat\u00aded for the freight<\/td><td>GET \/ext\/freights-api\/v1\/freights\/{freight-id}\/internal-note<\/td><\/tr><tr><td><a href=\"https:\/\/www.trans.eu\/api\/use-case\/request\/delete-an-internal-note\/\" target=\"_blank\" rel=\"noopener\" title>Delete an inter\u00adnal note<\/a><\/td><td>Allows you to delete con\u00adtent of an inter\u00adnal note cre\u00adat\u00aded for the freight<\/td><td>DELETE \/ext\/freights-api\/v1\/freights\/{freight-id}\/internal-note<\/td><\/tr><tr><td><a href=\"https:\/\/www.trans.eu\/api\/freights-section\/archive-freight\/\" target=\"_blank\" rel=\"noopener\" title>Archive freight<\/a><\/td><td>Allows you to archive select\u00aded, not active freight cre\u00adat\u00aded in your own com\u00adpa\u00adny accounts<\/td><td>POST \/ext\/freights-api\/v1\/freights\/{freight-id}\/archive<\/td><\/tr><tr><td><a href=\"https:\/\/www.trans.eu\/api\/freights-section\/bulk-freight-archiving\/\" target=\"_blank\" rel=\"noopener\" title>Bulk freight archiv\u00ading<\/a><\/td><td>Allows you to archive select\u00aded, not active freights cre\u00adat\u00aded in your own com\u00adpa\u00adny accounts<\/td><td>POST \/ex\u00adt\/freights-api\/v1\/freight\u00ads\/archive<\/td><\/tr><tr><td><a href=\"https:\/\/www.trans.eu\/api\/freights-section\/get-archived-freights-list-2\/\" target=\"_blank\" rel=\"noopener\" title>Get archived freights list<\/a><\/td><td>Allows you to down\u00adload fil\u00adtered list of archived freights cre\u00adat\u00aded in your own com\u00adpa\u00adny accounts<\/td><td>GET \/ex\u00adt\/freights-api\/v1\/archive<\/td><\/tr><\/tbody><\/table><\/figure>\n","protected":false},"excerpt":{"rendered":"<p class=\"dont-break-out\">On the Trans.eu Plat\u00adform, a freight is used to define and offer a ship\u00adment \/ trans\u00adport job that is to \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],"tags":[],"class_list":["post-5790","post","type-post","status-publish","format-standard","hentry","category-freights-section"],"acf":[],"aioseo_notices":[],"lang":"en","translations":{"en":5790},"pll_sync_post":[],"_links":{"self":[{"href":"https:\/\/www.trans.eu\/api\/wp-json\/wp\/v2\/posts\/5790","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=5790"}],"version-history":[{"count":10,"href":"https:\/\/www.trans.eu\/api\/wp-json\/wp\/v2\/posts\/5790\/revisions"}],"predecessor-version":[{"id":6273,"href":"https:\/\/www.trans.eu\/api\/wp-json\/wp\/v2\/posts\/5790\/revisions\/6273"}],"wp:attachment":[{"href":"https:\/\/www.trans.eu\/api\/wp-json\/wp\/v2\/media?parent=5790"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.trans.eu\/api\/wp-json\/wp\/v2\/categories?post=5790"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.trans.eu\/api\/wp-json\/wp\/v2\/tags?post=5790"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}