Skip to content
Zalando

Zalando Integration: Connect Your ERP to Zalando (zDirect)

How to connect your ERP to the Zalando Partner Program: zDirect API vs integrators like Tradebyte, product, stock, order and returns flows, step by step.

Written by
Md AshikSenior Software Engineer, Artisan Dojo
Published
Reading time
7 min read
Quick summary30-second read
  • Join the Zalando Partner Program and connect via zDirect, either through an approved integrator like Tradebyte or a Direct Integration against the zDirect API.
  • Direct Integration requires passing Zalando's assessment, and Zalando expects roughly two REST API developers to build and maintain it.
  • Your fulfillment model changes the work: with Zalando Fulfillment Solutions you cannot set stock via the Stocks API and send shipping notices instead.
  • Give every size variant a valid, unique EAN, since missing or duplicate EANs block onboarding more than any other issue.
  • Design returns as carefully as orders, because Zalando says about half of all ordered items are returned on average.

To sell on Zalando as a brand or retailer, you join the Zalando Partner Program and connect your systems to zDirect, Zalando's partner platform and API. You can integrate in three ways: through an approved integrator such as Tradebyte, by building a Direct Integration against the zDirect API, or, if Zalando handles your fulfillment, partly through the zDirect web interface. Whichever route you pick, your ERP should stay the source of truth for products, prices and stock, and the integration has to handle orders, shipping and a high volume of returns.

This guide explains each route, what data moves between Zalando and your ERP, and how a typical project runs.

What is the Zalando Partner Program and zDirect?

The Zalando Partner Program lets brands and retailers sell their own stock on Zalando's fashion stores, instead of selling wholesale to Zalando. You keep control of your assortment and prices, and Zalando handles the storefront and customer.

zDirect is the technical side of the program. It includes:

  • The zDirect Platform, where your products, offers and orders live on Zalando's side.
  • The zDirect Portal, where you create API apps, manage access and invite technical partners.
  • The zDirect API, a REST API that covers products, prices, stock, orders, fulfillment and returns. It uses OAuth 2.0 access tokens and has separate sandbox and production environments.

Onboarding starts with an invitation to zDirect. From there, you activate your account, submit compliance and legal details, configure each country you sell in (contacts, carriers, VAT), connect a technical partner if you use one, and provide article master data.

If you sell from physical stores through Zalando's Connected Retail program, note that Zalando has announced it is folding Connected Retail into zDirect. Plan any new integration work around zDirect.

What are the ways to integrate with Zalando?

Zalando's Partner University describes three integration options:

RouteWho builds itBest fit
Approved third-party integratorAn integrator such as Tradebyte or ChannelEngineBrands that want a ready connector and also sell on other marketplaces
Direct Integration (DI)Your own team or a contractor, against the zDirect APIPartners with custom ERP logic or high volume who want full control
zDirect user interfaceNobody; manual work in the browserOnly for partners using Zalando Fulfillment Solutions, with small assortments

A few details matter here:

  • Tradebyte is Zalando's preferred integrator. It has been part of the Zalando Group since 2016 and connects to Zalando's channels and fulfillment services. ChannelEngine and other multichannel platforms are also approved; you connect them by adding them as a technical partner in zDirect. Check Zalando's current list before choosing, as it changes.
  • Direct Integration needs Zalando's approval. Zalando runs a Direct Integration assessment and expects your team to build, maintain and troubleshoot the connection independently. Its own guidance mentions roughly two REST API developers, plus a project manager and tester for larger projects.
  • The zDirect UI is limited. Zalando positions it for ZFS partners with around 200 articles per season. It is not a long-term answer for a growing catalog.

An integrator still needs to be connected to your ERP. Tradebyte or ChannelEngine handles the Zalando side, but someone has to map your ERP's items, stock and orders to the integrator, and that is often where projects get stuck.

Partner fulfillment or Zalando Fulfillment Solutions?

Your logistics model changes the integration as much as the route does.

  • Partner fulfillment: you ship orders from your own warehouse or 3PL. Your integration sends stock through the Stocks API, imports orders, sends shipping information and marks each order line as shipped, canceled or returned.
  • Zalando Fulfillment Solutions (ZFS): you send inventory to Zalando's warehouses and Zalando ships to customers. You cannot update stock through the Stocks API. Instead you create shipping notices for inbound stock, track stock movements, and read order statuses that Zalando sets.

Zalando also offers related services such as Zalando Return Solutions (ZRS) and Zalando Shipping Solutions (ZSS), which have their own APIs for returned items and shipping documents. Decide early which of these you use, because each one changes which data your ERP sends and which it receives.

