Zakres integracji IAI

Zakres informacji przesyłanych z xSale do IAI

• 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 IAI po zmianie statusu zamówienia w xSale
• Numer listu przewozowego.

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 IAI 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 IAI do xSale

• Zamówienia
• Płatności do pobranych zamówień
• Grupy
• Oferty 
  Uwaga!
  – Po pobraniu ofert i ich aktywowaniu „Kod zewnętrznego systemu” będzie przesyłany na pole „Kod wyświetlany na karcie towaru”. Obydwa kody będą wtedy takie same. 
  – Oferty muszą mieć wypełnione pole „Kod zewnętrznego systemu”.
  – Pobierane są tylko oferty pojedyncze. Oferty wielowariantowe trzeba wystawić z poziomu xSale. Oferty zgrupowane po stronie IdoSell nie są obsługiwane.  
  
  

Obsługiwane rodzaje ofert

W integracji z IdoSell warto rozróżnić dwa kierunki działania: pobieranie ofert z IdoSell do xSale oraz wysyłanie ofert z xSale do IdoSell.

Pobieranie ofert z IdoSell do xSale

Po stronie importu do xSale obsługiwane są wyłącznie oferty pojedyncze.

• oferty pojedyncze – są pobierane do xSale,
• oferty wielowariantowe – nie są pobierane z IdoSell do xSale,
• oferty zgrupowane po stronie IdoSell – nie są obsługiwane w imporcie.

Wysyłanie ofert z xSale do IdoSell

Oferty wielowariantowe należy przygotować i wystawiać z poziomu xSale. Oznacza to, że jeżeli chcesz pracować na ofercie wielowariantowej w tej integracji, jej konfiguracja powinna zostać wykonana po stronie xSale, a nie poprzez import gotowej struktury z IdoSell.

W praktyce oznacza to, że wpis opisuje dwa różne scenariusze:

• z IdoSell do xSale pobierane są tylko oferty pojedyncze,
• oferty wielowariantowe trzeba utworzyć i obsługiwać po stronie xSale.

Uwaga: Jeżeli w IdoSell produkt występuje jako oferta zgrupowana lub wielowariantowa, nie należy zakładać, że taka sama struktura zostanie automatycznie pobrana do xSale. W tym zakresie integracja obsługuje import tylko ofert pojedynczych.

Szczegółowy zakres danych przesyłanych z xSale do IAI:

xSale nie wspiera obsługi Multistore. Niektóre funkcje, potrzebne do obsługi kilku sklepów w ramach jednego IAI, mogą nie być obsługiwane.

Zakres wymienianych danych przy ofercie xSale > IAI: 

Warianty i cena > TowarKod6Podstawowe > IdentyfikacjaKod zewnętrznego systemu6Po tym kodzie odbywa się synchronizacja.

Obszar xSale	Pole xSale	nr	Obszar IAI	Pole IAI	nr	Uwagi
Opis i nazwa oferty w poszczególnych językach	Nazwa	1	Opisy	Nazwa towaru	1
Zdjęcia produktu	Zdjęcia produktu	2	Zdjęcia i załączniki	Zdjęcia domyślne	2	Pierwsze zdjęcie jest miniaturą.
Warianty i cena > VAT; Warianty i cena > Zestaw > VAT	Stawka VAT	3	Podstawowe > Podstawowe informacje	Stawka VAT	3
Parametry	Parametry	4	Podstawowe > Podstawowe informacje	Podstawowe informacje	4	Parametr znajduje się w Grupa główna\IAI_nazwastrony\Parametry
Informacje dodatkowe o ofercie	Kod	5	Podstawowe > Identyfikacja	Kod wyświetlany na karcie towaru	5
Warianty i cena > Towar	Kod	6	Podstawowe > Identyfikacja	Kod zewnętrznego systemu	6	Po tym kodzie odbywa się synchronizacja.
Warianty i cena > Towar	Wariant i cena	6 i 7	Podstawowe > Identyfikacja	Kod zewnętrznego systemu	6	Kod wariantu tworzony jest według schematu, Kod oferty Wartość parametru wielowariantowego. Dla pierwszego wariantu Kodem wariantu jest sam Kod oferty.
Warianty i cena > Dane wariantu	Dane wariantu	7	Podstawowe > Identyfikacja	Nazwa parametru (np. Rozmiar)	7
Warianty i cena > Cena; Warianty i cena > Zestaw > Cena	Cena; Stała cena	8	Ceny > Cennik podstawowy	Detaliczna	8	Można przekazywać tylko jedną cenę. Konieczne jest wybranie typu ceny jaki przekażemy do IAI w Kanale sprzedaży > Typ Ceny. Na ofercie może być wiele cen ale tylko jedną wybraną przekazujemy do aukcji.
Warianty i cena > Stany magazynowe	Ilość	9	Magazyn > Stany magazynowe i rezerwacje	Stan magazynowy	9	Do stanów jest dodawana ilość rezerwacji z IAI z magazynu, który jest ustawiony do synchronizacji.
Kanały sprzedaży i ceny > Grupy	Grupy	10	Widoczność i serwisy zewnętrzne > Przypisanie do węzłów menu	Przypisany węzeł menu	10	Można przypisać tylko jedno menu.
Parametry	Opis krótki	11	Opisy > Opisy	Opis krótki	11	Parametr znajduje się w Grupa główna\IAI_nazwastrony\Parametry
Opis i nazwa oferty w poszczególnych językach	Opis	12	Opisy > Opisy	Opisy	12
Informacje dodatkowe o ofercie; Parametry; Wariant i cena > Zestaw	EAN	13	Podstawowe > Identyfikacja	Kod producenta	13

