{"id":6321,"date":"2026-03-26T12:08:29","date_gmt":"2026-03-26T11:08:29","guid":{"rendered":"https:\/\/www.trans.eu\/api\/?p=6321"},"modified":"2026-03-26T13:44:11","modified_gmt":"2026-03-26T12:44:11","slug":"price-offer-negotiation","status":"publish","type":"post","link":"https:\/\/www.trans.eu\/api\/freights-section\/price-offer-negotiation\/","title":{"rendered":"Price offer negotiation"},"content":{"rendered":"\n

The API enables nego\u00adti\u00ada\u00adtion of the terms of car\u00adriage for a pub\u00adlished freight. Nego\u00adti\u00adat\u00ading par\u00adties can agree on the price for the order and, in the case of mul\u00adti-freight ship\u00adments, the quan\u00adti\u00adty of goods to be trans\u00adport\u00aded.<\/p>\n\n\n\n

Negotiation flow and available actions<\/h3>\n\n\n\n
    \n
  1. Nego\u00adti\u00ada\u00adtions are ini\u00adti\u00adat\u00aded by a car\u00adri\u00ader inter\u00adest\u00aded in a freight offer (the nego\u00adti\u00ada\u00adtion par\u00adtic\u00adi\u00adpant<\/strong>). The par\u00adtic\u00adi\u00adpant selects one of the con\u00adtact per\u00adsons assigned to the freight (the nego\u00adti\u00ada\u00adtion own\u00ader<\/strong>) and sub\u00admits a pro\u00adposed offer price.
    Cur\u00adrent\u00adly, car\u00adri\u00aders can nego\u00adti\u00adate via API only direct offers, part\u00adners offers, and fixed-route offers. Nego\u00adti\u00adat\u00ading exchange offers is avail\u00adable to car\u00adri\u00aders only on the Trans.eu Plat\u00adform.
    <\/li>\n\n\n\n
  2. The user des\u00adig\u00adnat\u00aded for nego\u00adti\u00ada\u00adtion on the publisher\u2019s side (the nego\u00adti\u00ada\u00adtion own\u00ader) can accept the offer, pro\u00adpose a new offer price, reject the carrier\u2019s offer or end the nego\u00adti\u00ada\u00adtion with the car\u00adri\u00ader.
    Before the nego\u00adti\u00ada\u00adtion own\u00ader takes any action, the nego\u00adti\u00ada\u00adtion par\u00adtic\u00adi\u00adpant may with\u00addraw their offer.
    <\/li>\n\n\n\n
  3. If the nego\u00adti\u00ada\u00adtion own\u00ader pro\u00adpos\u00ades a new price, the nego\u00adti\u00ada\u00adtion par\u00adtic\u00adi\u00adpant can accept the offer, pro\u00adpose a new offer price, reject the owner\u2019s offer or end the nego\u00adti\u00ada\u00adtion with this user.
    Before the nego\u00adti\u00ada\u00adtion par\u00adtic\u00adi\u00adpant responds to the new offer, the nego\u00adti\u00ada\u00adtion own\u00ader may with\u00addraw their offer.
    <\/li>\n\n\n\n
  4. If the nego\u00adti\u00ada\u00adtion par\u00adtic\u00adi\u00adpant accepts the nego\u00adti\u00ada\u00adtion owner\u2019s offer, the nego\u00adti\u00ada\u00adtion is final\u00adized and the terms are con\u00adfirmed only after the nego\u00adti\u00ada\u00adtion own\u00ader also accepts the participant\u2019s accep\u00adtance.
    In the case of \u201c<\/strong>Buy Now\u201d<\/strong> pub\u00adli\u00adca\u00adtions, the nego\u00adti\u00ada\u00adtion par\u00adtic\u00adi\u00adpant can only accept the offered price or end the nego\u00adti\u00ada\u00adtion. Accep\u00adtance of the offer is final, and no con\u00adfir\u00adma\u00adtion from the nego\u00adti\u00ada\u00adtion own\u00ader is required.
    <\/li>\n\n\n\n
  5. If one par\u00adty rejects the offer, the oth\u00ader par\u00adty may restart the nego\u00adti\u00ada\u00adtion by sub\u00admit\u00adting a new price offer.
    <\/li>\n\n\n\n
  6. End\u00ading the nego\u00adti\u00ada\u00adtion by either par\u00adty pre\u00advents both sides from restart\u00ading the nego\u00adti\u00ada\u00adtion for the giv\u00aden freight (pub\u00adli\u00adca\u00adtion).
    <\/li>\n\n\n\n
  7. A nego\u00adti\u00ada\u00adtion han\u00addled by the nego\u00adti\u00ada\u00adtion own\u00ader may be tak\u00aden over by anoth\u00ader employ\u00adee of the same com\u00adpa\u00adny, pro\u00advid\u00aded they have the appro\u00adpri\u00adate per\u00admis\u00adsions. This oper\u00ada\u00adtion is typ\u00adi\u00adcal\u00adly used when the nego\u00adti\u00ada\u00adtion own\u00ader is unavail\u00adable and the nego\u00adti\u00ada\u00adtion needs to be com\u00adplet\u00aded.<\/li>\n<\/ol>\n\n\n\n
    <\/div>\n\n\n\n

    Negotiation endpoints for negotiation owner<\/h3>\n\n\n\n

    A nego\u00adti\u00ada\u00adtion own\u00ader can retrieve the list of nego\u00adti\u00ada\u00adtions for a select\u00aded freight using the Get freight offer list<\/a> end\u00adpoint, which pro\u00advides infor\u00adma\u00adtion such as the offer ID<\/strong>, nego\u00adti\u00ada\u00adtion sta\u00adtus and the cur\u00adrent nego\u00adti\u00adat\u00aded price.<\/p>\n\n\n\n

    By pro\u00advid\u00ading the offer ID<\/strong> in the Get freight offer details<\/a> end\u00adpoint, the user can obtain detailed infor\u00adma\u00adtion about a spe\u00adcif\u00adic nego\u00adti\u00ada\u00adtion, includ\u00ading the con\u00adtact details of the nego\u00adti\u00ada\u00adtion par\u00adtic\u00adi\u00adpant and the his\u00adto\u00adry of actions per\u00adformed by both par\u00adties.<\/p>\n\n\n\n

    Using the same offer ID<\/strong> and the cur\u00adrent nego\u00adti\u00ada\u00adtion step (\u201cver\u00adsion num\u00adber\u201d) returned by one of the above end\u00adpoints, the user can per\u00adform a nego\u00adti\u00ada\u00adtion action avail\u00adable for the cur\u00adrent nego\u00adti\u00ada\u00adtion action type \u2014 all end\u00adpoints are list\u00aded in the table below<\/a>.<\/p>\n\n\n\n

    <\/div>\n\n\n\n
    \n
    \n
    Negotiation status<\/h5>\n\n\n\n

    <\/p>\n<\/div>\n\n\n\n

    \n
    Nego\u00adti\u00ada\u00adtion action<\/td>Descrip\u00adtion<\/td><\/tr>
    accep\u00adta\u00adtion<\/td>The offer nego\u00adti\u00ada\u00adtion is accept\u00aded. No fur\u00adther nego\u00adti\u00ada\u00adtion action is pos\u00adsi\u00adble.<\/td><\/tr>
    nego\u00adti\u00ada\u00adtion<\/td>The offer nego\u00adti\u00ada\u00adtion is ongo\u00ading. Fur\u00adther nego\u00adti\u00ada\u00adtion action is pos\u00adsi\u00adble.<\/td><\/tr>
    rejec\u00adtion<\/td>The offer nego\u00adti\u00ada\u00adtion was fin\u00adished with\u00adout result. No fur\u00adther nego\u00adti\u00ada\u00adtion action is pos\u00adsi\u00adble.<\/td><\/tr>
    renounce\u00adment<\/td>The offer nego\u00adti\u00ada\u00adtion is reject\u00aded. Fur\u00adther nego\u00adti\u00ada\u00adtion action is pos\u00adsi\u00adble.<\/td><\/tr><\/tbody><\/table><\/figure>\n<\/div>\n<\/div>\n\n\n\n
    <\/div>\n\n\n\n
    Negotiation requests dedicated to the negotiation owner<\/h6>\n\n\n\n
    Link to details<\/td>Short descrip\u00adtion<\/td>Request<\/td><\/tr>
    Get freight offer list<\/a><\/td>Allows you to down\u00adload list of offers sub\u00admit\u00adted for freight<\/td>GET \/ext\/freights-api\/v1\/freights\/{freight-id}\/offers<\/td><\/tr>
    Get freight offer details<\/a><\/td>Allows you to down\u00adload offer details and its nego\u00adti\u00ada\u00adtion his\u00adto\u00adry<\/td>GET \/ext\/freights-api\/v1\/freights\/offers\/{offers-id}<\/td><\/tr>
    Nego\u00adti\u00adate freight offer<\/a><\/td>Allows you to sub\u00admit price offer in nego\u00adti\u00ada\u00adtions<\/td>PATCH \/ext\/freights-api\/v1\/freights\/offers\/{offer-id}\/negotiate<\/td><\/tr>
    Accept freight offer<\/a><\/td>Allows for the accep\u00adtance of an price offer sub\u00admit\u00adted by a par\u00adtic\u00adi\u00adpant in the nego\u00adti\u00ada\u00adtions<\/td>POST \/ext\/freights-api\/v1\/freights\/offers\/{offer-id}\/accept<\/td><\/tr>
    Reject freight offer<\/a><\/td>Allows you to reject a par\u00adtic\u00adi\u00adpan\u00adt\u2019s offer<\/td>POST \/ext\/freights-api\/v1\/freights\/offers\/{offer-id}\/renouncement<\/td><\/tr>
    With\u00addraw last offer<\/a><\/td>Allows you to with\u00addraw your own offer<\/td>POST \/ext\/freights-api\/v1\/freights\/offers\/{offer-id}\/withdraw<\/td><\/tr>
    Tak\u00ading over the nego\u00adti\u00ada\u00adtions<\/a><\/td>Allows anoth\u00ader employ\u00adee of the com\u00adpa\u00adny to take over the nego\u00adti\u00ada\u00adtions<\/td>PATCH \/ext\/freights-api\/v1\/freights\/offers\/{offer-id}\/takeover<\/td><\/tr>
    Fin\u00adish the nego\u00adti\u00ada\u00adtions<\/a><\/td>Allows you to reject the offer and defin\u00adi\u00adtive\u00adly close the nego\u00adti\u00ada\u00adtions<\/td>POST \/ext\/freights-api\/v1\/freights\/offers\/{offer-id}\/reject<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
    <\/div>\n\n\n\n

    Negotiations endpoints for negotiations participant<\/h3>\n\n\n\n

    Once the nego\u00adti\u00ada\u00adtions starts, the par\u00adtic\u00adi\u00adpat\u00ading user can obtain detailed infor\u00adma\u00adtion about the nego\u00adti\u00adat\u00aded freight, the offer ID<\/strong> and the cur\u00adrent price offer request\u00ading Get freight pro\u00adpos\u00adal<\/a> end\u00adpoint.<\/p>\n\n\n\n

    Using the offer ID<\/strong> and the cur\u00adrent nego\u00adti\u00ada\u00adtion step (\u201cver\u00adsion num\u00adber\u201d) returned by the above end\u00adpoint, the user can per\u00adform a nego\u00adti\u00ada\u00adtion action avail\u00adable for the cur\u00adrent \u201cstage\u201d and \u201csta\u00adtus\u201d val\u00adues \u2014 all end\u00adpoints are list\u00aded in the table below<\/a>.<\/p>\n\n\n\n

    <\/div>\n\n\n\n
    Negotiation requests dedicated to the negotiation participant<\/h6>\n\n\n\n
    Link to details<\/td>Short descrip\u00adtion<\/td>Request<\/td><\/tr>
    Get freight pro\u00adpos\u00adal list<\/a><\/td>Allows you to down\u00adload a list of all nego\u00adti\u00adat\u00aded freight offers<\/td>GET \/ex\u00adt\/freights-api\/v2\/freight-pro\u00adpos\u00adals<\/td><\/tr>
    Get freight pro\u00adpos\u00adal details<\/a><\/td>Allows you to down\u00adload a list of all nego\u00adti\u00adat\u00aded offers for a freight<\/td>GET \/ext\/freights-api\/v2\/freight-proposals\/{freight-id}<\/td><\/tr>
    Nego\u00adti\u00adate freight offer<\/a><\/td>Allows you to sub\u00admit price offer in nego\u00adti\u00ada\u00adtions<\/td>PATCH \/ext\/freights-api\/v1\/freights\/offers\/{offer-id}\/negotiate<\/td><\/tr>
    Accept freight offer<\/a><\/td>Allows for the accep\u00adtance of an price offer sub\u00admit\u00adted by a pub\u00adlish\u00ader in the nego\u00adti\u00ada\u00adtions<\/td>POST \/ext\/freights-api\/v1\/freights\/offers\/{offer-id}\/accept<\/td><\/tr>
    Reject freight offer<\/a><\/td>Allows you to reject a pub\u00adlish\u00ader\u2019s offer<\/td>POST \/ext\/freights-api\/v1\/freights\/offers\/{offer-id}\/renouncement<\/td><\/tr>
    With\u00addraw last offer<\/a><\/td>Allows you to with\u00addraw your own offer<\/td>POST \/ext\/freights-api\/v1\/freights\/offers\/{offer-id}\/withdraw<\/td><\/tr>
    Fin\u00adish the nego\u00adti\u00ada\u00adtions<\/a><\/td>Allows you to reject the offer and defin\u00adi\u00adtive\u00adly close the nego\u00adti\u00ada\u00adtions<\/td>POST \/ext\/freights-api\/v1\/freights\/offers\/{offer-id}\/reject<\/td><\/tr>
    Get accept\u00aded freight pro\u00adpos\u00adals<\/a><\/td>Allows you to down\u00adload a list of all nego\u00adti\u00adat\u00aded and accept\u00aded freight offers<\/td>GET \/ex\u00adt\/freights-api\/v1\/freight-pro\u00adpos\u00adal\u00ads\/ac\u00adcept\u00aded<\/td><\/tr>
    Get archived freight pro\u00adpos\u00adals<\/a><\/td>Allows you to down\u00adload a list of all nego\u00adti\u00adat\u00aded and archived freight offers<\/td>GET \/ex\u00adt\/freights-api\/v1\/freight-pro\u00adpos\u00adal\u00ads\/archived<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n

    <\/p>\n","protected":false},"excerpt":{"rendered":"

    The API enables nego\u00adti\u00ada\u00adtion of the terms of car\u00adriage for a pub\u00adlished freight. Nego\u00adti\u00adat\u00ading par\u00adties can agree on the price \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-6321","post","type-post","status-publish","format-standard","hentry","category-freights-section"],"acf":[],"aioseo_notices":[],"lang":"en","translations":{"en":6321},"pll_sync_post":[],"_links":{"self":[{"href":"https:\/\/www.trans.eu\/api\/wp-json\/wp\/v2\/posts\/6321","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=6321"}],"version-history":[{"count":10,"href":"https:\/\/www.trans.eu\/api\/wp-json\/wp\/v2\/posts\/6321\/revisions"}],"predecessor-version":[{"id":6454,"href":"https:\/\/www.trans.eu\/api\/wp-json\/wp\/v2\/posts\/6321\/revisions\/6454"}],"wp:attachment":[{"href":"https:\/\/www.trans.eu\/api\/wp-json\/wp\/v2\/media?parent=6321"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.trans.eu\/api\/wp-json\/wp\/v2\/categories?post=6321"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.trans.eu\/api\/wp-json\/wp\/v2\/tags?post=6321"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}