Elbuz łączy się z kontem partnera Zalando (zDirect, 15 krajów UE) kluczami aplikacji: pobiera Twoje produkty z cenami i stanami po EAN, odbiera zamówienia i odsyła na marketplace ceny oraz stany osobno dla każdego kraju sprzedaży.
Kiedy to się przyda:
- Sprzedajesz na Zalando i w innych kanałach — stany i zamówienia wszystkich kanałów w jednym katalogu.
- Kilka krajów Zalando — jeden szablon aktualizuje cenę i stan we wszystkich.
- Produkt jest już sprzedawany na Zalando — Elbuz doda Twoją ofertę do gotowej karty po EAN.
- Jesteś producentem — Elbuz wyśle nową kartę do weryfikacji według przypisanej sylwetki.
Od czego zacząć: zdobądź Client ID i Client secret aplikacji zDirect i wklej je do szablonu typu „Zalando”.
Co potrafi integracja z Zalando
- Połączenie dwoma kluczami aplikacji — bez kodu powiązania i bez bramy Elbuz.
- Import katalogu — cena, stan i status każdego dla pierwszego kraju szablonu.
- Zamówienia — historia przy pierwszym uruchomieniu, potem tylko zmiany.
- Ceny i stany z powrotem na Zalando — do każdego wskazanego kraju, w walucie tego kraju.
- Publikacja — oferta do gotowej karty po EAN albo nowa karta do weryfikacji Zalando.
Czego potrzebujesz od Zalando
Zalando przyjmuje sprzedawców tylko na własne zaproszenie. Najpierw przechodzisz kwalifikację do programu partnerskiego Zalando i podpisujesz umowę partnera — dopiero wtedy otwiera się dostęp do zDirect Partner Portal i jego API.
Klucze wydaje aplikacja utworzona w zDirect Partner Portal:
- Sprzedawca zaprasza w zDirect swojego partnera technicznego.
- Partner techniczny tworzy aplikację API właśnie dla tego sprzedawcy. Jedno konto aplikacji obsługuje jednego sprzedawcę.
- Portal pokazuje dwie części klucza — Client ID i Client secret. Wkleja się je do szablonu Elbuz.
1
Client ID2
Client secret3
Kraje sprzedaży4
Merchant ID- Client ID — publiczna część kluczy aplikacji zDirect.
- Client secret — część tajna; przechowywana ukryta.
- Kraje sprzedaży — kody krajów po przecinku; pierwszy daje cenę i stan katalogu.
- Merchant ID — potrzebny tylko wtedy, gdy klucze obsługują kilku sprzedawców.
| Pole w szablonie | Co to jest |
|---|---|
| Client ID | Publiczna część klucza aplikacji. Obowiązkowe |
| Client secret | Tajna część klucza. Obowiązkowe |
| Kraje sprzedaży: kody po przecinku (de,at,pl…) | Dwuliterowe kody krajów. Pierwszy kraj jest źródłem ceny i stanu przy imporcie katalogu. Puste pole oznacza de |
| Merchant ID (opcjonalnie — zostanie ustalony na podstawie kluczy) | Kod sprzedawcy Zalando. Wypełnij tylko wtedy, gdy klucze obsługują kilku sprzedawców — w przeciwnym razie Elbuz ustali go sam |
Po wklejeniu kluczy kliknij „Sprawdź połączenie”. Elbuz zapyta Zalando, do kogo należą klucze, i odpowie wierszem „Zalando” z kodami krajów i Merchant ID. Tak widać, że klucze skopiowano w całości.
„Aktywny” i „Zamówienia” są w nowym szablonie już włączone: 5 minut po zapisaniu kluczy Elbuz zacznie pobierać wszystkie zamówienia, które przechowuje Zalando. Statusy marketplace’u Elbuz sam dopasowuje do Twoich według nazwy; co przyszło i jak dopasowano, widać w oknie „Statusy zamówienia” szablonu. Jeśli chcesz najpierw to sprawdzić, odznacz „Zamówienia”.
Dokumentacja Zalando dla partnerów (po angielsku): autoryzacja zDirect API, limity zapytań.
Co przychodzi z katalogu Zalando
Zalando udostępnia przez API tylko dane liczbowe oferty: EAN, cenę, stan i status. Nazwy, opisu, marki, zdjęć ani atrybutów w odpowiedzi nie ma. Dlatego każdy EAN staje się osobnym produktem Elbuz w takiej postaci:
| Dane Zalando | Pole produktu w Elbuz |
|---|---|
| EAN rozmiaru | Kod kreskowy i kod produktu |
| — | Nazwa „Zalando ‹EAN›” |
| cena w pierwszym kraju szablonu | Cena |
| stan w pierwszym kraju | Ilość |
| oferta online lub stan większy od zera | Status: produkt włączony |
| — | Kategoria „Zalando” |
Pole wyboru „Zdjęcia” nie wpływa na import z Zalando: tym kanałem marketplace nie wysyła zdjęć. Nazwy, opisy i zdjęcia uzupełnij w Elbuz sam lub pobierz z cennika dostawcy.
1
Produkty2
Zamówienia- Produkty — katalog: ceny, stany i statusy po EAN.
- Zamówienia — zamówienia Zalando są pobierane automatycznie.
Co zmienia ponowny przebieg
W produkcie, który już jest w katalogu, przebieg aktualizuje tylko cenę, ilość i status. Nazwy, opisu, kategorii, zdjęć i pozostałych pól nie zmienia — nawet jeśli nazwa to wciąż „Zalando ‹EAN›”. Możesz więc zmienić nazwę karty, a przebieg jej nie przywróci.
Swoją kartę przebieg znajduje po powiązaniu z EAN, które ustawił pierwszy import lub publikacja z Elbuz. Przed pozostałymi aktualizacjami chronią przełączniki w karcie produktu, sekcja „Ochrona podczas importu”:
- „Nie aktualizuj” — przebieg Zalando w ogóle nie zmienia karty;
- „Stała cena” — przebieg nie nadpisuje ceny, ale aktualizuje ilość i status.
Karty dodanej z cennika dostawcy lub ręcznie import katalogu Zalando nie rozpozna: nie ma ona jeszcze powiązania z EAN. Przebieg założy drugą kartę „Zalando ‹EAN›”. Jeśli prowadzisz katalog w Elbuz, nie włączaj „Produkty” — powiąż produkty eksportem (scenariusz).
Produktu, który zniknął z Zalando, przebieg nie wyłącza ani nie usuwa: pozycja zostaje z ostatnią ceną i stanem. Zasady ogólne: produkt zniknął ze źródła.
Jak przychodzą zamówienia
Każde zamówienie Zalando trafia do Elbuz jako dokument „Zamówienie klienta” z numerem zamówienia. Do dokumentu trafiają:
- numer, data utworzenia i data zmiany, kod statusu Zalando;
- imię i nazwisko odbiorcy, e-mail i numer klienta;
- adres dostawy — wiersze adresu, miasto, kod pocztowy, kraj;
- pozycje z ceną i ilością, waluta.
Ilość pozycji to zamówione minus anulowane na Zalando. Telefonu klienta, przewoźnika ani sposobu płatności Zalando nie przekazuje, więc te pola zostają puste.
Pierwszy import przenosi wszystkie zamówienia, które przechowuje Zalando. Później Elbuz bierze tylko to, co zmieniło się od poprzedniego uruchomienia, z zapasem dwunastu godzin. Istniejące zamówienie jest rozpoznawane po numerze i aktualizowane, a nie duplikowane. Jak ponowny przebieg traktuje status, pozycje i zatwierdzony dokument, opisano w artykule o Kaufland — mechanika jest ta sama: ponowny przebieg zamówienia.
Status przychodzi jako kod Zalando, a Elbuz sam dopasowuje go do Twojego według nazwy; doprecyzujesz to przyciskiem „Statusy zamówienia” w karcie „Powiązane ustawienia” formularza szablonu.
1
Statusy zamówienia2
Ustawienia harmonogramu- Statusy zamówienia — dopasowuje kody statusów Zalando do Twoich statusów.
- Ustawienia harmonogramu — określa, jak często uruchamia się import.
Elbuz niczego sam nie potwierdza na Zalando: numer przesyłki i wysyłka nie są przekazywane z powrotem. Wysyłki oznaczaj w zDirect, a Elbuz pobierze nowy status przy następnym przebiegu.
Jak ceny i stany wracają na Zalando
Kierunek powrotny to osobny szablon eksportu typu „Zalando”. Ma te same Client ID i Client secret, a pole „Wersja API (parametry platformy)” określa kraje: de,at. Jeśli klucze obsługują kilku sprzedawców, Merchant ID wpisuje się po kresce pionowej: de,at|twój-merchant-id.
Cenę na Zalando ustawia się osobno dla każdego kraju. Elbuz wysyła cenę i stan produktu do każdego kraju z pola, w paczkach do 1000 pozycji. Walutę określa kraj:
| Kraj | Waluta, w której Zalando odczyta cenę |
|---|---|
| pl | PLN |
| cz | CZK |
| ch | CHF |
| se, dk, no | SEK, DKK, NOK |
| gb, hu, ro | GBP, HUF, RON |
| pozostałe (de, at, fr, nl…) | EUR |
Elbuz wysyła liczbę z szablonu eksportu tak, jak jest. Cena 1200 zł trafi do Zalando Niemcy jako 1200 euro. Jeśli katalog nie jest w euro, ustaw w szablonie eksportu formułę ceny z kursem i swoim narzutem (cena w eksporcie). Kraje z różnymi walutami — różnymi szablonami eksportu.
Eksport aktualizuje tylko produkty powiązane z EAN Zalando. Powiązanie ustawia import katalogu lub publikacja. Pozostałe produkty bez pola wyboru „Publikuj nowe produkty” eksport pomija bez wpisu w dzienniku.
Kod 104 to nie błąd
Podsumowanie przebiegu dziennik pokazuje wierszem „Zalando: ceny i stany wysłane, przyjęto: N, oczekuje na onboarding EAN: K (błędów: M)”. K to produkty z kodem 104: EAN nie przeszedł jeszcze onboardingu na Zalando. Zalando zastosuje cenę, gdy karta zostanie zatwierdzona, a Elbuz nadal będzie ją wysyłał przy każdym przebiegu.
Błędy są liczone tylko dla odrzuconych pozycji. Każda z nich to osobny czerwony wiersz „Zalando: prices — „nazwa” odrzucono, kod …: przyczyna” (dla stanów — „stocks”).
Publikacja produktów na Zalando
Z polem wyboru „Publikuj nowe produkty” w szablonie eksportu Elbuz publikuje produkty, które nie są jeszcze powiązane z Zalando. Każdy potrzebuje kodu kreskowego EAN z co najmniej 8 cyfr. Dalej są dwie drogi:
| Co jest na Zalando | Co robi Elbuz | Wiersz w dzienniku |
|---|---|---|
| Karta z tym EAN już istnieje | Dodaje Twoją ofertę do gotowej karty i od razu wysyła cenę i stan | „Zalando: oferta „…” dodana do karty Zalando (EAN …)” |
| Karty nie ma, sylwetka jest przypisana | Wysyła nową kartę do weryfikacji Zalando | „Zalando: „…” — nową kartę wysłano do weryfikacji Zalando” |
| Karty nie ma, sylwetka nie jest przypisana | Pomija produkt | „Zalando: „…” — na Zalando brak karty z takim EAN, a sylwetka (outline) Zalando dla kategorii nie jest powiązana” |
Nowa karta: sylwetka i co do niej trafia
Sylwetka (outline) to typ produktu w Zalando: sukienka, sneakersy, torba. Przypisuje się ją do Twojej kategorii w oknie „Powiązanie z marketplace'ami”: wybierz przełącznik „Zalando”, kliknij „Pobierz słownik platformy” — pobierze się lista sylwetek Twojego konta — i wypełnij kolumnę „Sylwetka Zalando”. Więcej: dopasowanie kategorii do marketplace’ów.
1
Przełącznik Zalando2
Kolumna „Sylwetka Zalando”- Przełącznik Zalando przełącza kolumny tabeli na ten marketplace.
- Kolumna „Sylwetka Zalando” zawiera sylwetkę, pod którą Elbuz zgłasza nową kartę produktu.
Do nowej karty Elbuz wpisuje nazwę produktu, producenta jako markę, pełny opis i do 12 zdjęć. Ograniczenia nowej karty:
- Bez wariantów. Jeden produkt Elbuz to jedna karta z jednym kolorem i jednym rozmiarem. Rozmiary jednego fasonu staną się osobnymi kartami.
- Obowiązkowe atrybuty sylwetki — tabelę rozmiarów, kod rozmiaru, kolor, sezon, grupę docelową — przypisuje się w oknie dopasowania kategorii. Kolor i sezon są brane według nazwy ze słownika Zalando, tabela rozmiarów i kod rozmiaru — tak, jak je wpisano. Bez obowiązkowego atrybutu karta nie zostanie zgłoszona: „Zalando: „…” (outline …) — niewypełnione obowiązkowe atrybuty: …”. Nieprzypisane atrybuty pokazuje „Gotowość do publikacji”.
- Marka jest dobierana według nazwy producenta w słowniku Zalando. Jeśli takiej marki nie ma, karta nie zostanie zgłoszona, a dziennik wskaże niewypełnioną markę.
Odpowiedź „wysłano” oznacza tylko wstępną weryfikację. Ostateczną decyzję Zalando podejmuje po kilku minutach lub godzinach. Kolejne eksporty same sprawdzają wynik i do czasu zatwierdzenia wysyłają cenę i stan z kodem 104.
Odrzuconą kartę dziennik pokazuje wierszem „Zalando: „…” — Zalando odrzuciło nową kartę: przyczyna”. Taki produkt eksport dalej pomija. Popraw go w Elbuz: po dowolnej zmianie karty produktu następny eksport zgłosi kartę ponownie.
Aktualizacja według harmonogramu
Zalando nie wysyła natychmiastowych powiadomień, więc zamówienia Elbuz pobiera sam co 5 minut, jeśli w szablonie zaznaczono „Zamówienia” i wypełniono klucze. Robi to wspólne zadanie „Zamówienia z marketplace’ów” w oknie „Harmonogram zadań” — tam też zmienia się interwał. Katalog w tym przebiegu nie jest importowany, a zamówienia pobrane także przez harmonogram szablonu się nie dublują.
Katalog aktualizuje harmonogram samego szablonu — przycisk „Ustawienia harmonogramu” w formularzu szablonu. Ustawiaj go rzadko, np. w nocy: dopóki trwa import katalogu, przebieg zamówień jest pomijany do następnego.
Zalando ogranicza częstotliwość zapytań: zamówienia — 40 na minutę, ceny — 30, stany — 60. Po odmowie z powodu limitu Elbuz czeka tyle, ile podał marketplace (do minuty), i ponawia próbę do czterech razy.
Ogólne zasady przerwania i ponowienia: jeśli przebieg został przerwany. Katalog jest zapisywany paczkami po 500 produktów, zamówienia — jednorazowo po odczytaniu wszystkich stron, więc ponowienie jest bezpieczne.
Scenariusze
Sprzedajesz tylko na Zalando i chcesz widzieć stany w Elbuz
Co włączyć. Wypełnij „Client ID”, „Client secret” i „Kraje sprzedaży”, a w karcie „Wybór danych do importu” — „Produkty” i „Zamówienia”.
Efekt. Każdy EAN trafi jako karta „Zalando ‹EAN›” z ceną i stanem pierwszego kraju do kategorii „Zalando”. Nazwy, zdjęcia i opis dodaj sam — kolejne przebiegi ich nie skasują.
Katalog prowadzisz w Elbuz, Zalando to jeden z kanałów
Co włączyć. W szablonie importu — tylko „Zamówienia”. W szablonie eksportu — kraje w polu „Wersja API (parametry platformy)”, formułę ceny w euro i pole wyboru „Publikuj nowe produkty”.
Efekt. Produkty, których karty już są na Zalando, dostaną Twoją ofertę i powiązanie po EAN, bez duplikatów w katalogu. Pozostałe trafią do weryfikacji jako nowe karty, jeśli ich kategoria ma przypisaną sylwetkę.
Sprzedajesz w Niemczech i w Polsce
Co włączyć. Dwa szablony eksportu z tymi samymi kluczami: w pierwszym — de,at i cena w euro, w drugim — pl i cena w złotych.
Efekt. Każdy kraj dostanie cenę w swojej walucie, a stan — ten sam, z katalogu.
Co zrobić, gdy Zalando nie wysyła lub nie przyjmuje danych
| Co widzisz | Dlaczego tak jest | Co zrobić |
|---|---|---|
| „Zalando: błąd API — HTTP 401 (auth): …” albo „Sprawdź połączenie” nie pokazuje Merchant ID | Klucz skopiowano niecałkowicie lub aplikacja została wycofana w zDirect | Wklej ponownie Client ID i Client secret (czego potrzebujesz od Zalando) |
| „Zalando: podaj Client ID i Client secret aplikacji zDirect” | Pola kluczy w szablonie są puste | Wypełnij oba pola i zapisz szablon |
| „… HTTP 429: rate limit” | Limit zapytań wyczerpany także po czterech ponowieniach | Przy zamówieniach — zwiększ interwał zadania „Zamówienia z marketplace’ów”; przy katalogu — uruchamiaj import katalogu rzadziej; ponowienie jest bezpieczne (harmonogram) |
| „Zalando: sprzedawca nie ma kanałów sprzedaży dla krajów … — sprawdź kody krajów w parametrach platformy” | W polu krajów jest kod kraju, w którym nie sprzedajesz na Zalando, albo błąd w kodzie | Popraw „Wersja API (parametry platformy)”, np. de,at |
| „oczekuje na onboarding EAN: K” z niezerowym K | Karta nie została jeszcze zatwierdzona przez Zalando — to nie błąd | Nic: cena zostanie zastosowana po zatwierdzeniu (kod 104) |
| Czerwone wiersze „Zalando: prices — „…” odrzucono, kod …” | Zalando nie przyjęło części pozycji, przyczyna jest na końcu wiersza | Popraw cenę lub stan w katalogu i uruchom eksport jeszcze raz |
| „Zalando: „…” — brak kodu kreskowego EAN, publikacja na Zalando jest niemożliwa” | Oferta i karta na Zalando są powiązane z EAN | Wypełnij w produkcie kod kreskowy z co najmniej 8 cyfr |
| „… sylwetka (outline) Zalando dla kategorii nie jest powiązana” | Karty z tym EAN na Zalando nie ma, a nowej nie ma pod czym zgłosić | Przypisz sylwetkę do kategorii (nowa karta) |
| „Zalando: błąd publikacji [nazwa] HTTP 400: …” przy każdym przebiegu | Zalando odrzuciło kartę z innego powodu niż niewypełnione obowiązkowe atrybuty: przyczyna jest w treści błędu | Popraw to, co wskazuje błąd, albo utwórz kartę w zDirect — następny eksport znajdzie ją po EAN i doda ofertę |
| W katalogu pojawiły się karty „Zalando 4006…” obok Twoich | Import katalogu nie rozpoznał produktów bez powiązania z EAN | Wyłącz „Produkty”, zbędne karty usuń, a swoje powiąż eksportem (scenariusz) |
Najczęstsze pytania
Czy mogę sam zarejestrować się na Zalando?
Nie. Zalando przyjmuje partnerów tylko na własne zaproszenie. Klucze API pojawiają się po podpisaniu umowy (czego potrzebujesz od Zalando).
Dlaczego produkty z Zalando nazywają się „Zalando 4006…”?
API Zalando nie przekazuje nazw, tylko EAN i dane liczbowe oferty. Zmień nazwy kart w Elbuz — ponowny przebieg ich nie zmieni (ponowny przebieg).
Czy mogę opublikować sukienkę w kilku rozmiarach jedną kartą?
Nie. Elbuz zgłasza jeden produkt jako kartę z jednym rozmiarem. Kartę z tabelą rozmiarów utwórz w zDirect, a Elbuz doda do niej oferty po EAN (nowa karta).
Co oznacza kod 104?
EAN wciąż przechodzi onboarding na Zalando. To nie błąd: cena zostanie zastosowana po zatwierdzeniu karty (kod 104).
Czy Elbuz przekazuje do Zalando numer przesyłki?
Nie. Wysyłki oznaczaj w zDirect, a nowy status zamówienia Elbuz pobierze przy następnym przebiegu (zamówienia).
Dlaczego cena na Zalando jest kilka razy wyższa?
Cena poszła w złotych, a Zalando odczytało ją w euro: Elbuz nie przelicza kursu. Ustaw formułę ceny w szablonie eksportu (eksport).
Gdzie to jest i kto ma dostęp
- Menu
- Słowniki → Operacje → Import danych → nowy szablon typu „Zalando”
- Inne wejścia
- Słowniki → Operacje → Eksport danych — szablon dla cen, stanów i publikacji
- Uprawnienia
- okno „Import” w „Uprawnieniach grup”
- Przygotuj
- Client ID i Client secret aplikacji z zDirect Partner Portal
Jeden szablon to jeden sprzedawca Zalando, ale dowolnie wiele krajów: wymienia się je w polu „Kraje sprzedaży”.
Powiązane tematy
- Jeśli potrzebujesz ogólnej mechaniki importu — harmonogram, przerwanie, kategorie techniczne: przegląd importu danych.
- Jeśli sylwetka się nie przypisuje lub słownik się nie pobiera: dopasowanie kategorii do marketplace’ów.
- Jeśli na Zalando potrzebna jest inna cena niż w katalogu: cena w eksporcie.
- Jeśli sprzedajesz także na Kaufland: podłączenie Kaufland.
