EN
Wpis opisuje zakres danych wymienianych między xSale a PrestaShop. Integracja obsługuje dwa kierunki synchronizacji: dane wysyłane z xSale do PrestaShop oraz dane pobierane z PrestaShop do xSale.
Integracja xSale z PrestaShop działa z wersją PrestaShop nie starszą niż 1.6.1.1. xSale nie obsługuje PrestaShop Multistore.
W tym artykule znajdziesz
- Jakie dane są wysyłane z xSale do PrestaShop?
- Jak działa synchronizacja ofert z tym samym kodem SKU?
- Jakie dane są pobierane z PrestaShop do xSale?
- Jak importowane są ceny pozycji z zamówienia PrestaShop?
- Jakie pola z zamówienia PrestaShop trafiają do xSale?
- Jakie pola z oferty xSale trafiają do PrestaShop?
- O czym warto pamiętać?
Zakres informacji przesyłanych z xSale do PrestaShop
Z xSale do PrestaShop mogą być wysyłane dane potrzebne do obsługi oferty i zamówienia w sklepie. Zakres synchronizacji zależy od konfiguracji integracji oraz od danych uzupełnionych na ofercie w xSale.
- nazwa i opis produktu,
- zdjęcia produktu,
- ceny,
- stany magazynowe,
- kategorie i parametry/cechy oferty,
- dane wariantów i kombinacji, jeżeli oferta jest wariantowa,
- numer listu przewozowego na zamówieniu,
- status zamówienia.
Przy aktualizacji produktu xSale rozpoznaje produkt w PrestaShop po kodzie oferty, czyli polu używanym jako SKU/indeks produktu. Jeżeli produkt o takim kodzie już istnieje, integracja aktualizuje istniejący produkt zamiast tworzyć kolejny.
Sposób działania dla ofert z tym samym kodem SKU
Jeżeli kilka ofert w xSale ma ten sam kod SKU, integracja traktuje je jako powiązane z tym samym produktem w PrestaShop.
- Pierwsza oferta z danym kodem może utworzyć produkt w PrestaShop.
- Kolejna oferta z tym samym kodem aktualizuje dane istniejącego produktu.
Nie zalecamy zmiany kodu oferty po stronie xSale ani indeksu/SKU po stronie PrestaShop po uruchomieniu synchronizacji. Ten kod jest używany do utrzymania powiązania między systemami. Zmiana może spowodować, że integracja nie odnajdzie właściwego produktu albo zaktualizuje nie ten produkt, którego oczekuje użytkownik.
Zakres informacji pobieranych z PrestaShop do xSale
Z PrestaShop do xSale pobierane są przede wszystkim dane potrzebne do obsługi sprzedaży i dalszego przetwarzania zamówień.
- zamówienia,
- płatności do pobranych zamówień,
- dane kupującego i odbiorcy,
- pozycje zamówienia, koszty dostawy i koszty pakowania,
- informacje o rabatach i ich wartościach na zamówieniu,
- grupy i parametry,
- oferty z PrestaShop, z wyłączeniem ofert wielowariantowych.
Jak importowane są ceny pozycji z zamówienia PrestaShop?
Przy imporcie zamówienia xSale pobiera cenę jednostkową pozycji przekazaną przez PrestaShop. To, czy będzie to cena brutto czy netto, zależy od ustawienia integracji Pobieraj ceny brutto opisanego w konfiguracji PrestaShop.
Cena jednostkowa jest zaokrąglana do dwóch miejsc po przecinku. Następnie xSale wylicza podstawową wartość pozycji jako cena jednostkowa × ilość.
Różnice mogą wynikać ze sposobu zaokrąglania w PrestaShop. Sklep może liczyć zamówienie od ceny jednostkowej, od całej linii albo od sumy koszyka. Dlatego suma widoczna na nagłówku zamówienia w PrestaShop może różnić się od prostego przeliczenia pozycji w xSale.
xSale porównuje wartość pozycji z wartością oczekiwaną na podstawie danych z PrestaShop: kwoty zapłaconej pomniejszonej o koszt dostawy i pakowania. Jeżeli różnica wynika z dopuszczalnych zaokrągleń, xSale może skorygować cenę pozycji o groszowe wartości, aby suma pozycji odpowiadała wartości zamówienia z PrestaShop. Przy większej liczbie sztuk system może rozdzielić pozycję i skorygować tylko część ilości.
Koszt dostawy i koszt pakowania są importowane osobno. Rabat na dostawę obniża koszt dostawy. Rabat produktowy lub koszykowy dotyczący produktów jest rozdzielany na pozycje zamówienia tak, aby jego wartość została odwzorowana na produktach.
Jeżeli różnica jest większa niż dopuszczalna różnica zaokrągleń albo danych z PrestaShop nie da się jednoznacznie przeliczyć, zamówienie wymaga ręcznej weryfikacji. xSale nie wykonuje wtedy dowolnej korekty cen produktów.
Szczegółowy zakres danych przesyłanych z PrestaShop do xSale
Zamówienia z PrestaShop są przekazywane do xSale jako zamówienia sprzedaży. Tabela pokazuje odpowiedniki pól z xSale i PrestaShop oraz numery pól oznaczone na zrzutach znajdujących się pod tabelą.
xSale może pobierać oferty z PrestaShop, ale import ofert nie obejmuje ofert wielowariantowych. Oferta musi mieć uzupełnioną nazwę, kod oraz kategorię. W przypadku kategorii należy wskazać ostatni liść drzewa kategorii.
| Obszar xSale | Pole xSale | nr | Obszar Presta | Pole Presta | nr | Uwagi |
| Nagłówek zamówienia | Data zakupu | 1 | Sprzedaż -> Zamówienia -> Zobacz | Data | 1 | Może być aktualizowana w xSale po zmianie na zamówieniu w Presta |
| Nagłówek zamówienia | Nr obcy / numer zewnętrzny zamówienia | 3 | Sprzedaż -> Zamówienia -> Zobacz -> Zamówienie | Nr zamówienia | 2 | |
| Karta zamówienia > Dostawa | Sposób dostawy | 4 | Sprzedaż -> Zamówienia -> Zobacz -> Wysyłka | Przewoźnik | 4 | Pole mapowane według mapowania sposobów dostawy na integracji z Presta |
| Karta zamówienia > Płatność | Forma płatności | 5 | Sprzedaż -> Zamówienia -> Zobacz -> Płatność | Metoda płatności | 19 | Pole mapowane według mapowania sposobów dostawy na integracji z Presta |
| Nagłówek zamówienia | Uwagi klienta | 6 | Sprzedaż -> Zamówienia -> Zobacz -> Wiadomości | Wiadomości | 20 | |
| Zamawiający > Odbiorca | Nazwa | 9 | Sprzedaż -> Zamówienia -> Zobacz -> Klient -> Adres wysyłki | Nazwa firmy lub Imię* | 7 | *Nazwa firmy lub imię i nazwisko |
| Zamawiający > Odbiorca | Nazwa 2 | 10 | Sprzedaż -> Zamówienia -> Zobacz -> Klient -> Adres wysyłki | Imię i nazwisko lub Nazwisko | 6 | |
| Zamawiający > Odbiorca | Telefon | 12 | Sprzedaż -> Zamówienia -> Zobacz -> Klient -> Adres wysyłki | Telefon | 11 | |
| Zamawiający > Odbiorca | 13 | Sprzedaż -> Zamówienia -> Zobacz -> Klient | 5 | |||
| Zamawiający > Odbiorca | Miasto | 14 | Sprzedaż -> Zamówienia -> Zobacz -> Klient -> Adres wysyłki | Miasto | 9 | |
| Zamawiający > Odbiorca | Ulica | 15 | Sprzedaż -> Zamówienia -> Zobacz -> Klient -> Adres wysyłki | Ulica i numer | 8 | |
| Zamawiający > Odbiorca | Kod pocztowy | 16 | Sprzedaż -> Zamówienia -> Zobacz -> Klient -> Adres wysyłki | Kod pocztowy | 9 | |
| Zamawiający > Odbiorca | Kraj | 17 | Sprzedaż -> Zamówienia -> Zobacz -> Klient -> Adres wysyłki | Kraj | 10 | |
| Zamawiający > Nabywca / Płatnik | Nazwa | 18 | Sprzedaż -> Zamówienia -> Zobacz -> Klient -> Adres rozliczeniowy | Nazwa firmy lub Imię | 13 | W przypadku, gdy klient w Presta nie poda danych do faktury pobierane są dane adresowe do wysłania przesyłki |
| Zamawiający > Nabywca / Płatnik | Nazwa 2 | 19 | Sprzedaż -> Zamówienia -> Zobacz -> Klient -> Adres rozliczeniowy | Nazwisko | 12 | W przypadku, gdy klient w Presta nie poda danych do faktury pobierane są dane adresowe do wysłania przesyłki |
| Zamawiający > Nabywca / Płatnik | NIP | 20 | Sprzedaż -> Zamówienia -> Zobacz -> Klient -> Adres rozliczeniowy | NIP | 14 | W przypadku, gdy klient w Presta nie poda danych do faktury pobierane są dane adresowe do wysłania przesyłki |
| Zamawiający > Nabywca / Płatnik | Telefon | 21 | Sprzedaż -> Zamówienia -> Zobacz -> Klient -> Adres rozliczeniowy | Telefon | 18 | W przypadku, gdy klient w Presta nie poda danych do faktury pobierane są dane adresowe do wysłania przesyłki |
| Zamawiający > Nabywca / Płatnik | 22 | Sprzedaż -> Zamówienia -> Zobacz -> Klient -> Adres rozliczeniowy | 5 | |||
| Zamawiający > Nabywca / Płatnik | Miasto | 23 | Sprzedaż -> Zamówienia -> Zobacz -> Klient -> Adres rozliczeniowy | Miasto | 16 | W przypadku, gdy klient w Presta nie poda danych do faktury pobierane są dane adresowe do wysłania przesyłki |
| Zamawiający > Nabywca / Płatnik | Ulica | 24 | Sprzedaż -> Zamówienia -> Zobacz -> Klient -> Adres rozliczeniowy | Ulica i numer | 15 | W przypadku, gdy klient w Presta nie poda danych do faktury pobierane są dane adresowe do wysłania przesyłki |
| Zamawiający > Nabywca / Płatnik | Kod pocztowy | 25 | Sprzedaż -> Zamówienia -> Zobacz -> Klient -> Adres rozliczeniowy | Kod pocztowy | 16 | W przypadku, gdy klient w Presta nie poda danych do faktury pobierane są dane adresowe do wysłania przesyłki |
| Zamawiający > Nabywca / Płatnik | Kraj | 26 | Sprzedaż -> Zamówienia -> Zobacz -> Klient -> Adres rozliczeniowy | Kraj | 17 | W przypadku, gdy klient w Presta nie poda danych do faktury pobierane są dane adresowe do wysłania przesyłki |
| Pozycje zamówienia > Oferty | Kod oferty | 30 | Sprzedaż -> Zamówienia -> Zobacz- > Produkty | Produkt | 21 | Kod w xSale może być różny od symbolu produktu w Presta i jest uzależniony od kodu towaru podłączonego do oferty |
| Pozycje zamówienia > Oferty | Nazwa oferty | 27 | Sprzedaż -> Zamówienia -> Zobacz- > Produkty | Produkt | 21 | |
| Pozycje zamówienia > Oferty | Cena brutto | 28 | Sprzedaż -> Zamówienia -> Zobacz- > Produkty | Cena za jednostkę brutto | 22 | |
| Pozycje zamówienia > Oferty | Ilość | 29 | Sprzedaż -> Zamówienia -> Zobacz- > Produkty | Ilość | 23 | |
| Pola dodatkowe | RABAT_PRESTA | 31 | Sprzedaż -> Zamówienia -> Zobacz- > Produkty | Nazwa | 31 | W przypadku braku na zamówieniu w xSale, należy sprawdzić ustawienia pól dodatkowych |
| Pola dodatkowe | WARTOSC_PRESTA_RABAT | 32 | Sprzedaż -> Zamówienia -> Zobacz- > Produkty | Wartość | 32 | W przypadku braku na zamówieniu w xSale, należy sprawdzić ustawienia pól dodatkowych |
Szczegółowy zakres danych przesyłanych z xSale do PrestaShop
| Obszar xSale | Nazwa pola w xSale | nr | Obszar Presta | Nazwa pola w Presta | nr | Uwagi |
| Oferta > Opisy i zdjęcia > Opis | Nazwa (z języka domyślnego wybranego dla integracji) | 1 | Katalog > Produkty > Edycja > Nazwa | Nazwa | 1 | |
| Oferta > Opisy i zdjęcia > Opis | Opis (z języka domyślnego wybranego dla integracji) | 8 | Katalog > Produkty > Edycja > Ustawienia podstawowe > Opis | Opis | 2 | |
| Oferta > Opisy i zdjęcia > Zdjęcia | Zdjęcia produktu | 3 | Katalog > Produkty > Edycja > Ustawienia podstawowe > Zdjęcia | Zdjęcia | 3 | |
| Oferta > Parametry | Parametry | 4 | Katalog > Produkty > Edycja > Ustawienia podstawowe > Cechy | Cechy | 4 | |
| Oferta > Kanały sprzedaży > Edycja kanału | Kategoria | 7 | Katalog > Produkty > Edycja > Ustawienia podstawowe | Kategorie | 8 | |
| Oferta > Nagłówek oferty | Kod oferty | 2 | Katalog > Produkty > Edycja > Ustawienia podstawowe | Indeks | 5 | Dla ofert wielowariantowych uzupełniamy pole w zakładce „Kombinacje”. Index na wariancie to nazwa oferty, gdzie spacje są zastąpione myślnikami. Długość pola indeks zależy od posiadanej wersji Presty. |
| Oferta > Kanały sprzedaży > Presta | Cena | 5 | Katalog > Produkty > Edycja > Ustawienia podstawowe > Cena | Netto | 7 | * Dla produktu pojedynczego |
| Oferta > Kanały sprzedaży > Presta | Stan | 6 | Katalog > Produkty > Edycja > Ustawienia podstawowe > Ilość | Ilość | 6 | * Dla produktu pojedynczego |
| Oferta > Towary i warianty | Dane wariantu | 10 | Katalog > Produkty > Edycja > Kombinacje > Edycja | Szczegóły kombinacji | 10 | * Dla produktu z kombinacjami |
| Towar > Cenniki i magazyny > Cennik | Cena | 11 | Katalog > Produkty > Edycja > Kombinacje > Edycja | Ostateczna cena detaliczna (netto) | 12 | Wartość ceny jest pobierana z xSale według typu ceny ustawionego przy kanale sprzedaży Presta |
| Oferta > Towary i warianty | Ilość / stan magazynowy | 12 | Katalog > Produkty > Edycja > Kombinacje > Edycja | Ilość | 11 | Stan magazynowy pobierany jest według magazynów ustawionych w konfiguracji integracji z Presta |
| Oferta > Opisy i zdjęcia > Opis | Nazwa | 1 | Katalog > Produkty > Edycja > Kombinacje > Edycja | Indeks | 13 | Pole Indeks powstaje z pola Nazwa poprzez zamianę wielkich liter na małe, usunięcie polskich znaków i zastąpienie spacji myślnikami. |
| Katalog > Produkty > Edycja > Ustawienia podstawowe > Kombinacje | Kombinacje | 9 | Dla oferty pojedynczej oznaczamy Prosty produkt, dla oferty wielowariantowej Produkt z kombinacjami |
O czym warto pamiętać?
- Status zamówienia wysyłany z xSale do PrestaShop musi odpowiadać nazwie statusu dostępnej w PrestaShop. Integracja odszukuje status po nazwie.
- Numer listu przewozowego jest przekazywany do PrestaShop na zamówienie jako numer wysyłki.
- Sposoby dostawy i formy płatności powinny być zmapowane w konfiguracji integracji. Bez mapowania xSale może nie przypisać właściwej wartości na zamówieniu.
- Przy pobieraniu zamówień xSale korzysta z danych adresu wysyłki i adresu rozliczeniowego. Jeżeli klient nie poda danych do faktury, na zamówieniu mogą zostać użyte dane adresowe z wysyłki.
- Punkt odbioru może być odczytywany z wiadomości lub danych przekazanych przez PrestaShop, jeżeli sposób dostawy pozwala go jednoznacznie rozpoznać.
- Import ofert z PrestaShop nie obejmuje ofert wielowariantowych.
- PrestaShop Multistore nie jest obsługiwany przez integrację xSale.
Zrzuty xSale
Zrzuty PrestaShop
