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
- zasady powiązania ofert i aktualizacji zdjęć
- dane pobierane ze Sky-Shop
- szczegółowy zakres danych zamówień
- obsługiwane punkty odbioru i automaty
- szczegółowy zakres danych ofert
- zrzuty xSale
- zrzuty Sky-Shop
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 | 13 | Edycja Zamówienia > Dane podstawowe | 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 | 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.

EN















