Allows to accept received freight offer. For each freight only one acceptance is possible.

Url parameters and connection settings

  • URL: https://api.platform.trans.eu
  • Endpoint: /ext/freights-api/v1/freights/offers/{offer-id}/accept
  • Method: POST

Headers:

  • Content-type: application/json
  • Accept: application/json
  • Authorization: Bearer {access_token}
  • Api-key: {unique_app_api-key}

Authorization and access

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

Allows to accept recieved price offer by given version. All other offers sent by other carriers are immidiately rejected.

Json example

Request:

{
  "version": 4
}

Status codes:

200 ok if the offer number and version was correct

400 if either offer number or version were incorrect

Response

{
    "carrier": {
        "company_id": 1013865,
        "cooperation": {
            "is_suspended": false
        },
        "legal_name": "Firma Testowa Przewoźnik IIT 2",
        "vat_id": "PL11111111111"
    },
    "created_at": "2021-03-08T10:58:59+01:00",
    "id": 1735632,
    "price": {
        "currency": "eur",
        "value": 140
    },
    "requirements": "",
    "version": 5,
    "was_negotiated": true
}