Zakres integracji z Allegro

Integracja z Allegro umożliwia dwukierunkową wymianę informacji pomiędzy xSale a Allegro.

Jakie dane xSale pobiera z Allegro?

Grupy i parametry
Zamówienia (również te z rynków dodatkowych)
Płatności do zamówień (Płatność odroczona nie jest pobierana)
Aukcje wystawione poza xSale (łącznie z załącznikami do oferty i produktami Allegro).
Import aukcji z Allegro do xSale odbywa się wyłącznie dla ofert z dodatnim stanem magazynowym oraz oznaczonych jako „Kup teraz”.

Do xSale nie są importowane oferty z Allegro, które mają zerowy stan magazynowy, są wystawione jako licytacja lub pochodzą z serwisu „Allegro Lokalnie”.

Jakie informacje xSale wysyła do Allegro?

Wystawianie aukcji (opis, zdjęcia, parametry)
Stany magazynowe na wystawionych aukcjach
Synchronizacja ceny na wystawionych aukcjach
Numer listu przewozowego wygenerowany do zamówienia w xSale
- - Integracja przekazuje tylko jeden numer listu przewozowego. W przypadku gdy do zamówienia wygenerowano więcej niż jedną paczkę system przekaże tylko jeden numer listu do Allegro.
Status zamówienia
Dokument faktury (plik musi być dodany bezpośrednio w zamówieniu)

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

W przypadku posiadania tylko jednej integracji z Allegro (rynek bazowy PL) wszystkie zamówienia zarówno z rynków dodatkowych jak i bazowego będą jako źródło wyświetlały integrację główną.

Po dodaniu do xSale rynków dodatkowych w źródle zamówienia będzie dokładnie widoczna integracja, z której pochodzi to zamówienie.

W zamówieniu z rynku dodatkowego będzie również widoczna informacja dotycząca kraju zamówienia oraz waluty.

Zamówienia z Allegro są przekazywane do xSale jako „Zamówienie sprzedaży”. Poniżej opisujemy sposób i zakres przesyłanych pól.

Podczas pobierania aukcji z Allegro nie pobieramy wartości dla parametrów customowych. Możliwe jest jednak ustawienie takich wartości z poziomu xSale.

Podczas pobierania oferty z Allegro kod EAN umieszczony w parametrze zostaje przepisany to pola „EAN” na ofercie w xSale.

xSale nie obsługuje kilku katalogów Allegro dla jednej oferty. Dlatego możemy pobrać z Allegro ofertę będącą zestawem. Jednak nie pobierzemy parametrów i produktu Allegro dla takiej oferty. Do oferty będzie można podpiąć tylko jeden katalog Allegro. Aktywowanie takiej oferty spowoduje rozłączenie zestawu po stronie Allegro.

xSale nie obsługuje odrębnych parametrów dla rynków dodatkowych, np. „Opcji dodatkowych”. Wszystkie parametry oferty pobierane są z rynku bazowego i wykorzystywane również na przypisanych do niego rynkach dodatkowych.

Tabela zawiera odpowiedniki pól z xSale i Allegro 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 Allegro	Pole Allegro	nr	Uwagi
Edycja zamówienia > Formularz zamówienia	Data zakupu	27	Szczegóły zamówienia > Płatność	Data płatności	27	Zależy od daty płatności
Edycja zamówienia > Formularz zamówienia	Termin wysyłki	30	Szczegóły zamówienia > Płatność	Czas na wysłanie	30
Edycja zamówienia > Formularz zamówienia	Zewnętrzny nr zamówienia	1	Szczegóły zamówienia	Numer zamówienia	1
Edycja zamówienia > Formularz zamówienia	Płatność	28	Szczegóły zamówienia > Płatność	Operacja	28	Wyświetlana nazwa w xSale zależy od mapowania form płatności.
Edycja zamówienia > Formularz zamówienia	Dostawa	6	Szczegóły zamówienia	Metoda dostawy	6	Wyświetlana nazwa w xSale zależy od mapowania form dostawy
Edycja zamówienia > Formularz zamówienia	Uwagi	5	Szczegóły zamówienia > Przedmioty	Wiadomości od kupującego	5
Edycja zamówienia > Formularz zamówienia	List przewozowy	12	Szczegóły zamówienia	Przesyłka	12	Może być przekazany z xSale do Allegro
Edycja zamówienia > Formularz zamówienia	Status	28	Szczegóły zamówienia	Status zamówienia	28	Może być przekazany z xSale do Allegro
Edycja zamówienia > Formularz zamówienia	Rodzaj faktury	25	Szczegóły zamówienia	NIP	25	W zależności czy klient wypełni pole NIP
Edycja zamówienia > Formularz zamówienia	Kurier	11	Szczegóły zamówienia	Przesyłka	11	W nazwie formy dostawy. W przypadku niektórych integracji kurierskich. W xSale konieczne jest dodanie integracji z danym kurierem w ShipmentTask.
Edycja zamówienia > Formularz zamówienia	Punkt odbioru	8	Szczegóły zamówienia	Metoda dostawy	8	W nazwie formy dostawy. W przypadku niektórych integracji kurierskich. W xSale konieczne jest dodanie integracji z danym kurierem w ShipmentTask.