What data flows between Zalando and your ERP?

  • Products (articles): Zalando matches products by EAN against its catalog. Existing products are mapped; new ones are submitted with the attributes required for their product type. Sizes, colors, materials and images all have to meet Zalando's requirements.
  • Prices: set per sales channel (country), including promotional prices. Zalando validates prices and can reject them, so you need to read the validation results.
  • Stock: quantities per article for partner fulfillment, or inbound shipments and stock positions for ZFS.
  • Orders: imported into your ERP, with status updates sent back per order line.
  • Shipping: carrier and tracking information for each shipped order, or shipping documents if you use Zalando's shipping services.
  • Returns: returned order lines flowing back into the ERP to restock items, issue credit notes and keep accounting correct.

Top tip

Returns are not an edge case on Zalando. The company states that on average about half of all items ordered across its markets are returned. Design the returns flow with the same care as the order flow, and test it before go-live.

How to connect your ERP to Zalando, step by step

Step 1: Choose the route and fulfillment model

Decide between an integrator and Direct Integration, and between partner fulfillment and ZFS. If you are already on Amazon, Kaufland or eBay, consider how Zalando fits into the stock logic you already have, rather than building a separate silo.

Step 2: Get zDirect access

Accept the zDirect invitation, complete the account and market setup, and create API credentials in the zDirect Portal. If an integrator or agency builds the connection, invite them as a technical partner. Start in the sandbox environment.

Step 3: Prepare and map article data

This is usually the longest step. For each product:

  • Check that every size variant has a valid, unique EAN.
  • Look up whether the EAN already exists in Zalando's catalog and map it if so.
  • For new products, fetch the required attributes for the product type and map your ERP or PIM fields to them, including Zalando's size charts.
  • Submit products and follow their status in the Product Status Report. Fix rejections and resubmit.

Step 4: Sync prices and stock

Push prices per sales channel and stock from your ERP. Send changes frequently and run a full reconciliation on a schedule. Zalando holds price and stock updates sent before a product is onboarded and applies them later, so you can start syncing early.

Step 5: Import orders and send shipping updates

Fetch new orders, create them in your ERP using Zalando's order and order line IDs as unique keys, and send shipping information back when the parcel leaves your warehouse. Mark each line as shipped or canceled; do not leave lines open.

Step 6: Handle returns

Bring returned lines back into the ERP, update stock once items are checked, and trigger refunds or credit notes. Make sure returns of partially shipped orders and exchanges are covered.

Step 7: Test, go live and monitor

Run test orders, including cancellations and returns. Before go-live, Zalando reviews partners against its Customer Experience Model (CXM) KPIs, so late shipments and cancellations matter from day one. After launch, monitor order flow, rejected products and rejected prices daily.

Common mistakes in Zalando integrations

  • Treating EANs as optional. Missing or duplicate EANs per size block onboarding more than any other issue.
  • Ignoring price rejections. A price Zalando rejects means the article does not sell at the price you expect, or at all. Read the validation results.
  • Building returns last. With return volumes this high, a manual returns process quickly falls behind and stock in the ERP becomes wrong.
  • Overselling across channels. If the same stock is sold on your own shop and other marketplaces, use buffers and fast stock updates, as described in our marketplace ERP integration checklist.
  • Assuming the integrator covers the ERP side. A connector solves Zalando's side. The mapping to your ERP still has to be built and maintained.
  • Not planning for API changes. Zalando updates its APIs and article requirements. An integration without an owner will eventually break.

FAQ

Do I need an integrator to sell on Zalando?

No. You can build a Direct Integration against the zDirect API, but Zalando has to approve it through its Direct Integration assessment. Many partners use an approved integrator such as Tradebyte instead.

What is the difference between zDirect and the Zalando Partner Program?

The Partner Program is the commercial model: you sell your own stock on Zalando. zDirect is the platform, portal and API you use to run that business technically.

Can I connect Zalando directly to my ERP?

Yes, either with a Direct Integration from your ERP to the zDirect API, or by connecting your ERP to an integrator that handles Zalando. The right choice depends on your ERP, your other channels and how much custom logic you need.

How are stock updates different with ZFS?

With Zalando Fulfillment Solutions, Zalando holds your stock, so you cannot set quantities through the Stocks API. You announce inbound shipments with shipping notices and read stock and order data from Zalando instead.

How long does a Zalando integration take?

It depends mostly on the state of your product data. Clean EANs and attributes shorten the project considerably; incomplete article data is the usual cause of delays.

Need help connecting Zalando to your ERP?

We build and maintain Zalando integrations, both direct zDirect API connections and the ERP side of integrator setups, alongside existing Amazon, Kaufland and eBay channels. See our Zalando integration service and marketplace ERP integration service, or describe your setup below and you will get a reply from the engineer who would build it.

Need help with this?

Describe your project. Get a reply from an engineer.

Which marketplaces or platforms are involved?
What do you need?
How should we get back to you?

We use your details only to reply to this inquiry. See our privacy policy.

Keep reading

Related guides

All guides
MessageFree 30-min call