{"id":6590,"date":"2026-04-30T10:53:02","date_gmt":"2026-04-30T08:53:02","guid":{"rendered":"https:\/\/www.trans.eu\/api\/?p=6590"},"modified":"2026-04-30T19:13:43","modified_gmt":"2026-04-30T17:13:43","slug":"create-fixed-contract","status":"publish","type":"post","link":"https:\/\/www.trans.eu\/api\/freights-section\/create-fixed-contract\/","title":{"rendered":"Create fixed contract"},"content":{"rendered":"\n
\n
\n

Cre\u00adat\u00ading a new fixed con\u00adtract in select\u00aded route.<\/p>\n\n\n\n\n\n\n\n

After suc\u00adcess\u00adful\u00adly exe\u00adcut\u00ading the method, you receive in response the con\u00adtract details with the unique con\u00adtract iden\u00adti\u00adfi\u00adca\u00adtion num\u00adber id <\/strong>assigned when cre\u00adat\u00ading the new con\u00adtract.<\/p>\n<\/div>\n\n\n\n

\n
POST<\/strong>
 \/ext\/contracts-api\/v2\/contracts\/fixed

<\/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
Clients 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
<\/div>\n\n\n\n
\n
\n
Request Header<\/h6>\n<\/div>\n\n\n\n
\n
POST  \/ext\/contracts-api\/v2\/contracts\/fixed 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 for create flexible contract<\/h6>\n\n\n\n
Attribute<\/td>Type<\/td>Exam\u00adple<\/td>Manda\u00adto\u00adry<\/td>Descrip\u00adtion<\/td><\/tr>
car\u00adri\u00ader<\/td>Object<\/td><\/td>Yes<\/td>Car\u00adri\u00ader invit\u00aded to the get con\u00adtract<\/td><\/tr>
carrier.company<\/td>Object<\/td><\/td>Yes<\/td>Car\u00adri\u00ader com\u00adpa\u00adny details<\/td><\/tr>
carrier.company.id<\/td>Int<\/td>456745<\/td>Yes<\/td>Car\u00adri\u00ader com\u00adpa\u00adny Id<\/td><\/tr>
carrier.contact_persons<\/td>Array of Objects<\/td><\/td>No<\/td>Car\u00adri\u00ader per\u00adsons invit\u00aded to get con\u00adtract<\/td><\/tr>
carrier.contact_persons.employee<\/td>Object<\/td><\/td>No<\/td>Con\u00adtact per\u00adson details<\/td><\/tr>
carrier.contact_persons.employee.account_id<\/td>Int<\/td>123321<\/td>No<\/td>Con\u00adtact per\u00adson inter\u00adnal Id<\/td><\/tr>
con\u00adfig<\/td>Object<\/td><\/td>Yes<\/td>Con\u00adtract con\u00adfig\u00adu\u00adra\u00adtion<\/td><\/tr>
config.send_to_carrier<\/td>Boolean<\/td>True<\/td>Yes<\/td>If True<\/code>, cre\u00adat\u00aded con\u00adtract will be auto\u00admat\u00adi\u00adcal\u00adly send to car\u00adri\u00ader.<\/td><\/tr>
order_terms<\/td>Object<\/td><\/td>Yes<\/td>Order terms<\/td><\/tr>
order_terms.additional_terms<\/td>String<\/td>\u201caddi\u00adtion\u00adal terms text\u201d<\/td>No<\/td>Addi\u00adtion\u00adal terms for con\u00adtract<\/td><\/tr>
order_terms.automatic_order_sending<\/td>Boolean<\/td>True<\/td>No<\/td>Set True <\/code>will result in auto\u00admat\u00adic cre\u00adation of a con\u00adfirmed order when the car\u00adri\u00ader accepts the freight<\/td><\/tr>
order_terms.insurance<\/td>Object<\/td><\/td>No<\/td>Insur\u00adance require\u00adments<\/td><\/tr>
order_terms.insurance.load<\/td>Object<\/td><\/td>No<\/td>Val\u00adue of loads<\/td><\/tr>
order_terms.insurance.load.currency<\/td>String<\/td>\u201ceur\u201d<\/td>No<\/td>Loads val\u00adue cur\u00adren\u00adcy<\/td><\/tr>
order_terms.insurance.load.value<\/td>Int<\/td>12000<\/td>No<\/td>Val\u00adue of loads<\/td><\/tr>
order_terms.insurance.third_party<\/td>Object<\/td><\/td>No<\/td>Required insur\u00adance val\u00adue<\/td><\/tr>
order_terms.insurance.third_party.currency<\/td>String<\/td>\u201ceur\u201d<\/td>No<\/td>Insur\u00adance val\u00adue cur\u00adren\u00adcy<\/td><\/tr>
order_terms.insurance.third_party.value<\/td>Int<\/td>20000<\/td>No<\/td>Insur\u00adance val\u00adue<\/td><\/tr>
order_terms.monitoring<\/td>Object<\/td><\/td>No<\/td>GPS mon\u00adi\u00adtor\u00ading<\/td><\/tr>
order_terms.monitoring.monitoring<\/td>Boolean<\/td>True<\/td>No<\/td>Ask\u00ading for GPS mon\u00adi\u00adtor\u00ading if tech\u00adni\u00adcal\u00adly pos\u00adsi\u00adble<\/td><\/tr>
order_terms.payment_period<\/td>Object<\/td><\/td>Yes<\/td>Pay\u00adment peri\u00adod<\/td><\/tr>
order_terms.payment_period.days_type<\/td>String<\/td>\u201cCALENDAR\u201d<\/td>No<\/td>Type of days in the peri\u00adod. Avail\u00adable val\u00adues: WORK<\/code>, CALENDAR<\/code><\/td><\/tr>
order_terms.payment_period.value<\/td>Int<\/td>20<\/td>Yes<\/td>Num\u00adber of days<\/td><\/tr>
order_terms.silent_confirmation<\/td><\/td><\/td><\/td><\/td><\/tr>
order_terms.silent_confirmation.enabled<\/td><\/td><\/td><\/td><\/td><\/tr>
order_terms.silent_confirmation.is_enabled<\/td><\/td><\/td><\/td><\/td><\/tr>
order_terms.silent_confirmation.time<\/td><\/td><\/td><\/td><\/td><\/tr>
order_terms.silent_confirmation.time.begin<\/td><\/td><\/td><\/td><\/td><\/tr>
order_terms.silent_confirmation.time.end<\/td><\/td><\/td><\/td><\/td><\/tr>
order_terms.silent_confirmation.time.unit_code<\/td><\/td><\/td><\/td><\/td><\/tr>
order_terms.silent_confirmation.time.user_unit_code<\/td><\/td><\/td><\/td><\/td><\/tr>
order_terms.silent_confirmation.time.value<\/td><\/td><\/td><\/td><\/td><\/tr>
peri\u00adod<\/td>Object<\/td><\/td>Yes<\/td>Coop\u00ader\u00ada\u00adtion peri\u00adod<\/td><\/tr>
period.from<\/td>String<\/td>\u201c2027\u201301-01T00:00:00.000Z\u201d<\/td>Yes<\/td>Start of coop\u00ader\u00ada\u00adtion<\/td><\/tr>
period.timezone<\/td>String<\/td>\u201c2027\u201312-31T23:59:59.000Z\u201d<\/td>Yes<\/td>Time zone<\/td><\/tr>
period.to<\/td>String<\/td>\u201cEurope\/Warsaw\u201d<\/td>No<\/td>End of coop\u00ader\u00ada\u00adtion. Pos\u00adsi\u00adble val\u00adue null <\/code>for indef\u00adi\u00adnite\u00adly.<\/td><\/tr>
planned_shipments<\/td>Object<\/td><\/td>No<\/td>Planned ship\u00adments in the con\u00adtract<\/td><\/tr>
planned_shipments.periods<\/td>Array of Objects<\/td><\/td>No<\/td>Peri\u00adods list<\/td><\/tr>
planned_shipments.periods.from<\/td>String<\/td>\u201c2027\u201301-01T00:00:00.000Z\u201d<\/td>No<\/td>Start of peri\u00adod<\/td><\/tr>
planned_shipments.periods.to<\/td>String<\/td>\u201c2027\u201312-31T23:59:59.000Z\u201d<\/td>No<\/td>End of peri\u00adod<\/td><\/tr>
planned_shipments.periods.value<\/td>Int<\/td>50<\/td>No<\/td>Num\u00adber of ship\u00adments in peri\u00adod<\/td><\/tr>
planned_shipments.type<\/td>String<\/td>\u201crequired\u201d<\/td>Yes<\/td>Type of ship\u00adments. Avail\u00adable val\u00adues: required<\/code>, expected<\/code>, no_more_than<\/code>.<\/td><\/tr>
planned_shipments.unit<\/td>String<\/td>\u201cship\u00adment\u201d<\/td>Yes<\/td>Unit of ship\u00adments. Avail\u00adable val\u00adues: shipment<\/code>, ton<\/code>, km<\/code>.<\/td><\/tr>
planned_shipments.value<\/td>String<\/td>100<\/td>Yes<\/td>Total num\u00adber of ship\u00adments in the con\u00adtract<\/td><\/tr>
pric\u00ading<\/td>Object<\/td><\/td>No<\/td>Pric\u00ading for con\u00adtract<\/td><\/tr>
pricing.negotiable<\/td>Boolean<\/td>True<\/td>No<\/td>Enabling price nego\u00adti\u00ada\u00adtion with car\u00adri\u00ader<\/td><\/tr>
pricing.price<\/td>Object<\/td><\/td>No<\/td>Price for nego\u00adti\u00ada\u00adtions.
Required for all pric\u00ading type except \u201cpal\u00adlets\u201d.<\/td><\/tr>
pricing.price.currency<\/td>String<\/td>\u201ceur\u201d<\/td>No<\/td>Price cur\u00adren\u00adcy for nego\u00adta\u00adtion<\/td><\/tr>
pricing.price.value<\/td>Float<\/td>145<\/td>No<\/td>Price val\u00adue. 
<\/td><\/tr>
pricing.price_list<\/td>Array of Objects<\/td><\/td>No<\/td>Price list. 
Required for pric\u00ading type \u201cpal\u00adlets\u201d.<\/td><\/tr>
pricing.price_list.price<\/td>Object<\/td><\/td>No<\/td>Price for nego\u00adti\u00ada\u00adtions<\/td><\/tr>
pricing.price_list.price.currency<\/td>String<\/td>\u201ceur\u201d<\/td>No<\/td>Price cur\u00adren\u00adcy<\/td><\/tr>
pricing.price_list.price.value<\/td>Float<\/td>234.34<\/td>No<\/td>Price val\u00adue<\/td><\/tr>
pricing.price_list.range<\/td>Object<\/td><\/td>No<\/td>Range of pal\u00adlets for nego\u00adti\u00ada\u00adtion<\/td><\/tr>
pricing.price_list.range.from<\/td>Int<\/td>1<\/td>No<\/td>Min val\u00adue of pal\u00adlets<\/td><\/tr>
pricing.price_list.range.to<\/td>Int<\/td>6<\/td>No<\/td>Max val\u00adue of pal\u00adlets<\/td><\/tr>
pricing.settlement_basis<\/td>String<\/td>\u201cdistance_from_gps\u201d<\/td>No<\/td>Sur\u00adcharge basis. Required for pric\u00ading types: \u201ckm\u201d, \u201cton\u201d.
Avail\u00adable val\u00adues for \u201ckm\u201d: distance_declared_in_order_terms<\/code>, distance_declared_by_carrier<\/code>,  distance_from_gps<\/code>
Avail\u00adable val\u00adues for \u201cton\u201d: loading<\/code>, unloading<\/code><\/td><\/tr>
pricing.type<\/td>String<\/td>\u201croute\u201d<\/td>Yes<\/td>Type of pric\u00ading. Avail\u00adable val\u00adues: route<\/code>, km<\/code>,  ton<\/code>, pallets<\/code>, linear<\/code>.
Set\u00adtle\u00adment per ton <\/code>is only avail\u00adable for routes with vehi\u00adcles han\u00addling bulk mate\u00adri\u00adals.
Set\u00adtle\u00adments based on the pallet <\/code>price list is only pos\u00adsi\u00adble for routes with pal\u00adlets loads.<\/td><\/tr>
reference_number<\/td>String<\/td>\u201cKon\u00adtrakt 23\/2\u201d<\/td>No<\/td>Exter\u00adnal ref\u00ader\u00adence num\u00adber<\/td><\/tr>
route<\/td>Object<\/td><\/td>Yes<\/td>Route for new con\u00adtract<\/td><\/tr>
route.id<\/td>String<\/td>\u201c3fa85f64-5717\u20134562-b3fc-2c963f66afa6\u201d<\/td>Yes<\/td>Route Id<\/td><\/tr>
sur\u00adcharges<\/td>Array of Objects<\/td><\/td>No<\/td>Sur\u00adcharges<\/td><\/tr>
surcharges.currency<\/td>String<\/td>\u201ceur\u201d<\/td>Yes<\/td>Sur\u00adcharges cur\u00adren\u00adcy<\/td><\/tr>
surcharges.data<\/td><\/td><\/td><\/td><\/td><\/tr>
surcharges.description<\/td>String<\/td>\u201caddi\u00adtion\u00adal text\u201d<\/td>No<\/td>Sur\u00adcharge descrip\u00adtion<\/td><\/tr>
surcharges.id<\/td>String<\/td>\u201ca1eb\u00adb289-e665-4b30-a580-d263552e\u00adf88c\u201d<\/td><\/td>Sur\u00adcharge Id<\/td><\/tr>
surcharges.is_active<\/td>Boolean<\/td>True<\/td><\/td>Sur\u00adcharge acti\u00adva\u00adtion sta\u00adtus<\/td><\/tr>
surcharges.is_global<\/td>Boolean<\/td>False<\/td><\/td>If True<\/code>, sur\u00adcharge is from tem\u00adplate<\/td><\/tr>
surcharges.kind<\/td>String<\/td>\u201cgrid\u201d<\/td><\/td>Kind of sur\u00adcharge.
Avail\u00adable val\u00adues: grid<\/code>, linear<\/code>, value<\/code><\/td><\/tr>
surcharges.schedules<\/td>Array of Objects<\/td><\/td><\/td>Sur\u00adcharge sched\u00adules<\/td><\/tr>
surcharges.schedules.data<\/td>Object<\/td><\/td><\/td>Sur\u00adcharge data<\/td><\/tr>
surcharges.schedules.data.matrix<\/td>Array of Objects<\/td><\/td><\/td>Data object for additional_stop<\/code>, baf<\/code>, pallets_exchange<\/code> sur\u00adcharge types.<\/td><\/tr>
surcharges.schedules.data.matrix.unit<\/td>String<\/td>\u201cper\u00adcent\u00adage\u201d<\/td><\/td>Unit of data. Avail\u00adable val\u00adues: percentage<\/code>, value<\/code>.<\/td><\/tr>
surcharges.schedules.data.matrix.value<\/td>Int<\/td>5<\/td><\/td>Data val\u00adue<\/td><\/tr>
surcharges.schedules.data.currency<\/td>String<\/td>\u201ceur\u201d<\/td><\/td>Cur\u00adren\u00adcy for data<\/td><\/tr>
surcharges.schedules.data.unit<\/td>String<\/td>\u201cper\u00adcent\u00adage\u201d<\/td><\/td>Unit of data for week_days <\/code>sur\u00adcharge type. Avail\u00adable val\u00adues: percentage<\/code>, value<\/code>.<\/td><\/tr>
surcharges.schedules.data.week_days<\/td>Array of Objects<\/td><\/td><\/td>Data object for week_days <\/code>sur\u00adcharge types.<\/td><\/tr>
surcharges.schedules.data.week_days.id<\/td>String<\/td>\u201c1_monday\u201d<\/td><\/td>Week day Id<\/td><\/tr>
surcharges.schedules.data.week_days.operations<\/td>Array of Objects<\/td><\/td><\/td>List of oper\u00ada\u00adtions<\/td><\/tr>
surcharges.schedules.data.week_days.operations.type<\/td>String<\/td>\u201cload\u00ading\u201d<\/td><\/td>Oper\u00ada\u00adtion type. Avail\u00adable val\u00adues: loading<\/code>, unloading<\/code><\/td><\/tr>
surcharges.schedules.data.week_days.operations.value<\/td>Int<\/td>5<\/td><\/td>Data Val\u00adue<\/td><\/tr>
surcharges.schedules.timespan<\/td>Object<\/td><\/td><\/td>Sur\u00adcharge sched\u00adule peri\u00adod<\/td><\/tr>
surcharges.schedules.timespan.from<\/td>String<\/td>\u201c2026\u201304-30T15:30:00+02:00\u201d<\/td><\/td>Start of sched\u00adule<\/td><\/tr>
surcharges.schedules.timespan.to<\/td>String<\/td>\u201c2026\u201305-28T02:00:00+02:00\u201d<\/td><\/td>End of sched\u00adule<\/td><\/tr>
surcharges.type<\/td>String<\/td>\u201cbaf\u201d<\/td><\/td>Sur\u00adcharge type.
Avail\u00adable val\u00adues: additional_stop<\/code>, baf<\/code>, pallets_exchange<\/code>, week_day<\/code><\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
\n
\n
Example Request Body for create fixed contract<\/h6>\n<\/div>\n\n\n\n
\n
{\n  \"route\": {\n    \"id\": \"7eae0ff7-a20e-4378-98df-f1efc2a32de1\"\n  },\n  \"config\": {\n    \"send_to_carrier\": false\n  },\n  \"carrier\": {\n    \"company\": {\n      \"id\": 1013865\n    },\n    \"contact_persons\": [\n      {\n        \"employee\": {\n          \"account_id\": 771476\n        }\n      }\n    ]\n  },\n  \"period\": {\n    \"from\": \"2027-01-01T00:00:00.000Z\",\n    \"to\": null,\n    \"timezone\": \"Europe\/Warsaw\"\n  },\n  \"order_terms\": {\n    \"monitoring\": {\n      \"required\": true\n    },\n    \"additional_terms\": \"Additional terms text\",\n    \"insurance\": {\n      \"load\": {\n        \"value\": 4000,\n        \"currency\": \"EUR\"\n      },\n      \"third_party\": {\n        \"value\": 3000,\n        \"currency\": \"EUR\"\n      }\n    },\n    \"automatic_order_sending\": true,\n    \"payment_period\": {\n      \"days_type\": \"CALENDAR\",\n      \"value\": 31\n    }\n  },\n  \"planned_shipments\": {\n    \"periods\": [\n      {\n        \"from\": \"2027-01-01T00:00:00.000Z\",\n        \"to\": \"2027-12-31T23:59:59.000Z\",\n        \"value\": 100\n      }\n    ],\n    \"type\": \"required\",\n    \"unit\": \"shipment\",\n    \"value\": 100\n  },\n  \"pricing\": {\n    \"type\": \"route\",\n    \"negotiable\": false,\n    \"price\": {\n      \"value\": 1500,\n      \"currency\": \"EUR\"\n    },\n    \"settlement_basis\": \"loading\"\n  },\n  \"reference_number\": \"CONTRACT-2024-001\"\n}<\/code><\/pre><\/div>\n<\/div>\n<\/div>\n\n\n\n
Response Fields for created fixed contract<\/h6>\n\n\n\n
The response con\u00adtains exact\u00adly the same list of fields as the Get con\u00adtract details<\/a> response.<\/p>\n\n\n\n
\n
\n
Response Body for create fixed contract<\/h6>\n<\/div>\n\n\n\n
\n
{\n    \"id\": \"d6c337b2-4690-4885-aba1-cd2cacbcca85\",\n    \"base_contract_id\": \"d6c337b2-4690-4885-aba1-cd2cacbcca85\",\n    \"type\": \"fixed\",\n    \"position\": null,\n    \"carrier\": {\n        \"company\": {\n            \"id\": 1013865,\n            \"name\": \"Firma Testowa Przewo\u017anik IIT 2\"\n        },\n        \"contact_persons\": [\n            {\n                \"id\": \"5a528dde-dee2-4a78-b1a9-4a1a333893d0\",\n                \"employee\": {\n                    \"id\": 999446,\n                    \"account_id\": 771476,\n                    \"given_name\": \"Jan\",\n                    \"family_name\": \"Nowak\",\n                    \"trans_id\": \"1013865-3\",\n                    \"email\": \"jnowak@mail.eu\",\n                    \"telephone\": \"(0048) 12345678\"\n                },\n                \"channels\": [\n                    \"email\",\n                    \"push\",\n                    \"web-push\",\n                    \"messenger\"\n                ],\n                \"reported_by\": {\n                    \"company\": {\n                        \"id\": 1007374\n                    }\n                }\n            }\n        ],\n        \"cooperation_status\": \"active\"\n    },\n    \"deactivations\": [],\n    \"order_terms\": {\n        \"monitoring\": {\n            \"required\": true\n        },\n        \"additional_terms\": \"Additional terms text\",\n        \"insurance\": {\n            \"load\": {\n                \"value\": 4000,\n                \"currency\": \"eur\"\n            },\n            \"third_party\": {\n                \"value\": 3000,\n                \"currency\": \"eur\"\n            }\n        },\n        \"automatic_order_sending\": true,\n        \"payment_period\": {\n            \"value\": 31\n        },\n        \"silent_confirmation\": {\n            \"enabled\": false,\n            \"time\": null\n        },\n        \"autoresponder\": {\n            \"enabled\": false,\n            \"time\": null\n        }\n    },\n    \"period\": {\n        \"from\": \"2027-01-01T00:00:00+00:00\",\n        \"to\": null\n    },\n    \"percentage_share\": 0,\n    \"planned_shipments\": {\n        \"periods\": [\n            {\n                \"value\": 100,\n                \"from\": \"2027-01-01T00:00:00+00:00\",\n                \"to\": \"2027-12-31T23:59:59+00:00\"\n            }\n        ],\n        \"type\": \"required\",\n        \"unit\": \"shipment\",\n        \"value\": 100\n    },\n    \"pricing\": {\n        \"negotiable\": false,\n        \"type\": \"route\",\n        \"price\": {\n            \"value\": 1500,\n            \"currency\": \"eur\"\n        },\n        \"fuel_base_price\": {\n            \"value\": null,\n            \"currency\": \"eur\"\n        }\n    },\n    \"reference_number\": \"CONTRACT-2024-001\",\n    \"route\": {\n        \"id\": \"7eae0ff7-a20e-4378-98df-f1efc2a32de1\",\n        \"unique_key\": null,\n        \"name\": \"API5\",\n        \"publication_scenario\": {\n            \"type\": \"parallel\"\n        },\n        \"spots\": [\n            {\n                \"id\": \"e3ee48f9-2fcd-4580-8906-b6b18b0cc20f\",\n                \"name\": \"Koniec trasy PL 33-300\",\n                \"type\": \"loading\",\n                \"place\": {\n                    \"address\": {\n                        \"locality\": \"Nowy S\u0105cz\",\n                        \"postal_code\": \"33-300\",\n                        \"country\": \"pl\",\n                        \"street\": \"Nowa\",\n                        \"number\": \"16\",\n                        \"location_id\": 1248258,\n                        \"detailed_location_id\": null,\n                        \"foreign_id\": null,\n                        \"radius\": null\n                    },\n                    \"coordinates\": {\n                        \"latitude\": 49.62177,\n                        \"longitude\": 20.69705\n                    }\n                }\n            },\n            {\n                \"id\": \"ca170110-0fdb-47ce-b742-1682a301d965\",\n                \"name\": \"PL Wroc\u0142aw\",\n                \"type\": \"unloading\",\n                \"place\": {\n                    \"address\": {\n                        \"locality\": \"Wroc\u0142aw\",\n                        \"postal_code\": \"50-002\",\n                        \"country\": \"pl\",\n                        \"street\": \"Nowa\",\n                        \"number\": \"2\",\n                        \"location_id\": 2513724,\n                        \"detailed_location_id\": null,\n                        \"foreign_id\": null,\n                        \"radius\": null\n                    },\n                    \"coordinates\": {\n                        \"latitude\": 51.1,\n                        \"longitude\": 17.03333\n                    }\n                }\n            }\n        ],\n        \"distance\": {\n            \"declared\": null,\n            \"calculated\": {\n                \"value\": 378,\n                \"unit_code\": \"km\"\n            }\n        },\n        \"suggested_calculated_route_id\": \"1cd3f0d8-7a7b-4c64-94d9-e30aecda05ce\",\n        \"distance_match\": {\n            \"min\": null,\n            \"max\": null\n        },\n        \"is_roundtrip\": false,\n        \"requirements\": {\n            \"required_truck_bodies\": [],\n            \"required_adr_classes\": [],\n            \"required_ways_of_loading\": [],\n            \"additional_requirements\": [],\n            \"shipping_remarks\": null,\n            \"freight_type\": null,\n            \"vehicle_size\": \"solo\",\n            \"width\": null,\n            \"height\": null,\n            \"length\": null,\n            \"volume\": null,\n            \"capacity\": {\n                \"min\": null,\n                \"max\": null\n            },\n            \"exemption_from_adr\": false\n        },\n        \"loads\": [\n            {\n                \"name\": null,\n                \"type_of_load\": \"2_europalette\",\n                \"amount\": null,\n                \"width\": {\n                    \"value\": 0.8,\n                    \"unit_code\": \"m\"\n                },\n                \"height\": null,\n                \"length\": {\n                    \"value\": 1.2,\n                    \"unit_code\": \"m\"\n                },\n                \"volume\": null,\n                \"weight\": {\n                    \"min\": null,\n                    \"max\": null\n                },\n                \"pallets\": {\n                    \"is_stackable\": false,\n                    \"is_exchangeable\": false\n                }\n            }\n        ],\n        \"balancing\": {\n            \"type\": \"manual\",\n            \"allowed_types\": [\n                \"manual\",\n                \"contract_condition\",\n                \"freight_limit\",\n                \"percentage_share\",\n                \"price_ascending\"\n            ],\n            \"data\": {\n                \"freight_limit\": {\n                    \"min\": null,\n                    \"max\": null\n                }\n            }\n        },\n        \"status\": \"active\",\n        \"shipments_summary\": {\n            \"amount\": 0,\n            \"weight\": {\n                \"value\": 0,\n                \"unit_code\": \"t\"\n            },\n            \"distance\": {\n                \"value\": 0,\n                \"unit_code\": \"km\"\n            },\n            \"price\": [\n                {\n                    \"amount\": null,\n                    \"currency\": null\n                }\n            ]\n        },\n        \"position\": 253,\n        \"_stats\": {\n            \"contracts\": {\n                \"fixed\": 0,\n                \"flexible\": 0\n            },\n            \"transports\": {\n                \"realized\": {\n                    \"average_price\": null,\n                    \"count\": 0\n                },\n                \"awaiting\": {\n                    \"median_price\": null,\n                    \"count\": null\n                },\n                \"cheapest_carrier_offer\": null\n            }\n        }\n    },\n    \"shipper\": {\n        \"company\": {\n            \"id\": 1007374,\n            \"name\": \"Forwarder IIT\"\n        },\n        \"contact_persons\": []\n    },\n    \"status\": \"registered\",\n    \"_stats\": {\n        \"transports\": {\n            \"realized\": null,\n            \"average_per_month\": null,\n            \"awaiting\": null\n        },\n        \"offers\": {\n            \"accepted\": null,\n            \"total\": null,\n            \"acceptance_rate\": null\n        },\n        \"base_contract\": {\n            \"registered\": 1,\n            \"waiting_for_acceptance\": 0,\n            \"waiting_for_initial_carrier_offer\": 0,\n            \"waiting_for_shipper_offer\": 0,\n            \"waiting_for_carrier_offer\": 0,\n            \"refused\": 0,\n            \"accepted\": 0,\n            \"active\": 0,\n            \"finished\": 0\n        }\n    },\n    \"_meta\": {\n        \"is_copy\": false,\n        \"is_parent\": false,\n        \"has_been_sent_to_carrier\": false\n    },\n    \"surcharges\": []\n}<\/code><\/pre><\/div>\n<\/div>\n<\/div>\n\n\n\n
<\/div>\n\n\n\n
Clients 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
Invalid route id<\/p>\n<\/div>\n\n\n\n
\n
{\n    \"type\": \"http:\/\/www.w3.org\/Protocols\/rfc2616\/rfc2616-sec10.html\",\n    \"title\": \"Bad Request\",\n    \"status\": 400,\n    \"detail\": \"Contracted route with ID: 3fa85f64-5717-4562-b3fc-2c963f66afa6 not found!\",\n    \"service_code\": 5404\n}<\/code><\/pre><\/div>\n<\/div>\n<\/div>\n\n\n\n
\n
\n
Example error 2<\/h6>\n\n\n\n
Incor\u00adrect pric\u00ading type<\/p>\n<\/div>\n\n\n\n
\n
{\n    \"type\": \"http:\/\/www.w3.org\/Protocols\/rfc2616\/rfc2616-sec10.html\",\n    \"title\": \"Bad Request\",\n    \"status\": 400,\n    \"detail\": \"Contracted route with id: '7eae0ff7-a20e-4378-98df-f1efc2a32de1' does not support pricing by: 'ton'\"\n}<\/code><\/pre><\/div>\n<\/div>\n<\/div>\n\n\n\n
\n
\n
Example error 3<\/h6>\n\n\n\n
Incor\u00adrect set\u00adtle\u00adment basis<\/p>\n<\/div>\n\n\n\n
\n
{\n    \"type\": \"http:\/\/www.w3.org\/Protocols\/rfc2616\/rfc2616-sec10.html\",\n    \"title\": \"Unprocessable Entity\",\n    \"status\": 422,\n    \"detail\": \"Failed Validation\",\n    \"validation_messages\": {\n        \"pricing\": {\n            \"settlement_basis\": {\n                \"isSettlementBasis\": \"settlement_basis must be a valid settlement basis from the dictionary or a settlement basis transport_price_type not matching the contract pricing_type\"\n            }\n        }\n    }\n}<\/code><\/pre><\/div>\n<\/div>\n<\/div>\n","protected":false},"excerpt":{"rendered":"
Cre\u00adat\u00ading a new fixed con\u00adtract in select\u00aded route. Cre\u00adat\u00ading a new fixed con\u00adtract in select\u00aded route.<\/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,157],"tags":[],"class_list":["post-6590","post","type-post","status-publish","format-standard","hentry","category-freights-section","category-route-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