Tracking Shipments

Once you have made a shipment, you may track the shipment using the Tours API, and you may track the inbound receive process at the Zalando Warehouse with the Stock Movements API.

Authentication

The zDirect API requires OAuth 2.0 authentication for all API calls. Use the Authentication API to generate access tokens as described in the Authentication section.

You may optionally include an If-None-Match header with any GET request for a shipping notice or sub-resource containing an ETag. If the specified ETag does match, then the Shipping Notices API will return the HTTP status code 304 (Not Modified). For more information, see Shipping Notices API Headers in "Shipping Notices Overview."

Tours API

You may use the Tours API to track the status of the shipment:

GET /zfs/tours?zalando_advice_id=$ID

For more information on the Zalando Advice ID, see Shipping Notice ID and Zalando Advice ID in "Shipping Stock to Zalando."

A successful request will return an HTTP 200 response code with a reply body like the following example:

{
  "tours": [
    {
      "zalando_advice_id": "99200000",
      "shipping_notice_id": "a2e9e478-f9ec-4af3-b773-75da5b6d7470",
      "tour_number": "20171026-0001-BR-ERF",
      "to_location": "string",
      "from_location": "string",
      "planned_arrival_time_at_dock": "2024-03-09T15:05:53.287Z",
      "planned_arrival_time_at_yard": "2024-03-09T15:05:53.287Z",
      "planned_amount_of_loading_units": {
        "pallets": 0,
        "colli": 0,
        "hanging_garments": 0
      },
      "actual_amount_of_loading_units": {
        "pallets": 0,
        "colli": 0,
        "hanging_garments": 0
      },
      "type": "NEW_GOODS",
      "current_status": {
        "status": "initialized | unloading | arrived | unloaded | rejected | canceled",
        "status_text": "initialized | unloading | arrived | unloaded | rejected | canceled",
        "last_updated": "2024-03-09T15:05:53.287Z"
      }
    }
  ]
}

Stock Movements API

To track the status of inbound receive process, use the Stock Movements API as described in Tracking Stock Movements.

Contact Support