{"id":5749,"date":"2026-02-19T15:27:12","date_gmt":"2026-02-19T14:27:12","guid":{"rendered":"https:\/\/www.trans.eu\/api\/?p=5749"},"modified":"2026-03-17T07:58:46","modified_gmt":"2026-03-17T06:58:46","slug":"freight-publication","status":"publish","type":"post","link":"https:\/\/www.trans.eu\/api\/freights-section\/freight-publication\/","title":{"rendered":"Freight publication"},"content":{"rendered":"\n<p>Freight pub\u00adli\u00adca\u00adtions are used to inform poten\u00adtial con\u00adtrac\u00adtors that you have car\u00adgo (one or more ship\u00adments) avail\u00adable for trans\u00adport. Short def\u00adi\u00adn\u00adi\u00adtions of terms:<br><strong>Freight<\/strong> \u2013 a trans\u00adport job \/ car\u00adgo offer that includes ship\u00adment details such as route, dates, require\u00adments, and price.<br><strong>Pub\u00adli\u00adca\u00adtion<\/strong> \u2013 the act of pub\u00adlish\u00ading a freight offer, i.e. mak\u00ading it vis\u00adi\u00adble on the plat\u00adform or send\u00ading it to select\u00aded car\u00adri\u00aders for accep\u00adtance or rejec\u00adtion.<\/p>\n\n\n\n<!--more-->\n\n\n\n<p>You can send the pub\u00adli\u00adca\u00adtion <\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>direct\u00adly to per\u00adsons \u2014 users on Trans.eu Plat\u00adform, <\/li>\n\n\n\n<li>to select\u00aded com\u00adpa\u00adnies, <\/li>\n\n\n\n<li>using matched automa\u00adtion rules pre\u00advi\u00adous\u00adly cre\u00adat\u00aded at Plat\u00adform <\/li>\n\n\n\n<li>to pri\u00advate freight exchange <\/li>\n\n\n\n<li>to Trans.eu Freight Exchange.<\/li>\n<\/ul>\n\n\n\n<p>With a pub\u00adli\u00adca\u00adtion API requests (POST method), you can cre\u00adate a freight and pub\u00adlish it at the same time. It is also pos\u00adsi\u00adble to cre\u00adate a freight with\u00adout pub\u00adlish\u00ading it using the same method. A freight only cre\u00adat\u00aded can\u00adnot be pub\u00adlished by API method, it can be pub\u00adlished from the Trans.eu Plat\u00adform. It is also pos\u00adsi\u00adble to pub\u00adlish a pre\u00advi\u00adous\u00adly cre\u00adat\u00aded freight using the PUT method, but it is nec\u00ades\u00adsary to enter all the freight para\u00adme\u00adters again.<br> If a freight was not pub\u00adlished, it is not vis\u00adi\u00adble to oth\u00ader Trans.eu users, even users from your own com\u00adpa\u00adny. <\/p>\n\n\n\n<p>For a freight to be suc\u00adcess\u00adful\u00adly pub\u00adlished it has to meet sev\u00ader\u00adal cri\u00adte\u00adria:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>the <strong>pub\u00adlish <\/strong>para\u00adme\u00adter must be set to <code>true<\/code><\/li>\n\n\n\n<li>if a freight is being pub\u00adlished to select\u00aded com\u00adpa\u00adnies or direct per\u00adsons, at least one of com\u00adpa\u00adny or per\u00adsons id\u2019s must be valid<\/li>\n\n\n\n<li>if freight is being pub\u00adlished using automa\u00adtion rules, at least one automa\u00adtion rule cre\u00adat\u00aded and active at Plat\u00adform must be matched with freight pub\u00adli\u00adca\u00adtion details<\/li>\n\n\n\n<li>all dates must be greater or equal today<\/li>\n<\/ul>\n\n\n\n<p>The rules for cre\u00adat\u00ading freight are described in <mark style=\"background-color:rgba(0, 0, 0, 0)\" class=\"has-inline-color has-black-color\"><a href=\"https:\/\/www.trans.eu\/api\/freights-section\/freight-creation\/\" target=\"_blank\" rel=\"noopener\" title>Freight cre\u00adation<\/a><\/mark>.<\/p>\n\n\n\n<div style=\"height:30px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<h5 class=\"wp-block-heading\" style=\"font-style:normal;font-weight:700\">Webhooks<\/h5>\n\n\n\n<p>When request\u00ading the freight pub\u00adli\u00adca\u00adtion, you can spec\u00adi\u00adfy the <strong>callback_url <\/strong>address to receive noti\u00adfi\u00adca\u00adtions about changes in the sta\u00adtus of the cre\u00adat\u00aded freight and changes in the sta\u00adtus of the pub\u00adli\u00adca\u00adtion \u2014 see <a href=\"https:\/\/www.trans.eu\/api\/general-information\/api-callback-urls\/\" target=\"_blank\" rel=\"noopener\" title>details and noti\u00adfi\u00adca\u00adtion list<\/a><\/p>\n\n\n\n<div style=\"height:50px\" 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=\"publicationstatuses\">\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\">Publication statuses<\/h5>\n\n\n\n<p>Val\u00adues \u200b\u200breturned in the publication_status 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<figure class=\"wp-block-table is-style-stripes has-small-font-size\"><table class=\"has-fixed-layout\"><tbody><tr><td>Pub\u00adli\u00adca\u00adtion sta\u00adtus<\/td><td>Descrip\u00adtion<\/td><\/tr><tr><td>null<\/td><td>No sta\u00adtus for freight before pub\u00adli\u00adca\u00adtion<\/td><\/tr><tr><td>active<\/td><td>When the freight is being pub\u00adlished<\/td><\/tr><tr><td>fin\u00adished<\/td><td>When pub\u00adli\u00adca\u00adtion has been com\u00adplet\u00aded<\/td><\/tr><tr><td>offers_timeout<\/td><td>When the <code>decision_date <\/code>has passed and there are offers from car\u00adri\u00aders (the pub\u00adli\u00adca\u00adtion is not fin\u00adished yet)<\/td><\/tr><tr><td>waiting_for_publication<\/td><td>When <code>publish_date <\/code>in future was giv\u00aden dur\u00ading pub\u00adli\u00adca\u00adtion request<\/td><\/tr><\/tbody><\/table><\/figure>\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-top is-layout-flow wp-block-column-is-layout-flow\" style=\"flex-basis:25%\" id=\"responsebody\">\n<h5 class=\"wp-block-heading\" id=\"combustion\" style=\"font-style:normal;font-weight:700\">Publication end reasons<\/h5>\n\n\n\n<p>Val\u00adues \u200b\u200breturned in the end_reason 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<figure class=\"wp-block-table is-style-stripes has-small-font-size\"><table class=\"has-fixed-layout\"><tbody><tr><td>End rea\u00adson<\/td><td>Descrip\u00adtion<\/td><\/tr><tr><td>accept\u00aded<\/td><td>Accep\u00adtance of the car\u00adri\u00ader\u2019s offer<\/td><\/tr><tr><td>can\u00adceled<\/td><td>Can\u00adcel\u00ading an ongo\u00ading pub\u00adli\u00adca\u00adtion<\/td><\/tr><tr><td>reject\u00aded<\/td><td>All car\u00adri\u00aders\u2019 offers were reject\u00aded<\/td><\/tr><tr><td>time\u00adout<\/td><td>Freight pub\u00adli\u00adca\u00adtion time has expired (after the last unload\u00ading date) and there were no offers from car\u00adri\u00aders<\/td><\/tr><tr><td>regulations_violated<\/td><td>The deci\u00adsion to can\u00adcel the freight was made by Trans.eu<\/td><\/tr><tr><td>company_blocked<\/td><td>The pub\u00adlish\u00ading com\u00adpa\u00adny has been blocked on the Trans.eu Plat\u00adform<\/td><\/tr><tr><td>company_removed_from_exchange<\/td><td>The pub\u00adlish\u00ading com\u00adpa\u00adny has lost its autho\u00adriza\u00adtion to pub\u00adlish on pri\u00advate exchange<\/td><\/tr><tr><td>fail\u00adure<\/td><td>Inter\u00adnal sys\u00adtem error<\/td><\/tr><\/tbody><\/table><\/figure>\n<\/div>\n<\/div>\n\n\n\n<h6 class=\"wp-block-heading\" id=\"requeststructure\" style=\"font-style:normal;font-weight:700\">Dedicated Requests<\/h6>\n\n\n\n<figure class=\"wp-block-table\"><table><tbody><tr><td>Link to details<\/td><td>Short descrip\u00adtion<\/td><td>Request<\/td><\/tr><tr><td><a href=\"https:\/\/www.trans.eu\/api\/freights-section\/publish-to-trans-eu-freight-exchange\/\" target=\"_blank\" rel=\"noopener\" title>Pub\u00adli\u00adca\u00adtion to Trans.eu Freight Exchange<\/a><\/td><td>Allows you to pub\u00adlish a new freight on pub\u00adlic exchange \u2014 Trans.eu Freight Exchange<\/td><td>POST \/ex\u00adt\/freights-api\/v1\/freight-exchange<\/td><\/tr><tr><td><a href=\"https:\/\/www.trans.eu\/api\/freights-section\/publish-to-private-exchange\/\" target=\"_blank\" rel=\"noopener\" title>Pub\u00adli\u00adca\u00adtion to pri\u00advate exchange<\/a><\/td><td>Allows you to pub\u00adlish a new freight on own pri\u00advate exchange.<\/td><td>POST \/ex\u00adt\/freights-api\/v1\/pri\u00advate-exchange<\/td><\/tr><tr><td><a href=\"https:\/\/www.trans.eu\/api\/freights-section\/publish-to-branded-private-exchange\/\" target=\"_blank\" rel=\"noopener\" title>Pub\u00adli\u00adca\u00adtion to brand\u00aded pri\u00advate exchange<\/a><\/td><td>Allows you to pub\u00adlish a new freight on brand\u00aded pri\u00advate exchanges to which you have access<\/td><td>POST \/ex\u00adt\/freights-api\/v1\/freight-cor\u00adpo\u00adrate<\/td><\/tr><tr><td><a href=\"https:\/\/www.trans.eu\/api\/freights-section\/publish-to-multi-exchanges\/\" target=\"_blank\" rel=\"noopener\" title>Pub\u00adli\u00adca\u00adtion to mul\u00adti exchanges<\/a><\/td><td>Allows you to pub\u00adlish a new freight simul\u00adta\u00adne\u00adous\u00adly to many recip\u00adi\u00adents at the same time<\/td><td>POST \/ex\u00adt\/freights-api\/v2\/freights<\/td><\/tr><tr><td><a href=\"https:\/\/www.trans.eu\/api\/freights-section\/publish-using-automation-rules\/\" target=\"_blank\" rel=\"noopener\" title>Pub\u00adli\u00adca\u00adtion using automa\u00adtion rules<\/a><\/td><td>Allows you to pub\u00adlish a new freight using rules defined at Trans.eu Plat\u00adform<\/td><td>POST \/ex\u00adt\/freights-api\/v1\/freight-auto<\/td><\/tr><tr><td><a href=\"https:\/\/www.trans.eu\/api\/freights-section\/publish-to-selected-partners\/\" target=\"_blank\" rel=\"noopener\" title>Pub\u00adli\u00adca\u00adtion to select\u00aded part\u00adners<\/a><\/td><td>Allows you to pub\u00adlish a new freight to select\u00aded part\u00adners<\/td><td>POST \/ex\u00adt\/freights-api\/v1\/freight-com\u00adpa\u00adnies<\/td><\/tr><tr><td><a href=\"https:\/\/www.trans.eu\/api\/freights-section\/publish-directly-to-persons\/\" target=\"_blank\" rel=\"noopener\" title>Pub\u00adli\u00adca\u00adtion direct\u00adly to per\u00adsons<\/a><\/td><td>Allows you to pub\u00adlish a new freight direct\u00adly to select\u00aded per\u00adsons<\/td><td>POST \/ex\u00adt\/freights-api\/v1\/freight-employ\u00adees<\/td><\/tr><tr><td><a href=\"https:\/\/www.trans.eu\/api\/freights-section\/refresh-publication\/\" target=\"_blank\" rel=\"noopener\" title>Refresh pub\u00adli\u00adca\u00adtion<\/a><\/td><td>Allows you to push active freight to top of the freight offers list on exchange with\u00adout hav\u00ading to cre\u00adate a new freight<\/td><td>PUT \/ext\/freights-api\/v1\/freights\/{freight-id}\/refresh_publication<br><br>PUT \/ext\/corporate-exchange-api\/v1\/corporate-exchange\/{freight-id}\/refresh-publication<br><br>PUT \/ext\/private-exchange-api\/v1\/exchange\/{freight-id}\/refresh-publication<\/td><\/tr><tr><td><a href=\"https:\/\/www.trans.eu\/api\/freights-section\/cancel-freight-publication-2\/\" target=\"_blank\" rel=\"noopener\" title>Can\u00adcel pub\u00adli\u00adca\u00adtion<\/a><\/td><td>Allows you to can\u00adcel active freight pub\u00adli\u00adca\u00adtion<\/td><td>POST \/ext\/freights-api\/v1\/cancelPublication\/{freight-id}<\/td><\/tr><tr><td><a href=\"https:\/\/www.trans.eu\/api\/freights-section\/bulk-cancel-publications\/\" target=\"_blank\" rel=\"noopener\" title>Bulk can\u00adcel pub\u00adli\u00adca\u00adtions<\/a><\/td><td>Allows you to can\u00adcel more pub\u00adli\u00adca\u00adtions in one time<\/td><td>POST \/ex\u00adt\/freights-api\/v1\/\u00adcancelPub\u00adli\u00adca\u00adtion<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<p><\/p>\n","protected":false},"excerpt":{"rendered":"<p class=\"dont-break-out\">Freight pub\u00adli\u00adca\u00adtions are used to inform poten\u00adtial con\u00adtrac\u00adtors that you have car\u00adgo (one or more ship\u00adments) avail\u00adable for trans\u00adport. Short \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-5749","post","type-post","status-publish","format-standard","hentry","category-freights-section"],"acf":[],"aioseo_notices":[],"lang":"en","translations":{"en":5749},"pll_sync_post":[],"_links":{"self":[{"href":"https:\/\/www.trans.eu\/api\/wp-json\/wp\/v2\/posts\/5749","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=5749"}],"version-history":[{"count":10,"href":"https:\/\/www.trans.eu\/api\/wp-json\/wp\/v2\/posts\/5749\/revisions"}],"predecessor-version":[{"id":6374,"href":"https:\/\/www.trans.eu\/api\/wp-json\/wp\/v2\/posts\/5749\/revisions\/6374"}],"wp:attachment":[{"href":"https:\/\/www.trans.eu\/api\/wp-json\/wp\/v2\/media?parent=5749"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.trans.eu\/api\/wp-json\/wp\/v2\/categories?post=5749"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.trans.eu\/api\/wp-json\/wp\/v2\/tags?post=5749"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}