EN
Ten artykuł opisuje zakres integracji xSale z Magento 2, w tym dane przekazywane przy ofertach oraz zamówieniach. Dostępny zakres może zależeć od konfiguracji integracji, uruchomionych procesów i ustawionych mapowań.
W tym artykule znajdziesz
- wymagania i ograniczenia integracji,
- dane synchronizowane z xSale do Magento,
- szczegółowe mapowanie danych przy ofercie xSale → Magento,
- dane synchronizowane z Magento do xSale,
- szczegółowe mapowanie danych przy zamówieniach z Magento → xSale,
- zrzuty ekranu z xSale,
- zrzuty ekranu z Magento.
Wymagania i ograniczenia
- Integracja jest przeznaczona dla Magento 2. Konkretna zgodność zależy od dostępności wykorzystywanych endpointów REST API oraz konfiguracji modułu xSale po stronie Magento.
- Zestawy Magento typu bundle nie są obsługiwane jako pozycje importowanego zamówienia. Import pozycji obejmuje produkty typu simple, virtual i grouped.
- Pola daty zwracane przez API Magento, takie jak
created_atiupdated_at, muszą być podawane w UTC. xSale wysyła filtry synchronizacji w UTC, a datę utworzenia zamówienia przelicza na lokalną strefę czasową.
Zakres synchronizacji xSale → Magento
- Opisy produktów
- Zdjęcia produktów
- Stany magazynowe
- Ceny produktów
- Stawki VAT produktów
- Parametry na ofercie
- Status zamówienia (możliwość ustawienia statusu w Magento po zmianie statusu w xSale)
- Numer listu przewozowego
Opis i formatowanie HTML: opis z xSale jest przekazywany do Magento jako atrybut description, jeśli synchronizacja opisów jest włączona w konfiguracji integracji. Jeżeli w opisie użyto formatowania HTML, xSale przekazuje tę treść dalej, a jej końcowy wygląd zależy od szablonu i ustawień Magento.
Oferty z tym samym SKU
W przypadku ofert posiadających ten sam kod SKU, integracja działa w sposób sekwencyjny:
- Pierwsza oferta z danym kodem zostaje dodana do Magento jako nowy produkt.
- Kolejne oferty o tym samym kodzie nie tworzą nowych wpisów, lecz aktualizują dane już istniejącego towaru.
Warto mieć to na uwadze podczas planowania struktury ofert w xSale, aby uniknąć niezamierzonych nadpisywań danych.
Ważne: Nie zaleca się zmiany kodu oferty ani po stronie xSale, ani po stronie sklepu. Integrator wykorzystuje ten kod do powiązania odpowiednich wpisów pomiędzy systemami. Zmiana może spowodować utratę powiązania i błędne działanie synchronizacji.
W przypadku ofert wielowariantowych pole kod wariantu (SKU) jest uzupełniane wartością Kod towaru z xSale.
Oferty wielowariantowe
xSale może tworzyć w Magento oferty wielowariantowe (np. rozmiary), które odpowiadają strukturze:
- Configurable Product – widoczny dla klienta (Visibility = Catalog, Search)
- Simple Product – pojedyncze warianty z xSale, niewidoczne osobno (Visibility = Not Visible Individually)
Warianty (Simple Product) aktualizują się tak samo jak standardowe oferty w xSale.
Szczegółowy zakres wymienianych danych przy ofercie xSale → Magento
| Nazwa pola w xSale | nr | Nazwa pola w Magento | nr | Uwagi |
| Nazwa (z języka domyślnego wybranego dla integracji) + bloki wariantów | 1 | Product Name | 2 | |
| Opis (z języka domyślnego wybranego dla integracji) | 2 | Description | 8 | |
| Zdjęcia produktu | 4 | Images And Videos | 9 | |
| Parametry | 5 | Attribute | 10 | |
| Grupy z kanału sprzedaży | 8 | Categories | 6 | |
| Informacje dodatkowe o ofercie : Grupa, EAN, Kod… > Kod | 3 | SKU | 3 | Dla oferty wielowariantowej pole kod wariantu (SKU) uzupełniane jest polem Kod towaru z xSale. |
| Warianty i ceny > Wariant > Cena towaru | 6 | Price | 4 | |
| Warianty i ceny > Wariant > Stan magazynowy towaru | 7 | Quantity | 5 | |
| Warianty i ceny > Wariant > Dane wariantu > Wariant *tylko dla wielowariantowej | 9 | Attribute | 10 | |
| Enable Product | 1 | Yes = Ustawiamy dla każdego wystawianego przez xSale towaru | ||
| Visibility | 7 | Catalog, Search – ustawiamy dla oferty jednowariantowej oraz w przypadku oferty wielowariantowej dla „Configurable Product” Not Visible Indivdually – w przypadku oferty wielowariantowej ustawiamy dla „Simple Product” |
Zakres synchronizacji Magento → xSale
- Zamówienia (importowana jest waluta zamówienia i ceny w walucie zamówienia, niezależnie od waluty sklepu i waluty domyślnej w Magento)
- Płatności do pobranych zamówień
- Grupy i parametry
- Punkt odbioru InPost
Szczegółowy zakres wymienianych danych przy zamówieniach z Magento → xSale
Zamówienia z Magento są przekazywane do xSale jako „Zamówienie sprzedaży”. Poniżej znajduje się mapowanie pól. Tabela zawiera odpowiedniki pól z xSale i Magento wraz z numerami pól widocznymi na zrzutach ekranu.
| Obszar xSale | Pole xSale | nr | Obszar Magento | Pole Magento | nr | Uwagi |
| Edycja zamówienia > Formularz zamówienia | Data zakupu | 1 | Sales -> Orders -> View-> Order& Account Information | Order Date | 2 | |
| Edycja zamówienia > Formularz zamówienia | Zewnętrzny nr zamówienia | 3 | Sales -> Orders -> View-> Order& Account Information | Order # | 1 | |
| Edycja zamówienia > Formularz zamówienia | Dostawa | 4 | Sales -> Orders -> View-> Payment & Shipping Method | Shipping & Handling Information | 5 | Pole mapowane według mapowania podanego na ustawieniach integracji w xSale |
| Edycja zamówienia > Formularz zamówienia | Punkt dostawy | 32 | Sales -> Orders -> View | Wysyłka & Pakowanie | 32 | Punkt odbioru InPost. Wartość jest pobierana najpierw z pola inpost_locker_id. Jeśli pole jest puste, w drugiej kolejności pobierana jest z pola shipping_place_id. |
| Edycja zamówienia > Formularz zamówienia | Płatność | 5 | Sales -> Orders -> View-> Payment & Shipping Method | Payment Information | 4 | Pobierane są płatności z uzupełnionym polem amount_paid. |
| Edycja zamówienia > Formularz zamówienia | Uwagi | 6 | Sales -> Orders -> View-> Order Total | Notes for this Order | 6 | |
| Edycja zamówienia > Formularz adresu > Odbiorca | Nazwa | 9 | Sales -> Orders -> View-> Addres Information -> Shipping Address -> Edit | First Name & Last Name | 20 & 21 | |
| Edycja zamówienia > Formularz adresu > Odbiorca | Nazwa 2 | 10 | Sales -> Orders -> View-> Addres Information -> Shipping Address -> Edit | Company | 22 | |
| Edycja zamówienia > Formularz adresu > Odbiorca | Telefon | 12 | Sales -> Orders -> View-> Addres Information -> Shipping Address -> Edit | Phone Number | 27 | |
| Edycja zamówienia > Formularz adresu > Odbiorca | 13 | Sales -> Orders -> View-> Order& Account Information | 3 | |||
| Edycja zamówienia > Formularz adresu > Odbiorca | Miasto | 14 | Sales -> Orders -> View-> Addres Information -> Shipping Address -> Edit | City | 24 | |
| Edycja zamówienia > Formularz adresu > Odbiorca | Ulica | 15 | Sales -> Orders -> View-> Addres Information -> Shipping Address -> Edit | Street Address | 23 | |
| Edycja zamówienia > Formularz adresu > Odbiorca | Kod pocztowy | 16 | Sales -> Orders -> View-> Addres Information -> Shipping Address -> Edit | Zip/Postal Code | 26 | |
| Edycja zamówienia > Formularz adresu > Odbiorca | Kraj | 17 | Sales -> Orders -> View-> Addres Information -> Shipping Address -> Edit | Country | 25 | |
| Edycja zamówienia > Formularz adresu > Kupujący | Nazwa | 18 | Sales -> Orders -> View-> Addres Information -> Billing Address -> Edit | First Name & Last Name | 11 & 12 | |
| Edycja zamówienia > Formularz adresu > Kupujący | Nazwa 2 | 19 | Sales -> Orders -> View-> Addres Information -> Billing Address -> Edit | Comapany | 13 | |
| Edycja zamówienia > Formularz adresu > Kupujący | NIP | 20 | Sales -> Orders -> View-> Addres Information -> Billing Address -> Edit | Vat Number | 19 | |
| Edycja zamówienia > Formularz adresu > Kupujący | Telefon | 21 | Sales -> Orders -> View-> Addres Information -> Billing Address -> Edit | Phone Number | 18 | |
| Edycja zamówienia > Formularz adresu > Kupujący | 22 | Sales -> Orders -> View-> Order& Account Information | 3 | |||
| Edycja zamówienia > Formularz adresu > Kupujący | Miasto | 23 | Sales -> Orders -> View-> Addres Information -> Billing Address -> Edit | City | 15 | |
| Edycja zamówienia > Formularz adresu > Kupujący | Ulica | 24 | Sales -> Orders -> View-> Addres Information -> Billing Address -> Edit | Street Address | 14 | |
| Edycja zamówienia > Formularz adresu > Kupujący | Kod pocztowy | 25 | Sales -> Orders -> View-> Addres Information -> Billing Address -> Edit | Zip/Postal Code | 17 | |
| Edycja zamówienia > Formularz adresu > Kupujący | Kraj | 26 | Sales -> Orders -> View-> Addres Information -> Billing Address -> Edit | Country | 16 | |
| Edycja zamówienia > Lista przedmiotów zamówienia | Kod | 28 | Sales -> Orders -> View-> Items Ordered -> Product | SKU | 7 | Uwaga: Kod w xSale zależy od kodu towaru podłączonego do oferty i w niektórych przypadkach może być różny od SKU. |
| Edycja zamówienia > Lista przedmiotów zamówienia | Oferta | 29 | Sales -> Orders -> View-> Items Ordered -> Product | SKU | 7 | |
| Edycja zamówienia > Lista przedmiotów zamówienia | Suma | 27 | Sales -> Orders -> View-> Order Totals | Grand Total | 10 | |
| Edycja zamówienia > Lista przedmiotów zamówienia | Ilość | 30 | Sales -> Orders -> View-> Items Ordered | Qty | 8 | |
| Edycja zamówienia > Lista przedmiotów zamówienia | TRANSPORT | 31 | Sales -> Orders -> View-> Order Totals | Shipping & Handling | 9 | Uwaga: Koszty wysyłki mogą być wczytywane na inny kod usługi w zależności od mapowania podanego w konfiguracji |
Zrzuty xSale
Zrzuty Magento
