Integracje

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

Zakres integracji Sky-Shop

Integracja z Sky-Shop umożliwia przesyłanie ofert, cen i stanów magazynowych z xSale do sklepu oraz pobieranie zamówień, płatności i słowników ze Sky-Shop. Kierunek i zakres synchronizacji zależą od konfiguracji integracji.

W tym artykule znajdziesz

Dane przesyłane z xSale do Sky-Shop

  • Nazwy i opisy produktów, kody, EAN, jednostki, producent i waga
  • Zdjęcia produktów (zastępowanie dotychczasowego zestawu)
  • Stany magazynowe
  • Ceny
  • Parametry na ofercie
  • Status zamówienia – przekazanie zmiany do Sky-Shop wymaga odpowiedniej konfiguracji synchronizacji lub procesu.

Powiązanie ofert i aktualizacja zdjęć

Jeśli oferta nie ma jeszcze zapisanego identyfikatora produktu Sky-Shop, integracja szuka produktu po kodzie oferty (symbolu w sklepie). Gdy znajdzie pasujący produkt, aktualizuje go zamiast tworzyć nowy. Jeśli go nie znajdzie, dodaje produkt. Przy istniejącym powiązaniu korzysta z identyfikatora produktu.

Różne oferty z tym samym kodem mogą więc aktualizować ten sam produkt w Sky-Shop. Stosuj jednoznaczne kody i sprawdź powiązania przed wysłaniem ofert.

Warto mieć to na uwadze podczas planowania struktury ofert w xSale, aby uniknąć niezamierzonych nadpisywań danych.

Nie zmieniaj kodów ofert i symboli produktów bez sprawdzenia powiązań. Może to wpłynąć na odnajdywanie produktów podczas synchronizacji.

Zdjęcia produktu

Przy wysyłaniu niepustego zestawu zdjęć integracja najpierw usuwa dotychczasowe zdjęcia produktu w Sky-Shop, a następnie dodaje pliki przekazane z xSale. Nie jest to wyłącznie dopisywanie nowych zdjęć. Przed synchronizacją upewnij się, że oferta w xSale zawiera cały zestaw, który ma pozostać w sklepie.

Jeśli przesyłanie zdjęć zakończy się błędem, sprawdź zestaw w xSale i wynik w Sky-Shop, usuń przyczynę błędu i ponów synchronizację zdjęć.

Dane pobierane ze Sky-Shop do xSale

  • Zamówienia
  • Płatności powiązane z zamówieniami według numeru Sky-Shop; data płatności, forma, waluta i kwota obejmująca produkty oraz dostawę
  • Kategorie oraz definicje parametrów i ich wartości

Szczegółowy zakres danych zamówień pobieranych ze Sky-Shop

