Zalando: dostęp zDirect, Client ID i synchronizacja po EAN

Do czego to służy

Konektor Zalando łączy Zaksio z Zalando Merchant Platform (zDirect). Pobiera zamówienia realizowane przez Ciebie, wysyła stany i ceny adresowane po EAN oraz zapisuje numer przesyłki w zamówieniu.

Czego konektor nie robi: nie pobiera listy ofert ani zwrotów i nie obsługuje webhooków. Zamówienia realizowane przez Zalando (ZFS) pomija. Nie zadziała też bez umowy partnerskiej.

Gdzie to znaleźć w aplikacji

Sprzedaż i logistyka, „Kanały sprzedaży”, „Dodaj kanał sprzedaży”, rodzaj „Zalando”, a w kanale zakładka „Połączenie”. Pola konektora: „Merchant ID”, „Client ID”, „Client secret”, „Sales channel ID (kanały sprzedaży)” oraz „Środowisko” (Produkcja albo Sandbox).

Aplikacja oznacza ten rodzaj kanału jako „W przygotowaniu”: zakładka „Połączenie” pokazuje na razie uproszczony szkic formularza (z mniejszą liczbą pól i innymi nazwami), a przycisków „Sprawdź połączenie” i „Start” jeszcze w niej nie ma. Klucze zapisane w tym szkicu mogą nie trafić do pól konektora, więc po udostępnieniu pełnego ekranu wpisz je ponownie.

Skąd wziąć klucze

1. Zawrzyj umowę partnerską z Zalando i poczekaj na aktywację konta oraz dostępu do zDirect Portal.
2. W zDirect Portal wejdź w Applications i utwórz aplikację (to klient OAuth). Jeśli konto prowadzi firma zewnętrzna, musi Cię zaprosić do portalu.
3. Nadaj aplikacji zakresy: orders/read, orders/write (numer przesyłki), products/stock/write oraz products/price/write.
4. Skopiuj Client ID i Client secret z sekcji Credentials aplikacji, a Merchant ID i Sales channel ID z zDirect Portal.
5. Wklej dane w zakładce „Połączenie”. Do testów wybierz Sandbox: klucze sandboxowe i produkcyjne nie są zamienne.

Dokumentacja logowania: developers.merchants.zalando.com. Sales channel jest osobny dla każdego kraju Zalando, a kilka kanałów rozdzielasz przecinkami.

Co synchronizuje

• Zamówienia: realizowane przez sprzedawcę (PartnerFulfilled), pobierane co 2 minuty. Status „initial” wchodzi dopiero po zatwierdzeniu zamówienia. Zalando nie podaje stawki VAT ani danych płatności, więc pozycje wchodzą bez stawki VAT (do uzupełnienia według towaru), a płatność uznajemy za opłaconą.
• Stany i ceny: wyłącznie po EAN (13 cyfr) i Sales channel ID. Oferta musi mieć 13-cyfrowy EAN w identyfikatorze lub SKU, a puste „Sales channel ID” wystarcza tylko do pobierania zamówień.
• Cena: tylko regularna, w walucie kanału. Zalando stosuje progi minimalne i maksymalne oraz limit rabatu, więc cena może zostać odrzucona.
• Numer przesyłki: zapisywany w polu tracking_number zamówienia.

Czego jeszcze nie ma

• Ekranu połączenia dla tej platformy w aplikacji: backend konektora istnieje i jest przetestowany na atrapach serwera, ale interfejs jest w przygotowaniu (patrz wyżej).
• Listy ofert, zwrotów i webhooków. Zamówienia starsze niż rok nie są dostępne w API.
• Tworzenia przesyłek i zmiany statusu pozycji, których Zalando może dodatkowo wymagać, oraz ceny promocyjnej i harmonogramów cen.
• Weryfikacji na żywym koncie: niepewne są m.in. czy sam numer przesyłki zamyka realizację, czy cena pozycji jest brutto, maksymalny rozmiar wsadu cen i znaczenie statusu „initial”.