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śli oferty mają ten sam kod SKU, integracja działa sekwencyjnie:
- Pierwsza oferta z danym SKU tworzy nowy produkt w Magento.
- Kolejne oferty o tym samym SKU aktualizują dane istniejącego produktu.
Warto uwzględnić to przy planowaniu struktury ofert, aby uniknąć nadpisywania danych.
Dla oferty wielowariantowej 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.
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 | 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
