API Zalando dla partnerów - kiedy warto je wdrożyć zamiast integratora

Co można zrobić przez API Zalando

Dokumentacja zDirect API dzieli interfejsy na kilka grup. Dla marki planującej własną integrację najważniejsze są te, które obsługują codzienną sprzedaż (stan na sierpień 2026 - sprawdź aktualną dokumentację Zalando):

[#chart:zal38b]

• Produkty - Products, Product Attributes, Product Submissions i raport Product Status Report (PSR), w którym widać status przesłanych artykułów. Zalando weryfikuje zgłoszenia w trzyetapowym procesie walidacji.

• Oferty - Prices, Price Reporting, Stocks i blokowanie dostępności artykułów. Ceny przechodzą walidację, a odrzucone trzeba poprawić przed startem.

• Zamówienia - pobieranie zamówień, pozycji, wysyłek i historii zmian statusów oraz aktualizacja statusów pozycji.

• ZFS i usługi logistyczne - zgłoszenia dostaw, ruchy magazynowe, dokumenty wysyłkowe i zwrotne dla usług ZSS i ZRS.

• Dane - Direct Data Sharing, czyli zbiory danych m.in. o wynikach produktów, szacowanych zwrotach i kampaniach ZMS.

Stany i zamówienia przez API - jak to działa

Stany przy własnej logistyce wysyła się przez Stocks API: dla każdego EAN i kanału sprzedaży podaje się dostępną ilość, a jedno zapytanie może objąć wiele pozycji. Dokumentacja zaleca wysyłać aktualizację przy każdym nowym zamówieniu, anulacji i zmianie stanu, zawsze dla wszystkich kanałów sprzedaży. Odpowiedź zwraca status każdej pozycji osobno, więc integracja musi sprawdzać, które aktualizacje zostały odrzucone. Partnerzy ZFS nie ustawiają stanów w ten sposób - korzystają ze zgłoszeń dostaw.

Zamówienie ma status ustawiany przez Zalando (initial, approved, fulfilled), a jego pozycje - statusy ustawiane przez partnera (m.in. reserved, shipped, canceled, returned). Realizację zaczyna się dopiero po zmianie statusu na approved, czyli po potwierdzeniu płatności. Terminy reakcji wynikają z Platform Rules: anulację trzeba zgłosić w ciągu 72 godzin, a potwierdzenie wysyłki z numerami śledzenia w ciągu 12 godzin od nadania. Jak te procesy wyglądają przy magazynie Zalando, opisujemy w artykule Zalando Fulfillment Solutions - jak działa ZFS dla marek i sklepów z Polski.

Ceny przez API - walidacja po stronie Zalando

Ceny przesyła się osobno dla każdego rynku i w walucie tego rynku. Zalando sprawdza każdą aktualizację: odrzuca m.in. obniżki poniżej minimalnych 10%, oczywiste błędy, takie jak obniżka powyżej 80% czy zła waluta, oraz próbę podniesienia ceny regularnej razem z ustawieniem promocji. Przy własnej integracji to Twój zespół musi odczytywać wyniki walidacji i reagować na odrzucenia, bo inaczej artykuł zostanie z nieaktualną ceną albo bez ceny promocyjnej w trakcie akcji (stan na sierpień 2026 - sprawdź aktualną dokumentację Zalando i Platform Rules).

Warto też pamiętać, że aktualizacja ceny nie jest natychmiastowa. Zalando informuje, że zmiana może potrzebować do 60 minut, a w okresach dużego obciążenia dłużej, więc ceny na akcje sprzedażowe lepiej wysyłać z wyprzedzeniem i z harmonogramem.

Direct Data Sharing - dane o wynikach bez ręcznych raportów

Osobną część dokumentacji stanowi Direct Data Sharing, czyli udostępnianie zbiorów danych bezpośrednio partnerowi. Dokumentacja opisuje m.in. zbiory o dziennych wynikach produktów, szacowanym odsetku zwrotów, zwrotach w drodze, kampaniach ZMS na poziomie kampanii i SKU oraz dzienny stan zapasów w ZFS. Dla marki, która ma własną hurtownię danych lub narzędzie BI, to sposób na łączenie danych z Zalando z danymi z innych kanałów bez ręcznego pobierania raportów z zDirect. Dostęp do tych danych ma własne zasady, w tym rotację danych dostępowych i politykę wersjonowania, więc warto je przeczytać przed planowaniem raportowania (stan na sierpień 2026 - sprawdź aktualną dokumentację Zalando).

Jak wygląda wdrożenie API Zalando krok po kroku

Dostęp do API zaczyna się od portalu zDirect. Programista dostaje dostęp, gdy firma zaprosi go do pracy w swoim imieniu. W portalu tworzy się aplikację, która działa jak klient OAuth: otrzymuje identyfikator i sekret klienta oraz uprawnienia (scopes). Uwierzytelnianie odbywa się w standardzie OAuth 2.0 w przepływie client credentials, a token dostępu przesyła się w nagłówku każdego zapytania (stan na sierpień 2026 - sprawdź aktualną dokumentację Zalando).

[#chart:zal38c]

Nowe aplikacje działają domyślnie w trybie sandbox, czyli w środowisku testowym pod adresem api-sandbox.merchants.zalando.com. Sandbox odpowiada możliwie podobnie do produkcji, ale dane zapisywane w większości interfejsów nie są utrwalane, a niektóre odpowiedzi różnią się od produkcyjnych. Produkcja (api.merchants.zalando.com) jest dostępna dopiero po etapie Go Live, a po przełączeniu aplikacji trzeba pobrać nowy token.

Limity zapytań i obsługa błędów

Każde API ma własne limity zapytań opisane w dokumentacji - na przykład Product Attributes API pozwala na 1 000 zapytań na minutę, a Product Submissions API na 25 wywołań na sekundę. Po przekroczeniu limitu API zwraca kod 429 z nagłówkiem Retry-After, który mówi, ile sekund odczekać. Integracja musi to obsługiwać, a przy dużych aktualizacjach rozkładać zapytania w czasie (stan na sierpień 2026 - sprawdź aktualną dokumentację Zalando).

[#uwaga] Przełączenie działającej aplikacji z produkcji z powrotem na sandbox odcina ją od danych produkcyjnych i może przerwać bieżące procesy, np. pobieranie zamówień. Testy nowych funkcji prowadź na osobnej aplikacji.

Bezpieczeństwo danych dostępowych

Identyfikator i sekret klienta dają dostęp do danych sprzedaży, zamówień i klientów, dlatego dokumentacja zaleca przechowywać je bezpiecznie. W praktyce oznacza to sejf na hasła lub menedżer sekretów zamiast plików konfiguracyjnych w repozytorium, osobne aplikacje dla środowiska testowego i produkcyjnego oraz jasną listę osób, które mają dostęp do portalu zDirect. Każdy token warto używać do jego wygaśnięcia i pobierać nowy na podstawie czasu ważności zwracanego przez API, zamiast przy każdym zapytaniu. Dokumentacja zDirect ma też osobną część o zgodności z RODO, którą zespół powinien przeczytać przed pracą z danymi zamówień.

Najczęstsze błędy przy własnej integracji z API Zalando

Własne API daje kontrolę, ale też przenosi na markę wszystkie błędy, które przy integratorze rozwiązuje dostawca. Najczęściej spotykamy:

• Wysyłanie stanów tylko dla jednego kanału sprzedaży zamiast dla wszystkich, co zostawia nieaktualne ilości na części rynków.

• Brak sprawdzania statusu każdej pozycji w odpowiedzi, przez co odrzucone aktualizacje stanów lub cen giną bez śladu.

• Rozpoczynanie realizacji zamówienia w statusie initial, zanim Zalando potwierdzi płatność.

• Potwierdzenia wysyłki bez numeru śledzenia zwrotu, które obniżają wskaźnik poprawności potwierdzeń.

• Ignorowanie kodu 429 i ponawianie zapytań bez przerwy, co prowadzi do kolejnych ograniczeń.

• Brak monitoringu - integracja przestaje działać w nocy, a zespół dowiaduje się o tym z anulacji.

Ile kosztuje własne API Zalando

Po stronie Zalando Direct Integration nie wiąże się z opłatami licencyjnymi ani wdrożeniowymi. Realny koszt to praca zespołu: Zalando szacuje, że do budowy potrzeba około dwóch programistów REST API, a przy dużych projektach także kierownika projektu integracji i testera. Do tego dochodzi utrzymanie po starcie - zmiany w API, nowe wymagania danych, obsługa błędów i dyżur w szczycie sezonu (stan na sierpień 2026 - sprawdź aktualne zasady Zalando Partner Program).

Integrator ma z kolei własny cennik, który marka negocjuje sama. Porównując oba warianty, licz koszt w kilkuletnim horyzoncie: abonament i opłaty integratora kontra czas programistów przy budowie i utrzymaniu. Własne API zaczyna się opłacać dopiero wtedy, gdy marka i tak ma zespół IT, który rozwija jej system sprzedaży.

Uwzględnij też koszt ryzyka. Gdy integracja przestaje działać, zamówienia nie są potwierdzane, a stany przestają się aktualizować. Przy integratorze problem rozwiązuje dostawca w ramach umowy, przy własnym API - Twój zespół, często w weekend albo w szczycie sezonu. Dlatego w kalkulacji warto przewidzieć dyżury, monitoring i czas na aktualizacje po zmianach w dokumentacji Zalando.

Kiedy wdrożyć API Zalando - sygnały dla marki

1. Masz własny system sprzedaży lub ERP i zespół, który go rozwija na co dzień.

2. Integrator nie obsługuje procesów, których potrzebujesz, np. specyficznych reguł stanów albo raportowania.

3. Chcesz pobierać dane o wynikach i zwrotach bezpośrednio do własnej hurtowni danych.

4. Sprzedajesz na wielu rynkach Zalando i każda minuta opóźnienia w stanach przekłada się na anulacje.

5. Jesteś gotów przejść ocenę Direct Integration i utrzymywać połączenie samodzielnie.

Jeśli dopiero zaczynasz i masz niewielką kolekcję, własne API zwykle nie jest pierwszym krokiem. Zalando dopuszcza podłączenie API także po rozpoczęciu sprzedaży, więc start przez integratora albo panel zDirect nie zamyka tej drogi. O realiach startu małej marki piszemy w artykule Zalando dla małej marki - jak zacząć sprzedaż bez dużego budżetu.

Jak Vinson pomaga wybrać między API Zalando a integratorem

Jesteśmy agencją e-commerce z Bochni, działającą od 2021 roku. Współpracowaliśmy z ponad 500 firmami, mamy status Allegro Ads Partner+, Google Partner i Meta Business Partner, jesteśmy certyfikowanym partnerem Base, partnerem Empik Place i autoryzowanym partnerem Shoper, a klienci oceniają nas na 4,9/5 ze 171 opinii.

• Porównanie kosztów i możliwości integratora oraz własnego API dla Twojej skali.

• Przygotowanie danych produktowych, mapowania i procesów zamówień przed integracją.

• Kontrola stanów, cen i potwierdzeń wysyłki po starcie.

Decyzję o integracji i umowy z dostawcami marka podejmuje sama, a my pomagamy ją dobrze przygotować. Więcej na stronie sprzedaż na Zalando z Vinson.

Najczęściej zadawane pytania

Czy Zalando udostępnia API dla sprzedawców?

Tak. zDirect API to interfejs REST dla partnerów Zalando, opisany na developers.merchants.zalando.com. Obejmuje produkty, ceny, stany, zamówienia, wysyłki, zwroty i procesy ZFS. Dostęp wymaga konta w portalu zDirect.

Czy API Zalando jest płatne?

Zalando nie pobiera opłat licencyjnych ani wdrożeniowych za Direct Integration. Kosztem jest praca zespołu programistów przy budowie i utrzymaniu połączenia, a sama integracja wymaga wcześniejszej akceptacji Zalando (stan na sierpień 2026 - sprawdź aktualne zasady Zalando Partner Program).

Jak uzyskać dostęp do API Zalando?

Programista dostaje dostęp do portalu zDirect na zaproszenie firmy, tworzy w nim aplikację i otrzymuje identyfikator oraz sekret klienta. Token dostępu pobiera się w standardzie OAuth 2.0, a nowe aplikacje działają najpierw w środowisku testowym sandbox.

Czy można przejść z integratora na własne API Zalando?

Tak, Zalando opisuje w Partner University zmianę sposobu integracji, także na połączenie bezpośrednie. Wymaga to jednak akceptacji w ocenie Direct Integration, przygotowania i testów, więc zmianę warto zaplanować poza szczytem sezonu.

Ilu programistów potrzeba do integracji z API Zalando?

Zalando szacuje, że do budowy i uruchomienia Direct Integration potrzeba około dwóch programistów REST API, a przy dużych projektach także kierownika projektu i testera. Zespół musi też utrzymywać integrację po starcie.

Zastanawiasz się, czy własne API Zalando ma sens w Twojej firmie? Zobacz, jak wspieramy sprzedaż na Zalando z Vinson - pomożemy policzyć oba warianty i przygotować dane do integracji.