Zapytania do sklepu są wykonywane kolejno, z przerwami między wywołaniami. Przy większej liczbie danych synchronizacja może potrwać dłużej.

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 Data zamówienia przekazana przez Sky-Shop. Sam import nie oznacza ciągłego aktualizowania daty po zmianach w sklepie.
Edycja zamówienia > Formularz zamówienia Status 2 Podgląd Nr zamówienia Status 24 Statusy Sky-Shop służą do wyboru zamówień do pobrania. Nie należy utożsamiać statusu w sklepie ze statusem nadanym zamówieniu w xSale. Przekazanie statusu z xSale do Sky-Shop jest osobną operacją.
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 Sposób dostawy jest powiązany zgodnie z mapowaniem dostaw w integracji.
Edycja zamówienia > Formularz zamówienia Płatność 5 Podgląd Nr zamówienia Metoda płatności 23 Forma płatności jest powiązana zgodnie z mapowaniem płatności w integracji.
Edycja zamówienia > Formularz zamówienia Uwagi 6 Edycja Zamówienia > Dane podstawowe > Notatki zamówienia Uwagi klienta i notatka administratora 5
Edycja zamówienia > Formularz zamówienia Punkt odbioru 8 Podgląd Nr Zamówienia Rodzaj dostawy 22 Kod punktu jest pobierany dla rozpoznanych dostaw do punktów i automatów, jeśli Sky-Shop przekazuje jego wartość. Zobacz obsługiwane punkty odbioru i warunki pobierania.
Zamówienie → Zamawiający → Odbiorca Nazwa 9 Edycja Zamówienia  > Dane podstawowe  > Dane adresowe do wysłania przesyłki Imię i Nazwisko lub Nazwa firmy 6
Zamówienie → Zamawiający → Odbiorca NIP 11 Edycja Zamówienia  > Dane do faktury VAT NIP 12
Zamówienie → Zamawiający → Odbiorca Telefon 12 Edycja Zamówienia  > Dane podstawowe Kontakt telefon 2
Zamówienie → Zamawiający → Odbiorca E-mail 13 Edycja Zamówienia  > Dane podstawowe E-mail 1
Zamówienie → Zamawiający → Odbiorca Miasto 14 Edycja Zamówienia  > Dane podstawowe  > Dane adresowe do wysłania przesyłki Miasto 8
Zamówienie → Zamawiający → Odbiorca Ulica 15 Edycja Zamówienia  > Dane podstawowe  > Dane adresowe do wysłania przesyłki Ulica i nr domu 10
Zamówienie → Zamawiający → Odbiorca Kod pocztowy 16 Edycja Zamówienia  > Dane podstawowe  > Dane adresowe do wysłania przesyłki Kod pocztowy 9
Zamówienie → Zamawiający → Odbiorca Kraj 17 Edycja Zamówienia  > Dane podstawowe  > Dane adresowe do wysłania przesyłki Państwo 7
Zamówienie → Zamawiający → Nabywca Nazwa 18 Edycja Zamówienia  > Dane podstawowe > Dane do faktury VAT Nazwa firmy/Imię i Nazwisko 11 Dane adresowe nabywcy pochodzą z danych do faktury. Gdy nazwa, miasto, kod pocztowy i ulica danych do faktury są jednocześnie puste, te dane są uzupełniane adresem dostawy. Nie dotyczy to automatycznego uzupełniania NIP.
Zamówienie → Zamawiający → Nabywca NIP 20 Edycja Zamówienia  > Dane podstawowe > Dane do faktury VAT NIP 12 Dane adresowe nabywcy pochodzą z danych do faktury. Gdy nazwa, miasto, kod pocztowy i ulica danych do faktury są jednocześnie puste, te dane są uzupełniane adresem dostawy. Nie dotyczy to automatycznego uzupełniania NIP.
Zamówienie → Zamawiający → Nabywca Telefon 21 Edycja Zamówienia  > Dane podstawowe Telefon 2
Zamówienie → Zamawiający → Nabywca E-mail 22 Edycja Zamówienia  > Dane podstawowe Adres e-mail 1
Zamówienie → Zamawiający → Nabywca Miasto 23 Edycja Zamówienia  > Dane podstawowe > Dane do faktury VAT Miasto 14 Dane adresowe nabywcy pochodzą z danych do faktury. Gdy nazwa, miasto, kod pocztowy i ulica danych do faktury są jednocześnie puste, te dane są uzupełniane adresem dostawy. Nie dotyczy to automatycznego uzupełniania NIP.
Zamówienie → Zamawiający → Nabywca Ulica 24 Edycja Zamówienia  > Dane podstawowe > Dane do faktury VAT Ulica i nr domu 16 Dane adresowe nabywcy pochodzą z danych do faktury. Gdy nazwa, miasto, kod pocztowy i ulica danych do faktury są jednocześnie puste, te dane są uzupełniane adresem dostawy. Nie dotyczy to automatycznego uzupełniania NIP.
Zamówienie → Zamawiający → Nabywca Kod pocztowy 25 Edycja Zamówienia  > Dane podstawowe > Dane do faktury VAT Kod pocztowy 15 Dane adresowe nabywcy pochodzą z danych do faktury. Gdy nazwa, miasto, kod pocztowy i ulica danych do faktury są jednocześnie puste, te dane są uzupełniane adresem dostawy. Nie dotyczy to automatycznego uzupełniania NIP.
Zamówienie → Zamawiający → Nabywca Kraj 26 Edycja Zamówienia  > Dane podstawowe > Dane do faktury VAT Państwo 13 Dane adresowe nabywcy pochodzą z danych do faktury. Gdy nazwa, miasto, kod pocztowy i ulica danych do faktury są jednocześnie puste, te dane są uzupełniane adresem dostawy. Nie dotyczy to automatycznego uzupełniania NIP.
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 Sky-Shop 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 Cena pozycji 28 Edycja Zamówienia  > Produkty Cena brutto Po rabacie lub Cena netto Po rabacie* 19 lub 25 Rodzaj ceny (brutto lub netto) wynika z oznaczenia cen na zamówieniu Sky-Shop. Integracja odczytuje również obie wartości osobno; dla waluty zamówienia uwzględnia kurs przekazany przez sklep.
Edycja zamówienia > Lista przedmiotów zamówienia Ilość 29 Edycja Zamówienia  > Produkty Ilość 18

