Get live with Zalando Shipping Solutions
The integration steps for Zalando Shipping Solutions, for new and existing partners.
You’re reading this because you're ready to start using Zalando Shipping Solutions (ZSS) our quick and reliable logistics service.
Successfully onboarding with ZSS involves four key stages. You must complete each step before moving on to the next one.
Prerequisites and requirements
Technical integration
Physical testing
Go live
You’ll find the answers to some FAQs at the end of this article.
Prerequisites and requirements
Before kicking off your ZSS integration, you'll need to secure the necessary agreements and select your integration path:
Signed contract: You'll need a signed ZSS contract for each market you want to go live in. If you haven't signed your contract yet, reach out to our Sales team at logisticssolutions@zalando.de.
Integration solution: You need to decide on your integration solution. You can integrate via a third-party provider, like our preferred integrator Tradebyte, or via direct integration to our API.
New partners: Our Sales team can help you find the most suitable way to combine our logistics solutions.
Existing partners: If you're an existing Partner Program partner, we can help you expand into new markets. To find out more please reach out to Partner Care via our support form. Select the Topic: ZEOS Logistics and Shipping Solutions, and then Request type: Outbound Shipment.
Step 1: Technical integration
After you’ve met the prerequisites, follow the steps for your chosen integration solution.
If you're using Direct Integration to our APIs
Integrate the Orders API as outlined in the developer documentation.
Complete technical integration with the ZSS Connect API. You'll receive all your shipping documents through this API.
Once the Sandbox test is successful,. Share the required shipping documents: (1) outbound label, (2) return label and (3) delivery slip.to your Onboarding manager
If you're using an Integrator
Complete the same steps (1, 2 and 3) as the Direct Integration partners above.
Inform your Integrator that you've completed these steps.
If you've chosen Tradebyte, open a ticket via the Tradebyte Community ticketing system. You can also check the Tradebyte fact sheet and manual for further information.
If you have any questions regarding the Tradebyte process please contact support@Tradebyte.com.
If you have any questions or need assistance with this step, please contact your onboarding manager.
Once step 2 is completed, you can move on to step 3.
Important
For Partner Program partners who are already live on Zalando and wish to change their logistics solution to ZSS, please skip step 3 and continue directly with step 4.
Step 2: Physical testing
The physical test is the final stage before going live. Here, we'll check the end-to-end flow, including inbound, outbound and returns, using a real order from the Fashion Store (non-Sandbox).
a. Preparing the test order
Provide two articles (SKUs) for physical testing to your onboarding-manager.
Your onboarding-manager will whitelist the specific articles for testing.
You'll receive the test customer data from the Partner onboarding team.
Place a test order and submit the order details to the Partner onboarding team.
b. Shipping the test order
Prepare the parcel. Include the test article, delivery documents and return label.
Paste the last-mile carrier’s outbound label on the parcel.
Place this parcel into a larger master-box. Please ensure that you follow the detailed guidelines for the Zalando Shipping Solutions: Outbound process.
Attach the ZSS shipping label to the sealed master-box based on the selected first-mile hub. You can download the relevant label below.
Send the master-parcel to one of our injection hubs (Hamburg, Lahr, or Verona) through your own carrier.
Update the ZSS order status to Shipped via the Orders API in zDirect or through your integrator.
The test order flow is divided into first mile and last-mile delivery:
First-mile delivery: You send the master-parcel to our injection node.
Last-mile delivery: In the injection node, the test orders are scanned, sorted, and handed over to the respective carriers. You can track the delivery through your Integrator or Direct API using the shipping ID from Zalando.
Quality Assurance (QA): The test customer sends photos of the label and documents to the Zalando QA team, who then provides feedback directly to you.
Parcel returns: The returns flow is automatically tested after outbound delivery. Depending on the return method you've enabled, the respective party will trigger the refund and forward the return parcels.
Step 3: Go live
After successfully completing the physical test and receiving Quality Assurance approval, you'll need to complete a few final steps:
Check that all articles in your assortment are onboarded.
Confirm the stock levels are correct.
Set and confirm article prices.
Connect to the Price Validation API (for Direct Integration partners).
You'll receive an email notification from an Onboarding manager when you’re live on Zalando and ready to start selling!
FAQs - Troubleshooting
1. How will I know that an article/parcel has been returned?
The item (also known as article) status is updated in the system and reflected in the Orders API. When you call the Orders API for that particular order/article, you’ll see it as returned.
2. Which file type is the settlement file?
The settlement file type should be CSV.
3. What is the file name standard of the settlement files?
An example name of the file name would be: Itemized_Stmnt_SAL_PP_JUL_2019_xxxxxx_FR.csv.
4. Should the market/country also be a column in the file?
The market/country should only be in the file name and not a comment in the file.
If you have any questions regarding the integration process please reach out directly to your support contact from their team.
Need support?
If you have any questions or need assistance at any point, you can contact:
Your onboarding-manager (for integration-specific questions).
Integration Support at support-integration@zalando.de (for technical issues before go-live).
If you wish to make any changes to your operations or integrations after going live, please reach out to our Partner Care team via our support form. Select the Topic: ZEOS Logistics and Shipping Solutions, and then Request type: Outbound Shipment.




