1. Trans.eu Api
  2. Orders
  3. Order confirmations
  4. Confirm arrival for unloading

Confirm arrival for unloading

Request allows you to report arrival of a vehi­cle for unload­ing in select­ed trans­porta­tion order. You can con­firm arrival togeth­er with the order unload­ing con­fir­ma­tion or skip this step.
It is avail­able for sent and received orders for Ship­pers and Car­ri­ers.

The order-id iden­ti­fi­ca­tion num­ber in method call can be tak­en from response after cre­at­ing the order or by down­load­ing the order list.

POST
/ext/orders-api/v1/orders-created/{order-id}/arrived
Request Authorization

Every request MUST include a valid access token obtained dur­ing the user autho­riza­tion process, pro­vid­ed using the Bear­er token scheme in the Autho­riza­tion head­er.

Request

Request Head­er

Request Para­me­ters

Request Body

Successful Response

Response Body

Error Response

Client errors (400)

Gen­er­al API errors

Request Header
POST /ext/orders-api/v1/orders-created/{order-id}/arrived HTTP/1.1 
Host: api.platform.trans.eu 
Content-Type: application/json
Accept: application/json
Authorization: Bearer {access_token) 
Api-key: {unique_app_api-key}
Request Parameters
AttributeTypeExam­pleManda­to­ryDescrip­tion
arrived_atString“2025–10-22T11:00:00+0100”YesDate and time of arrival to unload­ing point.
If a future time is spec­i­fied, the cur­rent time will be record­ed instead.
complete_dateString“2025–10-22T11:30:00+0100”NoDate and time of com­plete unload­ing of the trans­port.
If a future time is spec­i­fied, the cur­rent time will be record­ed instead.
Example Request Body
{ 
   "arrived_at": "2025-10-22T11:00:00+0100",
   "complete_date": "2025-10-22T11:30:00+0100"  // not mandatory
}
Successful Response
204 No Content

Client errors (code 400)

HTTP 4xx sta­tus codes indi­cate client errors, mean­ing that the request could not be processed due to an issue on the client side. Below is a list of request-spe­cif­ic errors.

Example error 1

Order does not exists

{
    "detail": "Entity not found",
    "status": 404,
    "title": "Not Found",
    "type": "http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html"
}
Example error 2

No arrival date

{
    "arrival_date": {
        "isDefined": "arrival_date should not be null or undefined",
        "isIso8601": "arrival_date must be a valid ISO 8601 date string"
    }
}
Example error 3

Attempt to report the arrival date after com­plet­ing the order

{
    "error": "Unprocessable Entity",
    "message": "transportId: 20a931e4-b43c-4bd1-958f-ab2c2e386299: Complete date cannot be before arrival date.",
    "status_code": 422
}