Punkty odbioru i automaty paczkowe

xSale pobiera kod punktu odbioru z zamówień Sky-Shop, również gdy zamówienie pochodzi z Allegro i trafia do xSale za pośrednictwem sklepu. Kod jest zapisywany jako punkt dostawy w danych odbiorcy zamówienia.

Poniższy zakres dotyczy pobierania kodu punktu, a nie automatycznej dostępności nadawania przesyłek we wszystkich wymienionych usługach.

Sieć lub usługa Rozpoznawane dostawy do punktów i automatów
InPost Paczkomaty InPost, w tym Allegro Paczkomaty InPost i ERLI InPost Paczkomaty. Także Allegro International Automaty Paczkowe InPost, np. do Czech.
DPD DPD Pickup, Allegro Odbiór w Punkcie DPD Pickup oraz Allegro Automaty Paczkowe DPD, w tym warianty (AD) i dostawy do Czech, Słowacji i Węgier.
ORLEN Paczka / Paczka w Ruchu Dostawy z przypisaną funkcją punktów ORLEN/Paczki w Ruchu, Allegro Automat ORLEN Paczka oraz Allegro Odbiór w Punkcie ORLEN Paczka.
DHL Allegro Automat DHL BOX 24/7, Allegro Odbiór w Punkcie DHL i Allegro Automaty Paczkowe DHL, także warianty (AD) oraz zagraniczne.
Pocztex Allegro Automat Pocztex oraz dostawy zawierające w nazwie „Odbiór w Punkcie”.
Packeta Usługi z nazwą zawierającą „Odbiór w Punkcie” lub „- Automaty Paczkowe Packeta”, w tym wysyłka z Polski do Czech, Słowacji i Węgier oraz warianty z ORLEN Paczka.
Allegro One Allegro One Box (One Kurier, DPD, DHL, ORLEN Paczka) i Allegro One Punkt (One Kurier, DPD). Także Allegro International Automaty Paczkowe i Odbiór w Punkcie, m.in. Czechy i Słowacja oraz warianty „dostawa jutro”.

Rozpoznawanie dostawy opiera się na funkcji przypisanej do formy dostawy w Sky-Shop lub na rozpoznawanej nazwie usługi przekazanej z zamówieniem. Dla Paczkomatów InPost, DPD Pickup i ORLEN/Paczki w Ruchu właściwa funkcja pozwala pobrać punkt także wtedy, gdy sklep nadał dostawie własną nazwę, np. „Kurier DPD”. Sama nazwa kuriera nie wystarcza do rozpoznania dostawy do punktu. Wielkość liter w rozpoznawanej nazwie nie ma znaczenia.

Warunkiem pobrania punktu jest przekazanie jego kodu przez Sky-Shop. xSale odczytuje kod z początku danych metody wysyłki, przed pierwszym przecinkiem. Zachowuje cały identyfikator, jego prefiks i wielkość liter. Nie ustala punktu na podstawie samego adresu ani wyglądu kodu.

Jeśli kodu brakuje lub pierwsza część danych jest pusta, zamówienie zostaje pobrane bez punktu dostawy. Sam brak kodu nie blokuje pobierania pozostałych zamówień. Dla dostawy domowej lub nierozpoznanej usługi xSale nie zapisuje punktu tylko dlatego, że w danych wysyłki znajduje się niepusty tekst.

Szczegółowy zakres danych ofert 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 Cena pozycji 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 Sky-Shop
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 Sky-Shop
Produkty > Lista produktów > Edycja > Dane podstawowe > Widoczność Widoczność 6 Domyślnie produkt jest widoczny. Parametr „Widoczność” o wartości „NIE”, „0” lub „FALSE” powoduje jego ukrycie; „TAK”, „1” lub „TRUE” pozostawia widoczność włączoną.

Ceny wariantów

Wpływ wariantu na cenę jest różnicą między ceną wariantu a ceną produktu głównego. Różnica jest przypisywana do pierwszej cechy wariantu. Jeśli ta sama wartość pierwszej cechy wymaga różnych dopłat w kilku kombinacjach, integracja zgłosi błąd. Ujednolić należy dopłaty dla tej wartości albo rozdzielić produkty na osobne oferty.

Zrzuty xSale

Zrzuty Sky-Shop

Czego brakuje w tym artykule?