Once you have set prices and stock for products and completed the Go Live stage of onboarding, you are ready to export and process customer orders. This guide describes how to understand order data, and how to use the Orders API to get and modify orders.
Note that the Orders API is optimized for getting and managing orders, and we do not recommend using it for other reasons.
Partners using Partner Fulfillment are responsible for using the Orders API to get and fulfill orders. Order data is available from zDirect in near-real-time.
Once we set an order's status to
approved, you may export the order and fulfill it, as described in this guide.
Because we handle order fulfillment for our ZFS partners, this guide is mainly addressed to our Partner Fulfillment partners. It sometimes assumes that the reader uses the Orders API for fulfillment. ZFS partners can disregard such instructions.
However, the Orders API is important for ZFS partners as well. ZFS partners have read access to the Orders API, and may use it to track the fulfillment status of their orders.
If you are a ZFS partner, we recommend focusing on the following sections:
ZFS partners with an Intra Community Trade (ICT) license may need to know where sold items were originally located. For example, they may wish to know from which Zalando Warehouse they shipped. These partners should get the unique stock location identifier from the
source_stock_location_id field at the order line level.
It is important to note that until the top-level order status is set to
fulfilled, the source stock location ID may change (or be empty) as we process the order and prepare for shipment. Once the order ships, this field will not change for any reason.
We strongly recommend re-checking for updates until the order is marked as
fulfilled, and then noting the source stock location ID.
Note also that, if the order line is cancelled for any reason (payment rejection, no stock available) the
source_stock_location_id field will not be exposed, since no Warehouse was selected for that order line.
Please note that source_stock_location_id field should not be confused with stock_location_id. stock_location_id: Last warehouse location from where the order has been shipped. The stock_location_id of an order is not available when the order is created. It is decided by subsequent processes internal to Zalando and would be updated when the order is approved and ready for shipment. This is an order level information, for ICT please refer to source_stock_location_id at order line level.
For additional information on these instructions and terms, see:
- Orders API Reference: Information on scopes, rate limiting, sandbox testing, and an OpenAPI reference for the Orders API.