↑↓ wybierzEnter otwórzEsc zamknij

    1. Elbuz
    2. Marketplace’y w Europie: co się importuje i jak je podłączyć

    Jak podłączyć Zalando do Elbuz: ceny według krajów, zamówienia i nowe karty

    6 min czytaniaZaktualizowano

    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:

    1. Sprzedawca zaprasza w zDirect swojego partnera technicznego.
    2. Partner techniczny tworzy aplikację API właśnie dla tego sprzedawcy. Jedno konto aplikacji obsługuje jednego sprzedawcę.
    3. Portal pokazuje dwie części klucza — Client ID i Client secret. Wkleja się je do szablonu Elbuz.
    Szablon importu Zalando: karta „Połączenie” z polami kluczy API
    1Client ID
    2Client secret
    3Kraje sprzedaży
    4Merchant ID
    1. Client ID — publiczna część kluczy aplikacji zDirect.
    2. Client secret — część tajna; przechowywana ukryta.
    3. Kraje sprzedaży — kody krajów po przecinku; pierwszy daje cenę i stan katalogu.
    4. Merchant ID — potrzebny tylko wtedy, gdy klucze obsługują kilku sprzedawców.
    Pole w szablonieCo to jest
    Client IDPubliczna część klucza aplikacji. Obowiązkowe
    Client secretTajna 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 ZalandoPole produktu w Elbuz
    EAN rozmiaruKod kreskowy i kod produktu
    —Nazwa „Zalando ‹EAN›”
    cena w pierwszym kraju szablonuCena
    stan w pierwszym krajuIlość
    oferta online lub stan większy od zeraStatus: 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.

    Szablon importu Zalando: karta „Wybór danych do importu” z polami wyboru
    1Produkty
    2Zamówienia
    1. Produkty — katalog: ceny, stany i statusy po EAN.
    2. 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.

    Szablon importu Zalando: karta „Powiązane ustawienia” z przyciskami „Statusy zamówienia” i „Ustawienia harmonogramu”
    1Statusy zamówienia
    2Ustawienia harmonogramu
    1. Statusy zamówienia — dopasowuje kody statusów Zalando do Twoich statusów.
    2. 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:

    KrajWaluta, w której Zalando odczyta cenę
    plPLN
    czCZK
    chCHF
    se, dk, noSEK, DKK, NOK
    gb, hu, roGBP, 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 ZalandoCo robi ElbuzWiersz w dzienniku
    Karta z tym EAN już istniejeDodaje 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 przypisanaWysyła nową kartę do weryfikacji Zalando„Zalando: „…” — nową kartę wysłano do weryfikacji Zalando”
    Karty nie ma, sylwetka nie jest przypisanaPomija 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.

    Okno dopasowania kategorii do marketplace’ów z wybranym przełącznikiem Zalando i kolumnami sylwetki Zalando w tabeli kategorii
    1Przełącznik Zalando
    2Kolumna „Sylwetka Zalando”
    1. Przełącznik Zalando przełącza kolumny tabeli na ten marketplace.
    2. 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

    Najczęstsze problemy
    Co widziszDlaczego tak jestCo 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

    Czy ten artykuł był pomocny?

    Brakuje funkcji? Napisz do nas.

    Dodamy ją za darmo, jeśli przyda się też innym.

    Jeśli potrzebujesz jej tylko ty — umówimy się osobno.

    Spis treści

    Zaproponuj usprawnienie

    Wypróbuj Elbuz za darmo