Szczegółowy zakres danych przesyłanych z IAI do xSale:

Zamówienia z IAI 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 IAI 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 IAI	Pole IAI	nr	Uwagi
Edycja zamówienia > Formularz zamówienia	Zewnętrzny nr zamówienia	1	Edycja Zamówienia	Zamówienie nr	1
Edycja zamówienia > Formularz zamówienia	Data zakupu	2	Edycja Zamówienia > Detal	Data sprzedaży	2	Może się zmienić po aktualizacji zamówienia w IAI.
Edycja zamówienia > Formularz zamówienia	Płatność	3	Edycja Zamówienia > Wpłaty	Wpłaty	3	Wyświetlana nazwa w xSale zależy od mapowania form płatności. Jeśli w zamówieniu występuje dodatkowa opłata za płatność, to do listy przedmiotów zostanie dodana pozycja „OrderPayformCost” na kwotę dopłaty.
Edycja zamówienia > Formularz zamówienia	Dostawa	4	Edycja Zamówienia > Przesyłka	Kurier	4	Wyświetlana nazwa w xSale zależy od mapowania form dostawy.
Edycja zamówienia > Formularz zamówienia	Uwagi	5	Edycja Zamówienia > Notatka do zamówienia	Uwagi od klienta	20
Edycja zamówienia > Formularz zamówienia	List przewozowy	21	Edycja Zamówienia > Przesyłka	Numer paczki	21	Przekazywany po wygenerowaniu paczki w xSale. W IAI są dwa miejsca do których może być przekazywany numer listu przewozowego: – Numer przesyłki na całej przesyłce – Numer paczki na pojedynczej paczce. Dla niektórych kurierów jest wykorzystywane tylko jedno pole. xSale przesyła numer listu do obu pól.
Edycja zamówienia > Formularz zamówienia	Kurier / Punkt odbioru	27	Edycja Zamówienia > Dane klienta > Adres dostawy	Punkt odbioru	27	Punkty odbioru są pobierane dla rozpoznawanych usług InPost, DPD, Pocztex, DHL, ORLEN Paczka, GLS, UPS i Packeta, a także wybranych dostaw Allegro, odbioru w salonach Empik. Sam import punktu nie wymaga integracji kurierskiej w xSale. Sprawdź obsługiwane usługi i wymagania dotyczące nadania przesyłki.
Edycja zamówienia > Formularz adresu > Odbiorca	Odbiorca	11	Edycja Zamówienia > Dane klienta > Adres dostawy	Adres dostawy	11
Edycja zamówienia > Formularz adresu > Odbiorca	Nazwa 1	12	Edycja Zamówienia > Dane klienta > Adres dostawy	Nazwa Firmy	12	Jeżeli Nazwa Firmy nie jest wypełniona, to Nazwa osoby
Edycja zamówienia > Formularz adresu > Odbiorca	Nazwa 2	13	Edycja Zamówienia > Dane klienta > Adres dostawy	Nazwa osoby	13	Nazwa osoby jeżeli nie ma Nazwy Firmy. W przeciwnym wypadku pole puste.
Edycja zamówienia > Formularz adresu > Odbiorca	Telefon	33	Edycja Zamówienia > Dane klienta > Adres dostawy	Telefon	33
Edycja zamówienia > Formularz adresu > Odbiorca	E-mail	19	Edycja Zamówienia > Dane klienta > Adres dostawy	E-mail	19
Edycja zamówienia > Formularz adresu > Odbiorca	Miasto	16	Edycja Zamówienia > Dane klienta > Adres dostawy	Miasto	16
Edycja zamówienia > Formularz adresu > Odbiorca	Ulica	14	Edycja Zamówienia > Dane klienta > Adres dostawy	Adres	14
Edycja zamówienia > Formularz adresu > Odbiorca	Kod pocztowy	15	Edycja Zamówienia > Dane klienta > Adres dostawy	Kod pocztowy	15
Edycja zamówienia > Formularz adresu > Odbiorca	Kraj	30	Edycja Zamówienia > Dane klienta > Adres dostawy	Kraj	30
Edycja zamówienia > Formularz adresu > Kupujący	Kupujący	5	Edycja Zamówienia > Dane klienta > Dane bilingowe klienta	Dane bilingowe klienta	5
Edycja zamówienia > Formularz adresu > Kupujący	Nazwa	6	Edycja Zamówienia > Dane klienta > Dane bilingowe klienta	Nazwa	6
Edycja zamówienia > Formularz adresu > Kupujący	Nazwa 2	6	Edycja Zamówienia > Dane klienta > Dane bilingowe klienta	Nazwa 2	6
Edycja zamówienia > Formularz adresu > Kupujący	NIP	10	Edycja Zamówienia > Dane klienta > Dane bilingowe klienta	NIP	10
Edycja zamówienia > Formularz adresu > Kupujący	Telefon	17	Edycja Zamówienia > Dane klienta > Dane bilingowe klienta	Telefon	17
Edycja zamówienia > Formularz adresu > Kupujący	E-mail	19	Edycja Zamówienia > Dane klienta > Dane bilingowe klienta	E-mail	19
Edycja zamówienia > Formularz adresu > Kupujący	Miasto	9	Edycja Zamówienia > Dane klienta > Dane bilingowe klienta	Miasto	9
Edycja zamówienia > Formularz adresu > Kupujący	Ulica	7	Edycja Zamówienia > Dane klienta > Dane bilingowe klienta	Adres	7
Edycja zamówienia > Formularz adresu > Kupujący	Kod pocztowy	8	Edycja Zamówienia > Dane klienta > Dane bilingowe klienta	Kod pocztowy	8
Edycja zamówienia > Formularz adresu > Kupujący	Kraj	29	Edycja Zamówienia > Dane klienta > Dane bilingowe klienta	Kraj	29
Edycja zamówienia > Lista przedmiotów zamówienia	Nazwa	23	Edycja Zamówienia > Towary przypisane do zamówienia	Nazwa	23
Edycja zamówienia > Lista przedmiotów zamówienia	Kod	22	Edycja Zamówienia > Towary przypisane do zamówienia	Kod (rozmiar)	22	Brany pod uwagę jest „Kod zewnętrznego systemu” czyli kod wariantu.
Edycja zamówienia > Lista przedmiotów zamówienia	Brutto	25	Edycja Zamówienia > Towary przypisane do zamówienia	Cena jedn. brutto (z rabatem)	25	Kwota netto nie jest pobierana
Edycja zamówienia > Lista przedmiotów zamówienia	Ilość	24	Edycja Zamówienia > Towary przypisane do zamówienia	Ilość	24
Edycja zamówienia > Lista przedmiotów zamówienia	Transport brutto	28	Edycja Zamówienia > Towary przypisane do zamówienia	Koszt przesyłki	28
					34
