Zakres integracji Magento

Ten artykuł opisuje zakres integracji xSale z Magento.

Wymagania i ograniczenia

Integracja działa z Magento w wersji 2 i nowszych.
Nie obsługujemy wewnętrznych zestawów Magento typu bundle.
Dane dat z API Magento muszą być przesyłane w formacie UTC.

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

Oferty z tym samym SKU

Jeżeli kilka ofert w xSale ma ten sam kod SKU, w Magento będą one traktowane jako ten sam produkt. Integracja przetwarza takie oferty sekwencyjnie:

pierwsza oferta z danym SKU tworzy produkt w Magento,
każda kolejna oferta z tym samym SKU aktualizuje już istniejący produkt.

W praktyce oznacza to, że przy powtarzającym się SKU dane (np. opis, cena, stany, zdjęcia) mogą zostać nadpisane przez kolejne oferty. Dlatego warto pilnować, aby SKU było unikalne dla produktu, który ma być osobnym wpisem w Magento.

W przypadku ofert wielowariantowych pole kod wariantu (SKU) jest uzupełniane wartością Kod towaru z xSale.

Uwaga: Nie zaleca się zmiany kodu oferty ani po stronie xSale, ani po stronie Magento, ponieważ integracja używa tego kodu do powiązania rekordów między systemami. Zmiana może spowodować utratę powiązania i błędne działanie synchronizacji.

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.

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 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
Zamówienie -> Formularz zamówienia -> Punkt odbioru		Wysyłka & Pakowanie		Punkt odbioru InPost. Wartość jest pobierana najpierw z pola inpost_locker_id. Jeśli pole jest puste to w drugiej kolejności z shipping_place_id
		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”

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	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	Comapany	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	E-mail	13	Sales -> Orders -> View-> Order& Account Information	E-mail	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	E-mail	22	Sales -> Orders -> View-> Order& Account Information	E-mail	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