Edycja zamówienia > Formularz adresu > Odbiorca	Nazwa	13	Szczegóły zamówienia > Dane odbiorcy	Dane odbiorcy	13	Pola Imię, Nazwisko, Nazwa firmy są łączone w jedno.
Edycja zamówienia > Formularz adresu > Odbiorca	Telefon	18	Szczegóły zamówienia > Dane odbiorcy	Dane odbiorcy	18
Edycja zamówienia > Formularz adresu > Odbiorca	E-mail	10	Szczegóły zamówienia > Kupujący	Kopiuj E-Mail	10	Dane kupującego nie są w xSale. Jak klient nie wypełni pola Faktura to w xSale uzupełniamy danymi odbiorcy.
Edycja zamówienia > Formularz adresu > Odbiorca	Miasto	16	Szczegóły zamówienia > Dane odbiorcy	Dane odbiorcy	16
Edycja zamówienia > Formularz adresu > Odbiorca	Ulica	14	Szczegóły zamówienia > Dane odbiorcy	Dane odbiorcy	14
Edycja zamówienia > Formularz adresu > Odbiorca	Kod pocztowy	15	Szczegóły zamówienia > Dane odbiorcy	Dane odbiorcy	15
Edycja zamówienia > Formularz adresu > Odbiorca	Kraj	17	Szczegóły zamówienia > Dane odbiorcy	Dane odbiorcy	17

Edycja zamówienia > Formularz adresu > Kupujący	Nazwa	20	Szczegóły zamówienia > Dane odbiorcy / Faktura	Dane odbiorcy lub Faktura	20	Pola Imię, Nazwisko, Nazwa firmy są łączone w jedno. Jeśli klient nie uzupełni pola „Faktura” to dane są uzupełniane z pól „Dane odbiorcy”
Edycja zamówienia > Formularz adresu > Kupujący	NIP	25	Szczegóły zamówienia > Dane odbiorcy / Faktura	Dane odbiorcy lub Faktura	25	Jeśli klient nie uzupełni pola „Faktura” to dane są uzupełniane z pól „Dane odbiorcy”
Edycja zamówienia > Formularz adresu > Kupujący	Telefon	29	Szczegóły zamówienia > Kupujący	Kupujący	29
Edycja zamówienia > Formularz adresu > Kupujący	E-mail	10	Szczegóły zamówienia > Kupujący	Kopiuj E-Mail	10
Edycja zamówienia > Formularz adresu > Kupujący	Miasto	23	Szczegóły zamówienia > Dane odbiorcy / Faktura	Dane odbiorcy lub Faktura	23	Jeśli klient nie uzupełni pola „Faktura” to dane są uzupełniane z pól „Dane odbiorcy”
Edycja zamówienia > Formularz adresu > Kupujący	Ulica	21	Szczegóły zamówienia > Dane odbiorcy / Faktura	Dane odbiorcy lub Faktura	21	Jeśli klient nie uzupełni pola „Faktura” to dane są uzupełniane z pól „Dane odbiorcy”
Edycja zamówienia > Formularz adresu > Kupujący	Kod pocztowy	22	Szczegóły zamówienia > Dane odbiorcy / Faktura	Dane odbiorcy lub Faktura	22	Jeśli klient nie uzupełni pola „Faktura” to dane są uzupełniane z pól „Dane odbiorcy”
Edycja zamówienia > Formularz adresu > Kupujący	Kraj	24	Szczegóły zamówienia > Dane odbiorcy / Faktura	Dane odbiorcy lub Faktura	24	Jeśli klient nie uzupełni pola „Faktura” to dane są uzupełniane z pól „Dane odbiorcy”

Edycja zamówienia > Lista przedmiotów zamówienia	Nazwa	2	Szczegóły zamówienia > Przedmioty	Nazwa aukcji	2
Edycja zamówienia > Lista przedmiotów zamówienia	Suma	26	Szczegóły zamówienia > Płatności	Kwota	26	Możliwe jest pobranie Identyfikatora Płatności Allegro przez API xSale metodą /{organizationName}/payment/{id}
Edycja zamówienia > Lista przedmiotów zamówienia	Brutto	4	Szczegóły zamówienia > Przedmioty	Cena	4
Edycja zamówienia > Lista przedmiotów zamówienia	Ilość	3	Szczegóły zamówienia > Przedmioty	Ilość sztuk	3
Edycja zamówienia > Lista przedmiotów zamówienia	Transport brutto	7	Szczegóły zamówienia > Metoda dostawy	Metoda dostawy	7