Edycja zamówienia > Lista płatności	Data zakupu	31	Edycja Zamówienia > Wpłaty	Data transakcji	31	Jeśli zamówienie zostanie opłacone.
Edycja zamówienia > Lista płatności	Wartość	32	Edycja Zamówienia > Wpłaty	Kwota	32	Płatność może być wysłana na dowolny rejestr bankowy do Comarch XL i Optima. Dla każdej formy płatności (podanej w nawiasie) osobno [Link]

Parametry	IAI_Sklep	34	Edycja Zamówienia	Źródło zamówienia	34	Wartość jest wysyłana jako atrybut do zamówienia dla Comarch Optima i XL
Parametry	IAI_Typ_Zamowienia	35	Typ zamówienia	Źródło zamówienia	35	Atrybut przyjmuje dwie wartości.  DETAL: Zamówienie detaliczne ze sklepu HURT: Zamówienie hurtowe ze sklepu

Punkty odbioru pobierane z IAI do xSale

xSale pobiera punkt odbioru wskazany w zamówieniu IAI (IdoSell), jeśli rozpoznaje nazwę usługi dostawy, a IAI przekazuje identyfikator wybranego punktu. Dotyczy to również zamówień z marketplace, które trafiają do xSale za pośrednictwem IAI.

Obsługiwane sieci i usługi

