1. Strona główna
  2. Dokumentacja
  3. Integracja z Allegro
  4. Dodawanie integracji
  5. Zakres integracji z Allegro

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

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

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.

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 .

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 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  

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
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  

Zrzuty xSale

Zrzuty Allegro