Getting Shipping Notices
Use the Shipping Notices API to get a specific shipping notice, or to get all shipping notices.
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.
Headers
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) with an empty body.
Otherwise you can just ignore adding the If-None-Match header for the GET request and you will still get the shipping notice or sub-resource in the response.
Please be aware that these ETag values need to be stored on your side as they are later on needed for any PUT or POST requests.
For more information, see Shipping Notices API Headers in "Shipping Notices Overview."
Getting all Shipping Notices
Use the following call to get all shipping notices:
GET /zfs/shipping-notices
The request will return all shipping notices for all merchants associated with the client that requested the access token for this request.
{
"shipping-notices": [
{
"zalando_merchant_id": "string",
"carrier_name": "DHL",
"requested_zalando_location_id": "string",
"pallets_count": 0,
"colli_count": 0,
"hanging_goods_count": 0,
"earliest_delivery_date": "2017-07-21T17:32:28Z",
"merchant_b2b_reference": "string",
"comments": "string",
"self": "string",
"announced_item_sets": {
"href": "string"
},
"dispatch_item_sets": {
"href": "string"
},
"delivery_date_request": {
"href": "string"
},
"delivery_date_confirmation": {
"href": "string"
},
"delivery_time_slot": {
"href": "string"
},
"inbound_tour": {
"href": "string"
},
"zalando_advice_id": "string",
"announced_item_count": 0,
"dispatch_item_count": 0,
"confirmed_delivery_date": "2018-03-03T00:00:00+01:00",
"state": "string"
}
],
"next": "string"
}
Getting a Specific Shipping Notice
To get a specific shipping notice, specify the shipping notice identifier as shown:
GET /zfs/shipping-notices/{shipping_notice_ID}
Response Codes
| HTTP Code | Meaning |
|---|---|
200 |
Shipping notice or notices returned in reply body. |
400 |
Error. Additional information included. |