• InPost — Paczkomaty InPost, w tym Allegro Paczkomaty 24/7 InPost. Ta obsługa była dostępna już wcześniej; nazwy zawierające słowo „paczkomat” są rozpoznawane również w dłuższych wariantach.
• DPD Pickup — „DPD – doręczenie do automatu” (także „do automatu paczkowego”) oraz „DPD – doręczenie do punktu odbioru”.
• Poczta Polska / Pocztex — „Poczta Polska Pocztex Kurier Doręczenie do automatu”, „Poczta Polska Pocztex Kurier Doręczenie do punktu odbioru”, „Poczta Polska Pocztex Kurier Doręczenie do automatu lub punktu odbioru” oraz „Pocztex Kurier z doręczeniem do punktu odbioru”.
• DHL — dostawy rozpoznawane jako „punkty DHL” oraz odpowiednie usługi punktowe Allegro opisane poniżej.
• ORLEN Paczka — usługi zawierające w nazwie „ORLEN”. Rozpoznawana jest również wcześniejsza nazwa „Paczka w Ruchu”.
• GLS — „GLS – dostawa do punktu”.
• UPS — „UPS Standard Access Point”.
• Packeta — „Packeta – punkty odbioru (Polska)” oraz „Packeta – DE Hermes PP (Polska)”.
• Odbiór w salonie Empik — „DPD Dostawa do salonu Empik”. Obsługiwane są też wymienione wyżej nazwy GLS i Pocztex używane przy zamówieniach z Empik przekazywanych przez IAI.

Punktowe dostawy Allegro przekazywane przez IAI

Obsługa obejmuje także rozpoznawane w IAI warianty następujących usług:

• Allegro One Box i Allegro One Punkt — warianty z UPS, DPD i One Kurier, a także One Box z dostawą na dzisiaj oraz warianty z ORLEN Paczka.
• Dostawy w Polsce — Allegro Automat DPD Pickup, Allegro Automat Pocztex, Allegro Automat DHL BOX 24/7 (także AD), Allegro Automat ORLEN Paczka oraz odpowiadające im usługi „Odbiór w Punkcie”.
• Packeta z Polski do Czech, Słowacji i Węgier — odbiór w punktach i automatach, także warianty z Pocztą Polską i ORLEN Paczka oraz nazwy dla allegro.cz, allegro.sk i allegro.hu.
• DPD w Czechach i na Węgrzech — wskazane w IAI usługi Allegro do automatów; dla Węgier również „Odbiór w Punkcie DPD Pickup” i warianty allegro.hu.
• Allegro International One i InPost — odbiór w punktach i automatach w Czechach oraz warianty słowackie dla allegro.sk. Dla One w Czechach rozpoznawany jest również wariant „dostawa jutro” dla allegro.cz.

Zakres dotyczy dostaw do punktów i automatów, a nie wszystkich usług wymienionych przewoźników. Sama nazwa kuriera, np. „DPD”, nie wystarcza. xSale rozpoznaje usługę po nazwie przekazanej przez IAI, w tym po określeniach „paczkomat”, „odbiór w punkcie” i nazwach wymienionych powyżej. Dowolnie zmieniona nazwa może nie zostać rozpoznana.

Czy trzeba dodać integrację z kurierem w xSale?

Do pobrania i zapisania punktu na zamówieniu nie trzeba wcześniej dodawać integracji z kurierem w xSale. Potrzebna jest działająca integracja IAI oraz dane punktu przekazane w zamówieniu.

Do wygenerowania etykiety w xSale potrzebne są skonfigurowana integracja obsługująca daną usługę oraz właściwie przypisany sposób dostawy. Może to być połączenie z kurierem albo z usługą pośredniczącą w nadaniu, zależnie od sposobu wysyłki. Pobranie punktu z IAI nie oznacza automatycznie, że xSale obsługuje generowanie etykiet dla każdej z wymienionych usług.

W części konfiguracji identyfikator punktu używany przez IAI różni się od kodu wymaganego przez przewoźnika. Dla wskazanych sposobów dostawy integracja może dodatkowo pobierać z IAI zewnętrzny identyfikator punktu. Jeśli punkt nie pojawia się na zamówieniu albo przewoźnik odrzuca jego kod, przekaż wsparciu xSale numer zamówienia i pełną nazwę sposobu dostawy z IAI. Pozwoli to sprawdzić rozpoznawanie usługi oraz konfigurację pobierania właściwego kodu.

Zrzuty IAI