Integracje

⌘K
  1. Strona główna
  2. Dokumentacja
  3. Integracje
  4. Sklep – Sky-Shop
  5. Zakres integracji Sky-Shop

Zakres integracji Sky-Shop

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 E-mail 13 Edycja Zamówienia  > Dane podstawowe E-mail 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 E-mail 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