{"id":6326,"date":"2026-03-13T12:29:44","date_gmt":"2026-03-13T11:29:44","guid":{"rendered":"https:\/\/www.trans.eu\/api\/?p=6326"},"modified":"2026-06-09T14:09:08","modified_gmt":"2026-06-09T12:09:08","slug":"negotiate-freight-offer-2","status":"publish","type":"post","link":"https:\/\/www.trans.eu\/api\/freights-section\/negotiate-freight-offer-2\/","title":{"rendered":"Negotiate freight offer"},"content":{"rendered":"\n
\n
\n

Sub\u00admit\u00adting an offer with a price in the freight nego\u00adti\u00ada\u00adtion process.<\/p>\n\n\n\n\n\n\n\n

The offers-id<\/code> iden\u00adti\u00adfi\u00adca\u00adtion num\u00adber in request can be tak\u00aden from the response of Get freight offer details<\/a> request for pub\u00adlish\u00ader\u2019s side or from Get freight pro\u00adpos\u00adal details<\/a> request for par\u00adtic\u00adi\u00adpan\u00adt\u2019s side of nego\u00adti\u00ada\u00adtions.<\/p>\n<\/div>\n\n\n\n

\n
PATCH<\/strong>
\/ext\/freights-api\/v1\/freights\/offers\/{offer-id}\/negotiate<\/pre>\n<\/div>\n<\/div>\n\n\n\n
<\/div>\n\n\n\n
\n
\n
 Request Authorization<\/h6>\n<\/div>\n\n\n\n
\n
Every request MUST include a valid access token obtained dur\u00ading 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
\n
\n
 Request<\/h6>\n<\/div>\n\n\n\n
\n
\n
\n
Request Head\u00ader<\/a><\/p>\n<\/div>\n\n\n\n
\n
Request Para\u00adme\u00adters<\/a><\/p>\n<\/div>\n\n\n\n
\n
Request Body<\/a><\/p>\n<\/div>\n<\/div>\n<\/div>\n<\/div>\n\n\n\n
\n
\n
 Successful Response<\/h6>\n<\/div>\n\n\n\n
\n
\n
\n
Response Fields<\/a><\/p>\n<\/div>\n\n\n\n
\n
Response Body<\/a><\/p>\n<\/div>\n\n\n\n
\n
<\/p>\n<\/div>\n<\/div>\n<\/div>\n<\/div>\n\n\n\n
\n
\n
 Error Response<\/h6>\n<\/div>\n\n\n\n
\n
\n
\n
Client errors (400)<\/a><\/p>\n<\/div>\n\n\n\n
\n
<\/p>\n<\/div>\n\n\n\n
\n
Gen\u00ader\u00adal API errors<\/a><\/p>\n<\/div>\n<\/div>\n<\/div>\n<\/div>\n\n\n\n
\n
\n
Request Header<\/h6>\n<\/div>\n\n\n\n
\n
PATCH \/ext\/freights-api\/v1\/freights\/offers\/{offer-id}\/negotiate 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
Request Parameters<\/h6>\n\n\n\n
Attribute<\/td>Type<\/td>Exam\u00adple<\/td>Manda\u00adto\u00adry<\/td>Descrip\u00adtion<\/td><\/tr>
pay\u00adment<\/td>Object<\/td><\/td>No<\/td>Pro\u00adposed pay\u00adment con\u00addi\u00adtions<\/td><\/tr>
payment.price<\/td>Object<\/td><\/td>No<\/td>Pro\u00adposed price<\/td><\/tr>
payment.price.currency<\/td>String<\/td>eur<\/td>No<\/td>Price cur\u00adren\u00adcy, default pln is set. See cur\u00adren\u00adcy dic\u00adtio\u00adnary<\/a>.<\/td><\/tr>
payment.price.type<\/td>String<\/td>route<\/td>No<\/td>Type of set\u00adtle\u00adment.
Avail\u00adable val\u00adues: route<\/code>, ton<\/code>. Default is route<\/code>.
Ton <\/code>val\u00adue allowed for mul\u00adti-freights only.<\/td><\/tr>
payment.price.value<\/td>Float<\/td>150<\/td>Yes<\/td>Price val\u00adue (range: 1 \u2013 9 999 999,99)<\/td><\/tr>
target_employee_id<\/td>String<\/td>1013865\u20131<\/td>No<\/td>User\u2019s Trans ID. 
Des\u00adig\u00adnat\u00ading an addi\u00adtion\u00adal per\u00adson to whom we send the offer \u2014 allows you to start inde\u00adpen\u00addent nego\u00adti\u00ada\u00adtions with anoth\u00ader user.<\/td><\/tr>
trans\u00adports<\/td>Object<\/td><\/td>No<\/td>Terms of nego\u00adti\u00adat\u00ading mul\u00adti-freight trans\u00adports<\/td><\/tr>
transports.quantity<\/td>Int<\/td>2<\/td>No<\/td>Num\u00adber of nego\u00adti\u00adat\u00aded trans\u00adports \u2014 must be not greater than the cur\u00adrent num\u00adber of trans\u00adports avail\u00adable for nego\u00adti\u00ada\u00adtion<\/td><\/tr>
ver\u00adsion<\/td>Int<\/td>4<\/td>Yes<\/td>Cur\u00adrent nego\u00adti\u00ada\u00adtion ask\u00ading ver\u00adsion \u2014 the same as returned in Get freight offers list<\/a> or Get freight offer details<\/a> (for pub\u00adlish\u00ader\u2019s side) or returned in Get freight pro\u00adpos\u00adal details<\/a> (for par\u00adtic\u00adi\u00adpan\u00adt\u2019s side)<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
\n
\n
Example Request Body<\/h6>\n<\/div>\n\n\n\n
\n
{\n \"payment\": {\n    \"price\": {\n     \"currency\": \"eur\", \n     \"type\": \"route\",\n     \"value\": 220   \n    }\n  },\n \"target_employee_id\": \"1013865-1\",\n \"transports\": {\n    \"quantity\": 1\n  },\n \"version\": 4\n}<\/code><\/pre><\/div>\n<\/div>\n<\/div>\n\n\n\n
Response Fields<\/h6>\n\n\n\n
Attribute<\/td>Type<\/td>Exam\u00adple<\/td>Descrip\u00adtion<\/td><\/tr>
car\u00adri\u00ader<\/td>Object<\/td><\/td>Infor\u00adma\u00adtion about the car\u00adri\u00ader com\u00adpa\u00adny par\u00adtic\u00adi\u00adpat\u00ading in the nego\u00adti\u00ada\u00adtions<\/td><\/tr>
carrier.company_id<\/td>Int<\/td>1013865<\/td>Office ID of car\u00adri\u00ader com\u00adpa\u00adny<\/td><\/tr>
carrier.cooperation<\/td>Object<\/td><\/td>Coop\u00ader\u00ada\u00adtion sta\u00adtus<\/td><\/tr>
carrier.cooperation.is_suspended<\/td>Boolean<\/td>False<\/td>Deter\u00admines whether coop\u00ader\u00ada\u00adtion with this car\u00adri\u00ader is sus\u00adpend\u00aded<\/td><\/tr>
carrier.legal_name<\/td>String<\/td>Logis\u00adtix Exp<\/td>Name of car\u00adri\u00ader com\u00adpa\u00adny<\/td><\/tr>
carrier.vat_id<\/td>String<\/td>PL4574663803<\/td>Tax id of car\u00adri\u00ader com\u00adpa\u00adny<\/td><\/tr>
created_at<\/td>String<\/td>2026\u201303-04T11:17:18.289Z<\/td>Date and time of send\u00ading the cur\u00adrent offer <\/td><\/tr>
id<\/td>String<\/td>33f16f7a-3547\u201341cc-a82f-fb42a906d5c3<\/td>Offer id<\/td><\/tr>
price<\/td>Object<\/td><\/td>Pro\u00adposed price<\/td><\/tr>
price.currency<\/td>String<\/td>eur<\/td>Price cur\u00adren\u00adcy<\/td><\/tr>
price.type<\/td>String<\/td>ton<\/td>Type of set\u00adtle\u00adment. Avail\u00adable val\u00adues: route<\/code>, ton<\/code>. <\/td><\/tr>
price.value<\/td>Float<\/td>126<\/td>Price val\u00adue<\/td><\/tr>
ver\u00adsion<\/td>Int<\/td>2<\/td>Request\u00aded nego\u00adti\u00ada\u00adtion ask\u00ading ver\u00adsion <\/td><\/tr>
was_negotiated<\/td>Boolean<\/td>False<\/td>True <\/code>- You are the ini\u00adtia\u00adtor of the nego\u00adti\u00ada\u00adtions
False <\/code>- The oth\u00ader par\u00adtic\u00adi\u00adpant in the nego\u00adti\u00ada\u00adtion is its ini\u00adtia\u00adtor<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
\n
\n
Response Body<\/h6>\n<\/div>\n\n\n\n
\n
{\n    \"carrier\": {\n        \"company_id\": 1013865,\n        \"cooperation\": {\n            \"is_suspended\": false\n        },\n        \"legal_name\": \"Logistix Exp\",\n        \"vat_id\": \"PL4574663803\"\n    },\n    \"created_at\": \"2026-03-04T11:17:18.289Z\",\n    \"id\": \"33f16f7a-3547-41cc-a82f-fb42a906d5c3\",\n    \"price\": {\n        \"currency\": \"eur\",\n        \"type\": \"ton\",\n        \"value\": 220\n    },\n    \"version\": 4,\n    \"was_negotiated\": false\n}<\/code><\/pre><\/div>\n<\/div>\n<\/div>\n\n\n\n
Client errors (code 400)<\/h4>\n\n\n\n
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
\n
\n
Example error 1<\/h6>\n\n\n\n
Nego\u00adta\u00adtion is end\u00aded<\/p>\n<\/div>\n\n\n\n
\n
{\n    \"detail\": \"Auction winner was already chosen\",\n    \"status\": 422,\n    \"title\": \"Unprocessable Entity\",\n    \"type\": \"http:\/\/www.w3.org\/Protocols\/rfc2616\/rfc2616-sec10.html\"\n}<\/code><\/pre><\/div>\n<\/div>\n<\/div>\n\n\n\n
\n
\n
Example error 2<\/h6>\n\n\n\n
Trans\u00adports allowed only for mult-freights<\/p>\n<\/div>\n\n\n\n
\n
{\n    \"detail\": \"Transports can not be negotiated for this offer\",\n    \"status\": 422,\n    \"title\": \"Unprocessable Entity\",\n    \"type\": \"http:\/\/www.w3.org\/Protocols\/rfc2616\/rfc2616-sec10.html\"\n}<\/code><\/pre><\/div>\n<\/div>\n<\/div>\n\n\n\n
\n
\n
Example error 3<\/h6>\n\n\n\n
Incon\u00adsis\u00adtent price type<\/p>\n<\/div>\n\n\n\n
\n
{\n    \"detail\": \"Offer price type is not valid\",\n    \"status\": 422,\n    \"title\": \"Unprocessable Entity\",\n    \"type\": \"http:\/\/www.w3.org\/Protocols\/rfc2616\/rfc2616-sec10.html\"\n}<\/code><\/pre><\/div>\n<\/div>\n<\/div>\n","protected":false},"excerpt":{"rendered":"
Sub\u00admit\u00adting an offer with a price in the freight nego\u00adti\u00ada\u00adtion process. Sub\u00admit\u00adting an offer with a price in the freight \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,147],"tags":[],"class_list":["post-6326","post","type-post","status-publish","format-standard","hentry","category-freights-section","category-negotiation-n"],"acf":[],"aioseo_notices":[],"aioseo_head":"\n\t\t\n\t\n\t\n\t\n\t\n\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t