Integracja ze SkyShop umożliwia dwukierunkową wymianę informacji pomiędzy xSale a SkyShop
Zakres informacji przesyłanych z xSale do Sky-Shop
- Opisy produktów
- Zdjęcia produktów (w zakresie dodawania zdjęć)
- Stany magazynowe
- Ceny
- Parametry na ofercie
- Status zamówienia – możliwość ustawienia statusu na zamówieniu w SkyShop po zmianie statusu zamówienia w 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 Sky-shop 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 Sky-Shop do xSale
- Zamówienia
- Płatności do pobranych zamówień
- Grupy i parametry
Szczegółowy zakres danych przesyłanych ze Sky-Shop do xSale:
Istnieje ograniczenie odnośnie ilości zapytań API po stronie SkyShop. Co może powodować wydłużenie czasu synchronizacji na linii xSale – SkyShop.
Zamówienia ze Sky-Shop 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 Sky-Shop 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ą.
| Obszar xSale | Pole xSale | nr | Obszar Sky-Shop | Pole Sky-Shop | nr | Uwagi |
| Edycja zamówienia > Formularz zamówienia | Data zakupu | 1 | Podgląd Nr zamówienia | Data zamówienia | 21 | Może być aktualizowana po zmianie na zamówieniu SkyShop |
| Edycja zamówienia > Formularz zamówienia | Status | 2 | Podgląd Nr zamówienia | Status | 24 | Status w SkyShop ustawiany według mapowania statusów na konfiguracji integracji |
| Edycja zamówienia > Formularz zamówienia | Zewnętrzny nr zamówienia | 3 | Podgląd Nr zamówienia | Nr zamówienia | 20 | |
| Edycja zamówienia > Formularz zamówienia | Dostawa | 4 | Podgląd Nr zamówienia | Rodzaj dostawy | 22 | Pole mapowane według mapowania płatności na integracji |
| Edycja zamówienia > Formularz zamówienia | Płatność | 5 | Podgląd Nr zamówienia | Metoda płatności | 23 | Pole mapowane według mapowania dostaw na integracji |
| Edycja zamówienia > Formularz zamówienia | Uwagi | 6 | Edycja Zamówienia > Dane podstawowe > Notatki zamówienia | Uwagi Klienta | 5 | |
| Edycja zamówienia > Formularz zamówienia | Punkt odbioru | 8 | Podgląd Nr Zamówienia | Rodzaj dostawy | 22 | W przypadku wybrania dostawy do punktu odbioru pole wyświetla oprócz nazwy dostawy kod punktu odbioru |
| Edycja zamówienia > Formularz adresu > Odbiorca | Nazwa | 9 | Edycja Zamówienia > Dane podstawowe > Dane adresowe do wysłania przesyłki | Imię i Nazwisko lub Nazwa firmy | 6 | |
| Edycja zamówienia > Formularz adresu > Odbiorca | NIP | 11 | Edycja Zamówienia > Dane do faktury VAT | NIP | 12 | |
| Edycja zamówienia > Formularz adresu > Odbiorca | Telefon | 12 | Edycja Zamówienia > Dane podstawowe | Kontakt telefon | 2 | |
| Edycja zamówienia > Formularz adresu > Odbiorca | 13 | Edycja Zamówienia > Dane podstawowe | 1 | |||
| Edycja zamówienia > Formularz adresu > Odbiorca | Miasto | 14 | Edycja Zamówienia > Dane podstawowe > Dane adresowe do wysłania przesyłki | Miasto | 8 | |
| Edycja zamówienia > Formularz adresu > Odbiorca | Ulica | 15 | Edycja Zamówienia > Dane podstawowe > Dane adresowe do wysłania przesyłki | Ulica i nr domu | 10 | |
| Edycja zamówienia > Formularz adresu > Odbiorca | Kod pocztowy | 16 | Edycja Zamówienia > Dane podstawowe > Dane adresowe do wysłania przesyłki | Kod pocztowy | 9 | |
| Edycja zamówienia > Formularz adresu > Odbiorca | Kraj | 17 | Edycja Zamówienia > Dane podstawowe > Dane adresowe do wysłania przesyłki | Państwo | 7 | |
| Edycja zamówienia > Formularz adresu > Kupujący | Nazwa | 18 | Edycja Zamówienia > Dane podstawowe > Dane do faktury VAT | Nazwa firmy/Imię i Nazwisko | 11 | W przypadku, gdy klient w Sky-Shop nie poda danych do faktury pobierane są dane adresowe do wysłania przesyłki |
| Edycja zamówienia > Formularz adresu > Kupujący | NIP | 20 | Edycja Zamówienia > Dane podstawowe > Dane do faktury VAT | NIP | 12 | W przypadku, gdy klient w Sky-Shop nie poda danych do faktury pobierane są dane adresowe do wysłania przesyłki |
| Edycja zamówienia > Formularz adresu > Kupujący | Telefon | 21 | Edycja Zamówienia > Dane podstawowe | Telefon | 2 | |
| Edycja zamówienia > Formularz adresu > Kupujący | 22 | Edycja Zamówienia > Dane podstawowe | Adres e-mail | 1 | ||
| Edycja zamówienia > Formularz adresu > Kupujący | Miasto | 23 | Edycja Zamówienia > Dane podstawowe > Dane do faktury VAT | Miasto | 14 | W przypadku, gdy klient w Sky-Shop nie poda danych do faktury pobierane są dane adresowe do wysłania przesyłki |
| Edycja zamówienia > Formularz adresu > Kupujący | Ulica | 24 | Edycja Zamówienia > Dane podstawowe > Dane do faktury VAT | Ulica i nr domu | 16 | W przypadku, gdy klient w Sky-Shop nie poda danych do faktury pobierane są dane adresowe do wysłania przesyłki |
| Edycja zamówienia > Formularz adresu > Kupujący | Kod pocztowy | 25 | Edycja Zamówienia > Dane podstawowe > Dane do faktury VAT | Kod pocztowy | 15 | W przypadku, gdy klient w Sky-Shop nie poda danych do faktury pobierane są dane adresowe do wysłania przesyłki |
| Edycja zamówienia > Formularz adresu > Kupujący | Kraj | 26 | Edycja Zamówienia > Dane podstawowe > Dane do faktury VAT | Państwo | 13 | W przypadku, gdy klient w Sky-Shop nie poda danych do faktury pobierane są dane adresowe do wysłania przesyłki |
| Edycja zamówienia > Lista przedmiotów zamówienia | Kod | 30 | Edycja Zamówienia > Produkty | Symbol | 17 | Kod w xSale może być różny od symbolu produktu w SkyShop i jest uzależniony od kodu towaru podłączonego do oferty |
| Edycja zamówienia > Lista przedmiotów zamówienia | Oferta | 27 | Edycja Zamówienia > Produkty | Symbol | 17 | |
| Edycja zamówienia > Lista przedmiotów zamówienia | Brutto | 28 | Edycja Zamówienia > Produkty | Cena brutto Po rabacie lub Cena netto Po rabacie* | 19 lub 25 | * W przypadku gdy w instalatorze nie zaznaczono opcji Pobieraj ceny brutto |
| Edycja zamówienia > Lista przedmiotów zamówienia | Ilość | 29 | Edycja Zamówienia > Produkty | Ilość | 18 |
Szczegółowy zakres danych przesyłanych z xSale do Sky-Shop:
| Obszar xSale | Nazwa pola w xSale | nr | Obszar Sky-Shop | Nazwa pola w Sky-Shop | nr | Uwagi |
| Oferta -> Edycja -> Opis i nazwa oferty w poszczególnych językach | Nazwa (z języka domyślnego wybranego dla integracji) | 1 | Produkty > Lista produktów > Edycja > Dane podstawowe | Nazwa produktu | 1 | |
| Oferta -> Edycja -> Opis i nazwa oferty w poszczególnych językach | Opis (z języka domyślnego wybranego dla integracji) | 8 | Produkty > Lista produktów > Edycja > Opis | Opis rozszerzony | 9 | |
| Oferta -> Edycja -> Zdjęcia produktu | Zdjęcia produktu | 3 | Produkty > Lista produktów > Edycja > Zdjęcia | Zdjęcia | 8 | |
| Oferta -> Edycja -> Parametry | Parametry | 4 | Produkty > Lista produktów > Edycja > Parametry dodatkowe | Parametry dodatkowe | 10 | |
| Oferta -> Edycja -> Kanały sprzedaży -> Sky-Shop(Edycja) | Grupy | 7 | Produkty > Lista produktów > Edycja > Kategorie | Kategorie | 7 | Można przekazać tylko jedną grupę |
| Oferta -> Edycja -> Informacje dodatkowe o ofercie | Kod | 2 | Produkty > Lista produktów > Edycja > Dane podstawowe | Symbol | 2 | |
| Oferta -> Edycja -> Moduły – > Sky-Shop | Cena | 5 | Produkty > Lista produktów > Edycja > Dane podstawowe > Cena | Brutto | 4 | * Dla produktu bez wariantów |
| Oferta -> Edycja -> Moduły – > Sky-Shop | Stan magazynowy | 6 | Produkty > Lista produktów > Edycja > Dane podstawowe | Ilość | 5 | * Dla produktu bez wariantów |
| Oferta -> Edycja -> Warianty i ceny -> Edytuj | Stawka VAT | 13 | Produkty > Lista produktów > Edycja > Dane podstawowe > Cena | VAT | 3 | |
| Oferta -> Edycja -> Warianty i ceny -> Edytuj | Dane wariantu | 10 | Produkty > Lista produktów > Edycja > Dane podstawowe > Ilość > Magazyn > Parametr | Parametr np. Kolor | 11 | * Dotyczy produktu z wariantami według wybranego parametru np. Kolor, Rozmiar |
| Oferta -> Edycja -> Warianty i ceny -> Edytuj -> Cena | Cena | 11 | Produkty > Lista produktów > Edycja > Parametry dodatkowe > Parametr (Rozwiń) | Wpływ na cenę | 13 | Wartość pola Wpływ na cenę dla wariantów jest wyliczana jako różnica wartości przesłanej z xSale dla wariantu i wartości ceny dla produktu głównego w SkyShop |
| Oferta -> Edycja -> Warianty i ceny -> Edytuj -> Stany magazynowe | Stan magazynowy | 12 | Produkty > Lista produktów > Edycja > Dane podstawowe > Ilość > Magazyn | Ilość | 12 | Dla każdego wariantu stan magazynowy pobierany jest z towaru w xSale przypisanego do wariantu według magazynów ustawionych w konfiguracji integracji z SkyShop |
| Produkty > Lista produktów > Edycja > Dane podstawowe > Widoczność | Widoczność | 6 | Dla produktów dodawanych przez xSale ustawiamy automatycznie wartość na TAK |
Zrzuty xSale
Zrzuty Sky-Shop
