Edycja zamówienia > Parametry	Allegro Smart	9	Szczegóły zamówienia > Metoda dostawy	Smart	9
Edycja zamówienia > Parametry	Zam ilość paczek	19	Szczegóły zamówienia > Metoda dostawy	Przesyłki	19
Lista zamówień	Login kupującego (Login Marketplace)	31	Szczegóły zamówienia > Kupujący	Kupujący	31	Login marketplace jest wyświetlany także w szczegółach zamówienia

Szczegółowy zakres danych przesyłanych z xSale do Allegro

Obszar xSale	Pole xSale	nr	Obszar Allegro	Pole Allegro	nr	Uwagi
Edycja oferty > Opis	Nazwa	1	Tytuł i kategoria	Tytuł	1	Nazwa z oferty w xSale pobierana jest z zakładki języka ustawionego jako domyślny dla integracji z Allegro
Edycja oferty > Kanały sprzedaży > Edycja przy Allegro	Kategoria	2	Tytuł i kategoria	Kategoria	2
Edycja oferty > Parametry; Edycja oferty >Towary i warianty > Kod EAN	EAN; Kod EAN	3	Parametry produktu	EAN	3	Uzupełnienie EAN w jednym z dwóch miejsc spowoduje przesłanie go do Allegro. Priorytet ma uzupełnienie EAN w parametrach.
Edycja oferty > Parametry	Parametry	4	Pozostałe parametry	Numer katalogowy producenta	4
Edycja oferty > Parametry	Stan	5	Pozostałe parametry	Stan	5
Edycja oferty > Zdjęcia	Zdjęcia produktu	6	Zdjęcia i opis przedmiotu	Zdjęcia	6
Edycja oferty > Opis	Opis	7	Zdjęcia i opis przedmiotu	Opis przedmiotu	7	Opis oferty pobierany jest z zakładki języka ustawionego jako domyślny dla integracji z Allegro
Edycja oferty > Dane podstawowe Allegro	Opcje faktury	8	Formaty sprzedaży	Opcje faktury	8
Edycja oferty prostej >Towary i warianty > Stawka VAT; Edycja oferty zestaw>Towary i warianty > Stawka VAT zestawu	Stawka VAT; Stawka VAT zestawu	9; 9	Formaty sprzedaży	Stawka VAT	9	Stawka VAT jest wysyłana tylko dla konta Allegro.PL. Vat 0% jest traktowany jako brak VAT i nie jest wysyłany do Allegro. Stawka VAT dla oferty prostej jest przekazywana z towaru.
Edycja oferty prostej>Towary i warianty > Cena; Edycja oferty zestaw >Towary i warianty > Stała cena zestawu	Cena; Stała cena	10; 10	Formaty sprzedaży	Cena	10	Konieczne jest wybranie typu ceny jaki przekażemy do Allegro w Kanale sprzedaży > Typ Ceny. Na ofercie może być wiele cen ale tylko jedną wybraną przekazujemy do aukcji.
Edycja oferty >Towary i warianty > Stan magazynowy	Ilość	11	Formaty sprzedaży	Liczba sztuk	11	Stany mogą być przekazywane z wybranych magazynów. W przypadku zestawów ilość dostępnych zestawów wyliczana jest na podstawie ilości dostępnych towarów z receptury w ramach każdego magazynu a następnie sumowana.
Edycja oferty > Dane podstawowe Allegro	Cennik dostawy	12	Dostawa i płatność	Cennik dostawy	12
Edycja oferty > Dane podstawowe Allegro	Czas wysyłki	13	Dostawa i płatność	Czas wysyłki	13
Edycja oferty > Dane podstawowe Allegro	Warunki zwrotu	14	Warunki oferty	Warunki zwrotów	14
Edycja oferty > Dane podstawowe Allegro	Warunki gwarancji	15	Warunki oferty	Reklamacje	15
Edycja oferty > Dane podstawowe Allegro	Warunki reklamacji	16	Warunki oferty	Gwarancje	16
Edycja oferty > Dane podstawowe Allegro	Promocja oferty	17	Opcje promowania	Opcje promowania	17
Edycja zamówienia> Pliki	Pliki	18	Dodano dowód zakupu	Dodano dowód zakupu	18