Zalando Return Solutions

Zalando Return Solutions (ZRS) Pure is a return service for Zalando’s Partner Program partners. Zalando handles partner returns, while partners benefit from reduced costs and the customers enjoy a frictionless shopping experience. ZRS Pure service is available to partners using self-fulfilment (own logistics) or combined with Zalando Shipping Solution (ZSS) for outbound to customer.

Please note: If you are also going live with Zalando Shipping Solutions (ZSS) for outbound shipment service to customers in combination with Zalando Return Solutions (ZRS) Pure as return service, then please only refer to this page for enablement guidance.

The below description is only valid for enablement of own logistics (outbound) and ZRS Pure (returns) setup.

ZRS Pure

  1. The customer can return your articles together with other Zalando articles in one single box
  2. All returned articles are sent to one of Zalando’s return centres, where articles are received, inspected, and the customer reimbursement is triggered
  3. Zalando consolidates the received returns and ships them to your warehouse

The ZRS Pure process for orders requires REST calls to the following zDirect APIs:

ZRS Pure orders belong to the order type PartnerFulfilled. Throughout the order life cycle the status of an order item can change to shipped, returned or cancelled.

Best practice for updating a ZRS Pure order to “shipped”

  1. Get the orders from the Orders API as described here.
  2. Once the orders are shown with the approved status, add the order number you are using in your system to the Zalando order as described here.
  3. Generate and download the ZRS Pure shipping documents by calling the Shipping Documents API as described here.
  4. Update the tracking information via the Orders API as described here. The tracking IDs need to be mapped as followed:
    • Copy the value of tracking_id from the RETURN_LABEL found in the ZRS shipping document to update return_tracking_number in the order.
  5. Update all the products you are going to ship by setting their status to shipped in the Orders API as described here.

Best practice updating a ZRS Pure order to “returned”

Partners do not need to provide an update to Orders API as Zalando will set the status to returned. There’s no precise call to query the Orders API for ZRS Pure returns. However, it is possible to keep track of returned items in two steps:

  1. Retrieving fulfilled orders from the Orders API with

GET merchants/{merchant_ID}/orders?include=order_items,order_lines&order_status=fulfilled&exported=true&order_type=PartnerFulfilled&page_number=0&page_size=1000&last_updated_after=[YYYY]-[MM]-[DD]T[hh]:[mm]:[ss]Z
2. Filtering out returns by parsing through the order item lines having the status returned.

Best practice updating a ZRS Pure order line to “cancelled”

  1. Get the orders from the Orders API as described here.
  2. Optional step: If any order lines are to be shipped, perform step 2 from Best practice for updating an order to “shipped” for those items.
  3. Update all the products you are going to cancel by setting their status to canceled in the Orders API as described here.

Note: It’s not possible to cancel ZRS Pure shipping documents. In case you cancelled all products/lines of an order but generated the ZRS Pure documents by accident, simply discard them. Zalando will not charge you as long as you don’t use them.



Currently ZRS Pure is only available in some selected markets. Please refer to the table below for the latest updates:

Country/Region Status
Spain (es) LIVE
Denmark (dk) LIVE
Sweden (se) LIVE
Finland (fi) LIVE


For more information on the stages of integration, see Stages of Integration in the Getting Started Guide.

Contact Support