Allows to negotiate conditions of received offer
Url parameters and connection settings
- URL: https://api.platform.trans.eu
- Endpoint: /ext/freights-api/v1/freights/offers/{offer-id}/negotiate
- Method: PATCH
Headers:
- Content-type: application/json
- Accept: application/json
- Authorization: Bearer {access_token}
- Api-key: {unique_app_api-key}
Authorization
Authorization process is described here. Each API request must also consist of unique Api-key obtained during application registration together with client_id and client_secret.
Usage
Once the carrier response has been received it is possible to negotiate received conditions with own offer.
Each offer contains of:
Field | Type | Example | Description |
payment | Object | — | Proposed price description |
payment.price | Object | — | Proposed price description |
payment.price.currency | String | Eur | Currency of proposed price offer |
payment.price.value | Int | 1000 | Value of proposed price offer |
requirements | String | Additional requirements | Requirements and conditions for the offer |
version | String | 7 | Negotiation version |
carrier_offer_expiration_date | Timestamp |
2021-03-08T12:20:34+01:00
|
Offer validity date |
Conditions:
- currency must be the same as in published freight
- version must be one greater than the received
Json example with required data only:
{ "payment": { "price": { "value": 150 } }, "version": 2 }
Response:
{ "carrier": { "company_id": 1013865, "cooperation": { "is_suspended": false }, "legal_name": "Firma Testowa Przewoźnik IIT 2", "vat_id": "PL111111111" }, "created_at": "2021-03-08T10:58:59+01:00", "id": 1735632, "price": { "currency": "eur", "value": 150 }, "requirements": "", "version": 3, "was_negotiated": true }