{"id":6336,"date":"2026-03-13T12:16:29","date_gmt":"2026-03-13T11:16:29","guid":{"rendered":"https:\/\/www.trans.eu\/api\/?p=6336"},"modified":"2026-06-09T14:24:04","modified_gmt":"2026-06-09T12:24:04","slug":"finish-the-negotiations","status":"publish","type":"post","link":"https:\/\/www.trans.eu\/api\/freights-section\/finish-the-negotiations\/","title":{"rendered":"Finish the negotiations"},"content":{"rendered":"\n
\n
\n

Rejec\u00adtion of the received offer and ter\u00admi\u00adna\u00adtion of nego\u00adti\u00ada\u00adtions with the user.<\/p>\n\n\n\n

The par\u00adtic\u00adi\u00adpan\u00adt\u2019s offer is defin\u00adi\u00adtive\u00adly reject\u00aded. The user will no longer be able to par\u00adtic\u00adi\u00adpate in nego\u00adti\u00ada\u00adtions for this freight.<\/p>\n\n\n\n\n\n\n\n

The ver\u00adsion <\/strong>and user ID<\/strong> para\u00adme\u00adters in the request body are option\u00adal, but it is rec\u00adom\u00admend\u00aded to pro\u00advide them with cor\u00adrect val\u00adues to ensure that the user who fin\u00adish\u00ades the offer sees its lat\u00adest ver\u00adsion.<\/p>\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
POST<\/strong>
\/ext\/freights-api\/v1\/freights\/offers\/{offer-id}\/reject<\/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
POST \/ext\/freights-api\/v1\/freights\/offers\/{offer-id}\/reject 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>
target_employee_id<\/td>String<\/td>1002334\u20131<\/td>No<\/td>User\u2019s Trans ID. 
Des\u00adig\u00adnat\u00ading a per\u00adson whose offer is being fin\u00adished.<\/td><\/tr>
ver\u00adsion<\/td>Int<\/td>4<\/td>No<\/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 \"target_employee_id\": \"1013865-1\",\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>\u201ceur\u201d<\/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
Own active offer<\/p>\n<\/div>\n\n\n\n
\n
{\n    \"detail\": \"Active offer was not made by negotiation participant\",\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
Nego\u00adti\u00ada\u00adtion already reject\u00aded<\/p>\n<\/div>\n\n\n\n
\n
{\n    \"detail\": \"Negotiation has already been rejected\",\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
Incor\u00adrect offer-id<\/p>\n<\/div>\n\n\n\n
\n
{\n    \"detail\": \"Negotiation read model not found\",\n    \"status\": 404,\n    \"title\": \"Not Found\",\n    \"type\": \"http:\/\/www.w3.org\/Protocols\/rfc2616\/rfc2616-sec10.html\"\n}<\/code><\/pre><\/div>\n<\/div>\n<\/div>\n","protected":false},"excerpt":{"rendered":"
Rejec\u00adtion of the received offer and ter\u00admi\u00adna\u00adtion of nego\u00adti\u00ada\u00adtions with the user. The par\u00adtic\u00adi\u00adpan\u00adt\u2019s offer is defin\u00adi\u00adtive\u00adly reject\u00aded. The user \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-6336","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