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.

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	W przypadku niektórych integracji kurierskich. W xSale konieczne jest dodanie integracji z danym kurierem.
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

Zrzuty IAI