EN
Integracja z Shoper umożliwia dwukierunkową wymianę informacji pomiędzy xSale a Shoper.
W tym artykule znajdziesz
- zasady wyboru języka synchronizacji i ograniczenia dotyczące punktów dostawy
- zakres informacji przesyłanych z xSale do Shoper
- sposób działania dla ofert z tym samym kodem SKU
- zakres informacji pobieranych z Shoper do xSale
- jak działają zmiany kategorii w Shoper po synchronizacji do xSale
- szczegółowy zakres danych przesyłanych z Shoper do xSale
Język synchronizacji
Integracja nie jest ograniczona do języka polskiego. Import i eksport korzystają z jednego, wspólnego języka wybranego na początku połączenia ze sklepem spośród aktywnych języków Shoper. Nie oznacza to synchronizacji wszystkich tłumaczeń jednocześnie ani automatycznego tłumaczenia treści.
O wyborze decyduje język zapisany w konfiguracji integracji. Pełny kod, np. de_DE, wskazuje konkretną wersję językową. Skrócony kod, np. de, może być użyty tylko wtedy, gdy jednoznacznie wskazuje jedną z dostępnych wersji. Działanie zostało zweryfikowane dla języka niemieckiego (de_DE); nie jest to deklaracja obsługi wszystkich języków Shoper.
Jeżeli język integracji nie jest ustawiony, system próbuje dobrać wersję polską lub czeską na podstawie kraju integracji. Gdy nie może jej dobrać, użyje jedynego aktywnego języka sklepu, o ile jest tylko jeden. Przy kilku możliwościach trzeba jednoznacznie skonfigurować język integracji. Jeśli nie masz dostępu do tego ustawienia, skontaktuj się z Helpdeskiem xSale.
Brak wymaganego tłumaczenia zatrzymuje operację, która go potrzebuje. Integracja nie przełącza się wtedy na inny język. Uzupełnij tłumaczenie wskazane w komunikacie lub popraw konfigurację języka, a następnie ponów synchronizację. Zobacz jak rozwiązać problem z językiem i tłumaczeniami.
Punkty dostawy a język sklepu
Starszy mechanizm odczytu dodatkowych pól punktów odbioru nadal rozpoznaje polskie nazwy w tłumaczeniu pl_PL: „Punkt odbioru”, „Typ punktu odbioru” i „Kod punktu odbioru”. Wybór innego języka synchronizacji nie zmienia automatycznie tego mapowania. Obcojęzyczne odpowiedniki wymagają osobnego dopasowania; uzgodnij je z Helpdeskiem xSale i sprawdź punkt dostawy na przykładowym pobranym zamówieniu.
Zakres informacji przesyłanych z xSale do Shoper
- Opisy produktów
- Zdjęcia produktów (w zakresie dodawania zdjęć)
- Stany magazynowe (do Shopera wysyłana jest jedna wartość stanu, obliczana na podstawie magazynów wskazanych w konfiguracji integracji)
- Ceny
- Parametry na ofercie (z wyłączeniem parametrów z mapowania)
- Jednostki główne i pomocnicze (nazwa jednostki + przelicznik)
- Wymiary (waga, wysokość, szerokość i długość)
- Status zamówienia – możliwość ustawienia statusu na zamówieniu w Shoper po zmianie statusu zamówienia w xSale.
- Aktywne oferty
Opis i formatowanie HTML: opis z xSale jest przekazywany do sklepu jako opis produktu. Jeżeli w opisie użyto formatowania HTML, np. pogrubienia, akapitów albo list, xSale przekazuje tę treść dalej. Ostateczny wygląd opisu zależy jednak od szablonu i ustawień sklepu.
Kolejność zdjęć produktów wyświetlanych w sklepie Shoper zależy od ustawienia opcji „Czy synchronizować zdjęcia produktów do Shoper?” w integratorze. Po jej aktywacji, zdjęcia w Shoper będą automatycznie uporządkowane zgodnie z kolejnością określoną w ofercie systemu xSale.
Sposób działania dla ofert z tym samym kodem 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 Shoper 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.
| 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. Modyfikacja może spowodować utratę powiązania i błędne działanie synchronizacji. |
Zakres informacji pobieranych z Shoper do xSale
- Zamówienia
- Płatności do pobranych zamówień
- Grupy i parametry (raz na dobę)
- Oferty (z wyłączeniem wielowariantowych i zestawów)
Zamówienia są importowane do xSale zawsze w walucie bazowej sklepu (PLN).
Zmiany kategorii w Shoper
Kategorie z Shoper są pobierane do xSale razem z grupami i parametrami. Synchronizacja odbywa się raz na dobę, dlatego zmiany wykonane w panelu Shoper mogą być widoczne w xSale dopiero po najbliższej synchronizacji, zwykle do 24 godzin.
Zmiana nazwy kategorii
Jeżeli w Shoper zmienisz nazwę kategorii, w xSale zostanie zaktualizowana ta sama kategoria.
Na ofertach, które korzystają z tej kategorii, nazwa również zostanie podmieniona automatycznie. W takim przypadku nie trzeba ręcznie zmieniać kategorii na ofertach.
Dodanie nowej kategorii
Jeżeli w Shoper dodasz nową kategorię, zostanie ona pobrana do xSale po najbliższej synchronizacji grup i parametrów, zwykle do 24 godzin.
Zmiana miejsca podkategorii w drzewie
Jeżeli w Shoper przeniesiesz podkategorię w inne miejsce drzewa, xSale potraktuje to jako zmianę lokalizacji kategorii.
- Poprzednia lokalizacja kategorii zostanie oznaczona jako archiwalna. W panelu xSale może być widoczna jako wyszarzona i nie będzie dostępna do wyboru przy nowych zmianach na ofertach.
- Ta sama podkategoria zostanie pobrana w nowym miejscu drzewa kategorii.
- Oferty, które były wcześniej przypisane do starej lokalizacji kategorii, nie zostaną automatycznie przepięte na nową lokalizację.
Jeżeli oferta ma dalej korzystać z przeniesionej podkategorii, trzeba ręcznie lub operacjami seryjnymi wybrać na niej kategorię z nowej lokalizacji.
Kategoria główna
Dla kategorii głównej zmiana nazwy i dodanie nowej kategorii działają analogicznie: nazwa zostanie zaktualizowana, a nowa kategoria pojawi się po najbliższej synchronizacji.
Zmiana miejsca kategorii głównej w Shoper nie powoduje zmiany jej położenia w xSale. Kategoria główna pozostaje w xSale w tym samym miejscu.
Szczegółowy zakres danych przesyłanych z Shoper do xSale
Zamówienia z Shoper są przekazywane do xSale jako „Zamówienie sprzedaży”. Poniżej opisujemy sposób i zakres przesyłanych pól.
Tabela zawiera odpowiedniki pól z xSale i Shoper wraz z nazwami tych pól w danych systemach oraz numer pola, którym oznaczone jest ono na zrzutach w galerii znajdujących się pod tabelą.
Typ dokumentu nie jest pobierany do xSale na zamówienie. Dla integracji z Shoper w zamówieniu w xSale w polu rodzaj faktury zawsze będzie pojawiała się wartość faktura.
| Obszar xSale | Pole xSale | nr | Obszar Shoper | Pole Shoper | nr | Uwagi | ||||||
| Edycja zamówienia > Formularz zamówienia | Data zakupu | 1 | Edycja Zamówienia > Dane podstawowe > Informacje podstawowe | Data złożenia | 20 | Data może być aktualizowana w xSale po zmienie na zamówieniu w Shoper. | ||||||
| Edycja zamówienia > Formularz zamówienia | Sposób dostawy | 4 | Edycja Zamówienia > Dane podstawowe > Płatność i dostawa | Sposób dostawy | 25 | Pole mapowane według mapowania dostaw na integracji. | ||||||
| Edycja zamówienia > Formularz zamówienia | Forma płatności | 5 | Edycja Zamówienia > Dane podstawowe > Płatność i dostawa | Metoda płatności | 24 | Pole mapowane według mapowania płatności na integracji. | ||||||
| Edycja zamówienia > Formularz zamówienia | Kurier | 7 | Edycja Zamówienia > Dane podstawowe > Płatność i dostawa | Sposób dostawy | 25 | Pole mapowane według mapowania dostaw na integracji. | ||||||
| Punkt dostawy | 26a | *W przypadku korzystania z dodatkowej wtyczki Orlen Paczka, pobierany jest tylko kod punktu odbioru. | ||||||||||
| Edycja zamówienia > Lista przedmiotów zamówienia | Kod oferty | 30 | Edycja Zamówienia > Dane klienta> Zamówione produkty | Kod produktu | 27 | Kod w xSale może być różny od Kodu produktu w Shoper i jest uzależniony od kodu towaru podłączonego do oferty. | ||||||
| Od pozycji „Cena” jest obliczany ewentualny rabat procentowy.
|
||||||||||||
| Towar -> Edycja -> Podstawowe | Jednostka główna | 31 | Edycja Zamówienia > Dane klienta> Zamówione produkty | Jednostka miary | 28 | Ustalane według mapowania jednostek na konfiguracji integracji. |
Szczegółowy zakres danych przesyłanych z xSale do Shoper
| Obszar xSale | Nazwa pola w xSale | nr | Obszar Shoper | Nazwa pola w Shoper | nr | Uwagi | Oferta -> Edycja -> Opis i nazwa oferty w poszczególnych językach | Nazwa (z języka domyślnego wybranego dla integracji) | 1 | Produkty > Edycja > Dane podstawowe | Nazwa | 1 | ||
| Oferta -> Edycja -> Parametry | Parametry | 4 | Produkty > Edycja > Atrybuty | Parametr np. | Kolor | 12 | Parametry pobierane są raz na dobę. | |||||||
| Produkty > Edycja > Dane podstawowe | Jednostka główna, Jednostka pomocnicza | link | Jednostka w Shoperze jest ustalana na podstawie jednostki towaru oraz mapowania jednostek. | |||||||||||
| Szczegóły | ||||||||||||||
| Oferta -> Edycja -> Kanały sprzedaży -> Shoper(Edycja) | Kategoria | 7 | Produkty > Edycja > Dane podstawowe | Kategoria główna | 6 | Grupy pobierane są raz na dobę. | ||||||||
| Dla produktu bez wariantów. xSale przesyła tylko jedną wartość cenową dla jednego produktu.
W przypadku ustawienia w sklepie kilku cen (przedziałów cenowych) synchronizowana jest tylko cena podstawowa. Pozostałe ceny np. Hurtowa 1, Hurtowa 2 nie są przesyłane przez xSale. Nie są jednak nadpisywane i można ustawić je z poziomu panelu sklepowego. |
||||||||||||||
| Oferta -> Edycja -> Kanały sprzedaży – > Shoper | Stan magazynowy | 6 | Produkty > Edycja > Dane podstawowe | Stan magazynowy | 5 | Dla produktu bez wariantów | ||||||||
| Oferta -> Edycja -> Towary i warianty -> rozwiń wariant (+) | Dane wariantu | 10 | Produkty > Edycja > Warianty | Wybrana grupa wariantów np. Rozmiar, Kolor | 9 | Dotyczy produktu z wariantami według wybranego parametru np. Kolor, Rozmiar. Wariant użyty do tworzenia oferty musi być z obsługą stanów magazynowych. | ||||||||
| Przekazywanie stanów niecałkowitych jest możliwe po ustawieniu w Shoper odpowiedniej jestnostki np. kg, opak. itp. W xSale można ustawić zaokrąglanie stanów do liczb całkowitych. | ||||||||||||||
| Oferta -> Edycja -> Towary i warianty -> rozwiń wariant (+) | Kod | 14 | Produkty > Edycja > Warianty > Stan magazynowy > Akcje > Edytuj | Kod wariantu (produktu) | 10 | Pole kod wariantu (produktu) uzupełniane jest polem Kod z xSale. | ||||||||
| Oferta -> Edycja -> Kanały sprzedaży – > Shoper | Status (kropka) | 16 | Produkty > Edycja > Dane podstawowe | Aktywność | 3 | Pole automatycznie zaznaczone | Towar -> Edycja -> Podstawowe | Waga | 32 | Produkty -> Edycja -> Dane podstawowe | Waga | 30 | Wartość w kilogramach | Towar -> Edycja -> Podstawowe | Szerokość | 33 | Produkty -> Edycja -> Dostawa – > Wymiary produktu | Szerokość | 31 | Wartość w centymetrach | Towar -> Edycja -> Podstawowe | Wysokość | 34 | Produkty -> Edycja -> Dostawa – > Wymiary produktu | Wysokość | 32 | Wartość w centymetrach | Towar -> Edycja -> Podstawowe | Długość | 35 | Produkty -> Edycja -> Dostawa – > Wymiary produktu | Długość | 33 | Wartość w centymetrach |
Zrzuty xSale
Zrzuty Shoper
