Accept freight offer

Allows to accept received freight offer. For each freight only one accep­tance is pos­si­ble.

Url parameters and connection settings

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

Headers:

  • Con­tent-type: application/json
  • Accept: application/json
  • Autho­riza­tion: Bear­er {access_token}
  • Api-key: {unique_ap­p_api-key}

Authorization and access

Autho­riza­tion process is described here. Each API request must also con­sist of unique Api-key obtained dur­ing appli­ca­tion reg­is­tra­tion togeth­er with client_id and client_secret.

Usage

Allows to accept recieved price offer by giv­en ver­sion. All oth­er offers sent by oth­er car­ri­ers are immidi­ate­ly reject­ed.

Json example Request:

{
  "version": 4
}

Status codes:

  • 200 ok if the offer num­ber and ver­sion was cor­rect
  • 400 if either offer num­ber or ver­sion were incor­rect

Json example Response

{
  "carrier": {
    "company_id": 1013865,
    "cooperation": {
      "is_suspended": false
    },
    "legal_name": "FirmaTestowaPrzewoźnikIIT2",
    "vat_id": "PL11111111111"
  },
  "created_at": "2021-03-08T10:58:59+01:00",
  "id": "4a2dbtsd-bd6b-4c24-6t2c-256af1005591",
  "price": {
    "currency": "eur",
    "value": 140
  },
  "requirements": "",
  "version": 5,
  "was_negotiated": true
}