Integracja z Zalando zDirect jest dostępna w pełnym pakiecie xSale. Nie jest dostępna w niższych pakietach, np. xSale Light.
Ten wpis opisuje zakres integracji xSale z Zalando zDirect, czyli z modelem Partner Program z realizacją zamówień z własnych magazynów sprzedawcy. Integracja umożliwia wystawianie ofert z xSale do Zalando, aktualizację cen i stanów oraz pobieranie zamówień i płatności z Zalando do xSale.
Connected Retail i realizacja z magazynów Zalando (ZFS) są osobnymi modelami obsługi i nie są opisane w tym wpisie.
W tym artykule znajdziesz:
- jakie dane xSale pobiera z Zalando
- jakie informacje xSale wysyła do Zalando
- jaki jest szczegółowy zakres danych przesyłanych z xSale do Zalando
- jaki jest szczegółowy zakres danych przesyłanych z Zalando do xSale
- gdzie znajdują się zrzuty xSale
- gdzie znajdują się zrzuty Zalando
Jakie dane xSale pobiera z Zalando?
- grupy i parametry Zalando, wykorzystywane przy przygotowaniu ofert,
- zamówienia o statusie Approved,
- płatności do zamówień o statusie Approved,
- dane odbiorcy i nabywcy dostępne w zamówieniu,
- pozycje zamówienia wraz z kodem, opisem, ilością, ceną i walutą.
Uwaga: Zalando nie zawsze przekazuje numer telefonu klienta. Jeżeli numer nie zostanie zwrócony przez API, pole telefonu w xSale pozostanie puste.
Jakie informacje xSale wysyła do Zalando?
- nowe oferty, w tym nazwę, opis, zdjęcia, kategorię i parametry,
- ceny ofert,
- stany magazynowe ofert,
- status zamówienia zgodnie z mapowaniem statusów w konfiguracji integracji,
- numer listu przewozowego oraz numer listu zwrotnego, jeżeli zostały wygenerowane do zamówienia w xSale.
Integracja przekazuje do Zalando numer listu przewozowego i numer listu zwrotnego zapisany na zamówieniu. Jeżeli do jednego zamówienia wygenerowano więcej niż jedną paczkę, do Zalando przekazywany jest numer zapisany w danych zamówienia.
Adres e-mail do wysyłki faktury jest zapisywany na zamówieniu jako parametr INVOICE_EMAIL. Sama wysyłka dokumentu sprzedaży zależy od procesu generowania i obsługi faktur po stronie xSale/ERP.
Szczegółowy zakres danych przesyłanych z xSale do Zalando
Tabela zawiera odpowiedniki pól z xSale i Zalando zDirect wraz z nazwami tych pól oraz numerami pól oznaczonymi na zrzutach pod tabelą.
Ważne: po stronie Zalando część danych oferty może być zablokowana do edycji, szczególnie gdy oferta jest już aktywna albo wymaga obsługi po stronie Zalando. W takim przypadku zmiana danych oferty może wymagać kontaktu z Zalando Partner Care.
xSale nie oznacza częściowych zwrotów zamówienia w Zalando. Zwroty częściowe należy obsłużyć w panelu Zalando zDirect w sekcji Orders.
| Obszar xSale | Nazwa pola w xSale | Nr | Obszar Zalando zDirect | Nazwa pola w Zalando zDirect | Nr | Uwagi |
| Oferta -> Edycja -> Opis i nazwa oferty w poszczególnych językach | Nazwa (z języka domyślnego wybranego dla integracji) | 1 | Menu > Articles > Article Status Overview > Edit Article > Article Details | Name | 3 | |
| Oferta -> Edycja -> Opis i nazwa oferty w poszczególnych językach | Opis (z języka domyślnego wybranego dla integracji) | 2 | Menu > Articles > Article Status Overview > Edit Article > Edit Article Variant | Description | 6 | |
| Oferta -> Edycja -> Zdjęcia produktu | Zdjęcia | 3 | Menu > Articles > Article Status Overview > Edit Article > Edit Article Variant | Media | 7 | |
| Oferta -> Edycja -> Parametry | Parametry | 4 | Menu > Articles > Article Status Overview > Edit Article > Article Details | Article Details (Brand Code, Target Genders, Target Age Group) | 2 | Wartość przesyłana do Zalando jest ustawiana za pomocą odpowiedniego parametru z oferty w xSale |
| Oferta -> Edycja -> Parametry | Parametry color_code (primary) i supplier color | 4b i 4c | Menu > Articles > Article Status Overview > Edit Article > Edit Article Variant | Colors | 8 | Wartość przesyłana do Zalando jest ustawiana za pomocą odpowiedniego parametru z oferty w xSale |
| Oferta -> Edycja -> Parametry | Parametr season code | 4a | Menu > Articles > Article Status Overview > Edit Article > Edit Article Variant | Season code | 5 | Wartość przesyłana do Zalando jest ustawiana za pomocą odpowiedniego parametru z oferty w xSale |
| Oferta -> Edycja -> Kanały sprzedaży -> Zalando (Edycja) | Kategoria | 5 | Menu > Articles > Article Status Overview > Edit Article > Article Details | Article Type | 1 | |
| Oferta -> Edycja -> Towary i warianty -> Dane wariantu | Dane wariantu | 7 | Menu > Articles > Article Status Overview > Edit Article > Article Details | Size Group | 4 | |
| Oferta -> Edycja -> Towary i warianty -> Edytuj | Kod EAN | 6 | Menu > Articles > Article Status Overview > Edit Article > Edit Article Variant > Ad Sizes | EAN | 9 | EAN jest przekazywany najpierw z parametru, a jeśli go brak – z pola na wariancie towaru. |
| Oferta -> Edycja -> Towary i warianty -> Edytuj | Wartość pola Size (wymagane) | 7a | Menu > Articles > Article Status Overview > Edit Article > Edit Article Variant | Size | 10 | |
| Oferta -> Edycja -> Towary i warianty -> Edytuj towar > Cennik | Cena | 8 | Menu > Articles > Article Status Overview > Podgląd wariantu przy produkcie | Regular Price | 11 | Przesyłana jest wartość z typu ceny ustawionego dla kanału Zalando |
| Oferta -> Edycja -> Towary i warianty -> Edytuj towar > Magazyny | Stan magazynowy | 9 | Menu > Articles > Article Status Overview > Podgląd wariantu przy produkcie | Sellable PF Stock | 12 | Pobierane są stany z magazynów z których integracja Zalando pobiera stan |
| Menu > Articles > Article Listing > Podgląd wariantu przy produkcie | Variant | 13 | Kod wariantu generowany jest przez Zalando i nie wykorzystuje żadnego pola z xSale. |
Szczegółowy zakres danych przesyłanych z Zalando do xSale
Tabela zawiera odpowiedniki pól z xSale i Zalando zDirect wraz z nazwami tych pól oraz numerami pól oznaczonymi na zrzutach pod tabelą.
| Obszar xSale V2 | Pole xSale V2 | Nr | Obszar Zalando | Pole Sklep | Nr | Uwagi |
| Edycja zamówienia > Formularz zamówienia | Informacje o zamówieniu | 1 | Orders > Manage Orders > Order Summary | Created | 1 | Data zamówienia pobierana jest z zamówienia Zalando. |
| Edycja zamówienia > Formularz zamówienia | Status | 2 | Orders > Manage Orders > Order Summary | Status | 2 | Status w Zalando ustawiany jest poprzez xSale według mapowania statusów na konfiguracji integracji. Ustawiany jest status na wszystkich pozycjach zamówienia. |
| Edycja zamówienia > Formularz zamówienia | Nr obcy | 3 | Orders > Manage Orders > Order Summary | Order number | 3 | |
| Edycja zamówienia > Formularz zamówienia > Informacje o przesyłce | Sposób dostawy | 4 | Orders > Manage Orders > Order Summary | brak odpowiednika | Pole mapowane według mapowania płatności w konfiguracji integracji. | |
| Edycja zamówienia > Formularz zamówienia > Informacje o przesyłce | Nr listu | 6 | Orders > Manage Orders > Shipping details > Shipping address | Tracking number | 4 | xSale przekazuje do Zalando numer listu przewozowego wygenerowany do zamówienia |
| Edycja zamówienia > Formularz zamówienia > Informacje o przesyłce | Nr listu zwrotnego | 7 | Orders > Manage Orders > Shipping details > Shipping address | Return number | 5 | xSale przekazuje do Zalando numer listu zwrotnego wygenerowany do zamówienia |
| Edycja zamówienia > Formularz zamówienia > Odbiorca | Nazwa | 10 | Orders > Manage Orders > Shipping details > Shipping address | Imię i nazwisko | 6 | |
| Edycja zamówienia > Formularz zamówienia > Odbiorca | NIP | 14 | Orders > Manage Orders > Shipping details > Shipping address | brak odpowiednika | ||
| Edycja zamówienia > Formularz zamówienia > Odbiorca | Telefon | 15 | Orders > Manage Orders > Shipping details > Shipping address | brak | ||
| Edycja zamówienia > Formularz zamówienia > Odbiorca | 16 | Orders > Manage Orders > Shipping details > Shipping address | brak odpowiednika | Adres e-mail do wysyłki faktury zapisywany jest na zamówieniu w parametrze INVOICE_EMAIL. Wartość ma strukturę: <merchant_id>+<order_number>+invoice@invoister.merchants.zalando.com. | ||
| Edycja zamówienia > Formularz zamówienia > Odbiorca | Miasto | 12 | Orders > Manage Orders > Shipping details > Shipping address | Miasto | 9 | |
| Edycja zamówienia > Formularz zamówienia > Odbiorca | Ulica | 11 | Orders > Manage Orders > Shipping details > Shipping address | Ulica i nr domu | 7 | |
| Edycja zamówienia > Formularz zamówienia > Odbiorca | Kod pocztowy | 13 | Orders > Manage Orders > Shipping details > Shipping address | Kod pocztowy | 8 | |
| Edycja zamówienia > Formularz zamówienia > Nabywca | Nazwa | 17 | Orders > Manage Orders > Shipping details > Shipping address | Imię i nazwisko | 6 | |
| Edycja zamówienia > Formularz zamówienia > Nabywca | NIP | 21 | Orders > Manage Orders > Shipping details > Shipping address | brak odpowiednika | ||
| Edycja zamówienia > Formularz zamówienia > Nabywca | Telefon | 22 | Orders > Manage Orders > Shipping details > Shipping address | brak | ||
| Edycja zamówienia > Formularz zamówienia > Nabywca | 23 | Orders > Manage Orders > Shipping details > Shipping address | Adres e-mail zwracany przez API mo?e by? maskowany przez Zalando. | |||
| Edycja zamówienia > Formularz zamówienia > Nabywca | Miasto | 19 | Orders > Manage Orders > Shipping details > Shipping address | Miasto | 9 | |
| Edycja zamówienia > Formularz zamówienia > Nabywca | Ulica | 18 | Orders > Manage Orders > Shipping details > Shipping address | Ulica i nr domu | 7 | |
| Edycja zamówienia > Formularz zamówienia > Nabywca | Kod pocztowy | 20 | Orders > Manage Orders > Shipping details > Shipping address | Kod pocztowy | 8 | |
| Edycja zamówienia > Pozycje zamówienia | Kod oferty | 31 | Orders > Manage Orders > Shipping details > Article details | Merchant SKU | 10 | Merchant SKU jest numerem zewnętrznym oferty xSale powiązanej z zamówionym towarem. Na pozycję zamówienia wczytuje się kod oferty, powiązanej z zamówionym towarem. |
| Edycja zamówienia > Pozycje zamówienia | Kod towaru | 32 | Orders > Manage Orders > Shipping details > Article details | Merchant SKU | 10 | Merchant SKU jest numerem zewnętrznym oferty xSale powiązanej z zamówionym towarem. Na pozycję zamówienia w xSale wczytuje się kod towaru, który jest powiązany z zamówionym wariantem oferty. |
| Edycja zamówienia > Pozycje zamówienia | Cena brutto | 9 | Orders > Manage Orders > Shipping details > Article details | Price | 11 | |
| Edycja zamówienia > Pozycje zamówienia | Ilość | 8 | Orders > Manage Orders > Shipping details > Article details | brak odpowiednika | Ilość widoczna na pozycji zamówienia w xSale dla danej oferty jest sumą pozycji danego artykułu Merchant SKU w panelu zDirect. |
EN









