Baza wiedzy LINKSPOT › Allegro

Allegro (REST API)

Allegro · Opublikowano 2025-10-17

Spis treści

Wstęp

Konfiguracja Allegro

Szablony ofert

Oferty

Zamówienia

Przydatne linki

Wstęp

Comarch e-Sale to nie tylko Sklep internetowy, ale również wygodne narzędzie do handlu w serwisie Allegro, które umożliwia wystawienie nieograniczonej ilości ofert oraz automatyczną generację zamówień. W panelu administracyjnym Comarch e-Sale można dodać nieograniczoną ilość kont allegro. W przypadku chęci korzystania z tej integracji, niezbędne jest posiadanie konta założonego na stronie allegro.pl.

Od wersji 2019.3 dostępne jest nowe REST API Allegro. Klienci korzystający ze starego API mogą w bardzo prosty sposób przełączyć się na nowy sposób wymiany danych.

W tym celu należy w panelu administracyjnym w zakładce Integracje > Allegro w sekcji Konto Allegro kliknąć w konto z którego Państwo korzystają, a następnie pobrać Token REST API przy użyciu przycisku pobierz. Pojawi się wówczas okno z logowaniem do serwisu, w którym należy wybrać opcję Zaloguj przez Allegro. Po przekierowaniu do serwisu wystarczy zalogować się i wyrazić wymagane zgody.

Wskazówka

W związku z wyłączeniem przez serwis Allegro od 13 stycznia 2020 roku obsługi WebAPI, które spowoduje brak pobierania zamówień z Allegro do e-Sale , od wersji Comarch e-Sale 2020.0 wprowadzono pełną obsługę Allegro REST API.

Konfiguracja Allegro

Ustawienia konta Allegro dostępne są w panelu administracyjnym Comarch e-Sale, w menu Integracje > Allegro.

Możesz dodać Konto Allegro, dokonać zmiany ustawień dotyczących ofert (np. automatycznego powiązania towarów do ofert po kodzie EAN), zamówień (np. automatycznego tworzenia zamówień do ofert), zarządzać kontrolą stanów magazynowych w Allegro, zarządzać wznawianiem ofert, zdecydować, czy ceny na ofertach Allegro mają zmieniać się automatycznie po zmianie ceny w sklepie i wiele innych.

Konto Allegro

W sekcji Integracja Allegro możesz dodać konto klikając w przycisk Dodaj konto Allegro.

Pojawi się wówczas krótka informacja z możliwością zaznaczenia parametru Tryb testowy, który należy zaznaczyć jeśli posiadasz konto w serwisie testowym Allegro oraz przycisk ZALOGUJ PRZEZ ALLEGRO, po wybraniu którego zostaniesz automatycznie przekierowany na stronę serwisu Allegro.pl.

Wskazówka

Od wersji 2020.3 konto w trybie testowym będzie dodawane według aktualnie zalogowanego użytkownika na innej zakładce przeglądarki. Podczas dodawania konta testowego Allegro pojawi się strona z pytaniem, czy dodać konto które jest aktualnie zalogowane.

Po zalogowaniu w serwisie, konto zostanie przyłączone do panelu administracyjnego e-Sale, a aplikacja pobierze wszystkie dane. W nazwie konta wyświetlany jest login użytkownika Allegro, który można zmienić na dowolną nazwę, po przejściu na szczegóły konta .

Wskazówka

Allegro udostępnia również swoim użytkownikom serwis testowy, w którym można wypróbować wystawianie aukcji bez ponoszenia kosztów. W związku z tym niezbędne jest założenie konta w serwisie allegro.pl.allegrosandbox.pl. Następnie w trakcie dodawania nowego konta w panelu administracyjnym e-Sale należy zaznaczyć parametr Tryb testowy.

Po podłączeniu Konta Allegro do panelu administracyjnego e-Sale, możesz je uaktywnić, zmienić nazwę konta wyświetlaną w e-Sale, usunąć konto (jeśli żadna oferta nie jest powiązana z towarem w e-Sale), pobrać Token REST API, uzupełnić obowiązkowe parametry wprowadzone przez serwis Allegro oraz zmienić swoje dane adresowe. Dodatkowo istnieje możliwość wybrania domyślnej kategorii dla zintegrowanego konta Allegro. Podczas dodawania nowej oferty będzie podpowiadała się jako kategoria domyślna

Wskazówka

W konfiguracji Allegro dla e-Sale w wersji Enterprise oraz B2B istnieje możliwość wybrania cennika dla wystawianych towarów na ofertach Allegro. Cena domyślna automatycznie jest ustawiona na Domyślna, jednak można ustawić inny cennik dostępny po stronie systemu ERP, wykonać synchronizację i nowy cennik pojawi się na liście wyboru w konfiguracji.

Wskazówka

W momencie kiedy login konta Allegro jest nieaktywny (suwak jest w pozycji Wyłączony) wówczas nie są pobierane zamówienia Allegro. Zamówieniasą pobierane dla aktywnego konta Allegro.

W szczegółach konfiguracji konta Allegro widoczne jest pole, gdzie można określić datę i godzinę, od której mają zostać pobrane (ręcznie lub przez automat) zamówienia. Od wersji 2020.4 opcja konfiguracji daty pobierania zamówienia dotyczy tylko nowych loginów i jest dostępna przez 7 dni od daty dodania konta Allegro w panelu administracyjnym e-Sale.

W wersji 2020.3 został wprowadzony mechanizm w przypadku blokady konta Allegro. Jeżeli konto Allegro zostanie zablokowane, wówczas w panelu administracyjnym konto zostanie wyłączone. Konto zostanie również wyłączone w przypadku braku możliwości odświeżenia tokenów. W pozostałych przypadkach konto nie zostanie zablokowane natomiast obsługa e-Sale zostanie poinformowana o tym fakcie komunikatem przy próbie wykonania działania nieuprawnionego na zablokowanym koncie (np. wystawienie aukcji).

Od wersji 2022.4 wprowadziliśmy odpowiednie aktualizacje, dzięki którym podczas konfiguracji konta Allegro (Integracje/ Allegro/ Konto Allegro/ Parametry domyślne) wpisane dane adresowe automatycznie uzupełniane są w formularzu tworzenia oferty Allegro, w polu o nazwie Domyślny adres wysyłki.

Oferty

W sekcji Oferty dostępne są parametry:

Zamówienia

Wskazówka

Od wersji 2020.3 niezależnie od statusu Kontrahenta zamówienie będzie wysyłane do systemu ERP. Taki Kontrahent musi zostać przynajmniej raz zsynchronizowany do systemu ERP.

Wskazówka

Od wersji 2021.1 umożliwiono synchronizację zamówień z serwisu Allegro do systemu ERP złożonych przez kontrahenta, który jest zablokowany w Comarch e-Sale.

W sekcji Zamówienia dostępne są parametry:

Kontrola stanów magazynowych w Allegro

W sekcji Kontrola stanów magazynowych w Allegro dostępne są parametry:

Wznawianie oferty możliwe jest tylko dla oferty ‘zakończonych’ z formatem sprzedaży ‘Kup teraz (bez licytacji)’.

Wskazówka

Kontrola stanów magazynowych nie działa na kontach testowych Allegro założonych w serwisie sandbox dostępnym pod adresem: allegro.pl.allegrosandbox.pl.

Wskazówka

Aktywacja kontroli stanów magazynowych w Allegro jest możliwa dopiero po włączeniu kontroli stanów magazynowych w e-Sale.

Klienci

Zamówienia z serwisu Allegro domyślnie trafiają do systemu ERP jako złożone przez kontrahenta nieokreślonego. Po zaznaczeniu powyższego parametru, w Sale utworzy się nieaktywna karta użytkownika na podstawie danych z zamówienia allegro i zostanie ona przesłana do systemu ERP wraz z zamówieniem.

Ceny w Allegro

W sekcji Ceny w Allegro dostępny jest parametr Zmień cenę na ofercie po zmianie ceny w e-Sale, po włączeniu którego ceny na ofertach będzie zmieniana automatycznie, jeśli podczas synchronizacji z systemem ERP została przesłana nowa cena towaru, zgodnie z cennikiem powiązanym z kontem Allegro.

Po włączeniu parametru w konfiguracji Allegro, na szczegółach oferty Allegro dodany jest również parametr Zmień cenę na ofercie po zmianie ceny w e-Sale, pozwalający na wykluczenie ze zmiany ceny poszczególnych ofertach. Na nowo dodawanych ofertach parametr ten jest automatycznie włączony na Tak, natomiast na ofertach już istniejących parametr jest ustawiony na Nie. Podczas wznawiania oferty, której powiązanie z towarem w e-Sale nastąpiło po włączeniu w konfiguracji parametru Zmień cenę na ofercie po zmianie ceny w e-Sale, również parametr na szczegółach oferty będzie włączony na Tak.

Z poziomu listy oferty w menu Marketplace > Allegro > Oferty wprowadzono możliwość seryjnej zmiany ustawień parametru Zmień cenę na ofercie po zmianie ceny w e-Sale. W tym celu dodano operację seryjną Zmień cenę dostępną pod przyciskiem Operacje grupowe widocznym po zaznaczeniu na liście przynajmniej jednej ofercie.

Od wersji 2020.3 umożliwiono automatyczną zmianę ceny w dół. Przy włączonym parametrze Zmień cenę na oferty po zmianie ceny w e-Saleprzesłanie kwoty niższej od aktualnej spowoduję aktualizację ceny. Minimalna cena zgodnie z wymaganiami Allegro to 1 zł. Przesłanie ceny niższej niż 1 zł spowoduje ustawienie ceny równej 1 zł.

Wskazówka

W przypadku wystawiania oferty z towarem o wartości niższej niż 1 zł w polu z ceną będzie wprowadzona wartość 0,00. W takim przypadku obsługa e-Sale wprowadza cenę ręcznie.

Szablony aukcji

Comarch e-Sale został tak zaprojektowany, aby wszystkie czynności związane ze sprzedażą w serwisie Allegro były dla właściciela e-Sale proste, a przede wszystkim mało czasochłonne.

W zakładce Marketplace > Allegro > Szablony ofertmożna dodawać szablony, które wpływają na przyśpieszenie procesu wystawiania nowej oferty. Przy użyciu tej funkcjonalności nie musisz przy każdym wystawianiu nowej oferty uzupełniać wszystkich danych. Wystarczy, że skorzystasz z przygotowanego szablonu.

Po przejściu na zakładkę Szablony ofert pojawi się panel, na którym dostępny jest przycisk pozwalający na dodanie nowego szablonu oraz wyświetlana jest lista przygotowanych szablonów ofert. Szablon, który jest ustawiony jako domyślny zaznaczony jest na liście kolorem zielonym.

Jeśli w panelu administracyjnym e-Sale podłączone jest więcej niż jedno konto Allegro, wówczas dostępne będą zakładki z widocznymi loginami, na których należy dodawać szablony ofert osobno dla każdego konta Allegro.

Dodawanie szablonów ofert

W celu dodania nowego szablonu ofert należy kliknąć w Dodaj szablon.

Pojawi się wówczas formularz, w którym należy uzupełnić nazwę szablonu, wybrać kategorię w serwisie Allegro oraz zatwierdzić zmiany przyciskiem Zapisz.

Szablony ofert zostały rozbudowane o parametry wspólne dla wszystkich ofert jak również o parametry, które są zależne od kategorii Allegro, dlatego należy tworzyć szablony dla poszczególnych kategorii towarowych.

Na szablonie ofert można:

Po uzupełnieniu wszystkich wymaganych danych należy zapisać szablon za pomocą dyskietki.

Dodając opis oferty Allegro zarówno podczas tworzenia szablonu jak i podczas dodawania nowej oferty można korzystać tylko z określonych znaczników HTML zgodnych z zasadami serwisu Allegro takich jak:

Wskazówka

Jeśli korzystasz w szablonie ofert z makra @ProductDescription@ pozwalającego na pobranie opisu z systemu ERP. To dla systemu ERP Optima, pobierany jest opis z karty towaru dodany na zakładce Dodatkowe lub e-Sale. W przypadku, kiedy opis dodany jest na obu zakładkach na ofercie Allegro przenoszony będzie opis z zakładki e-Sale z sekcji języki.

Wskazówka

Od wersji 2022 podczas dodawania nowego szablonu oferty Allegro w panelu administracyjnym na zakładceAllegro > Szablony *Ofert* pole z opisem oferty zostało połączone z polem makr i wstawek. Dodano również informację, że makra i wstawki wykorzystywane są w opisie oferty.

Wskazówka

W REST API nie jest obsługiwany format sprzedaży Sklep (bez licytacji) – dostępny wcześniej w WEB API dla kont o typie sklep. Opcja ta w nowym API została zastąpiona przezKup teraz ze wskazaniem w polu Czas trwania opcji z listy: do wyczerpania zapasów.

Wskazówka

W REST API zmianie uległ sposób wystawiania oferty w panelu e-Sale, w związku z czym skonfigurowanie cenników dostaw w Allegro jest niezbędne. Konfiguracja możliwa jest na koncie w Allegro w menu Ustawienia Sprzedaży > Ustawienia dostawy w sekcji Cenniki dostaw* – dodaj nowy cennik. Kieruje do tej lokalizacji przycisk Dodaj widoczny w szablonie ofert w sekcji *Dostawa, płatność.

Wskazówka

Dla zakupów zrobionych od 8 listopada 2021 r. Klient ma 14 dni kalendarzowych na opłacenie zamówienia przelewem tradycyjnym.

Edycja szablonów ofert

Po najechaniu na kafelek wybranego szablonu, pojawi się krótkie menu, w którym można za pomocą poszczególnych przycisków:

Oferty

Wszystkie oferty wystawione na koncie w serwisie Allegro, które podłączone jest do e-Sale, widoczne są w panelu administracyjnym, w menu Marketplace > Allegro > Oferty.


Po dodaniu i skonfigurowaniu konta Allegro w e-Sale, w zakładce tej wyświetlona zostanie lista wszystkich ofert dodanych na podłączonym koncie Allegro. Pobieranie informacji działa w trybie online, czyli wszystkie zmiany na bieżąco aktualizowane są w panelu administracyjnym e-Sale.

Na liście ofert wyświetlane są na dwa sposoby:

W celu ułatwienia korzystania z operacji dostępnych na liście ofert wprowadzono „pływające menu” dla dostępnych funkcji. Dzięki temu, przy przewijaniu długich list ofert oraz zamówień, menu z przyciskami jest zawsze dostępne u góry ekranu.

Nad listą ofert, po prawej stronie dostępne są przyciski:

Jeśli kody towarów w importowanym pliku CSV zawierają znaki: ; ” , ‘ \, wówczas znaki te powinny być ujęte:

W prawym górnym rogu listy pod 3 kropkami dostępny jest przycisk: Eksportuj do pliku.


Przy użyciu funkcji Eksport do pliku można wykonać eksport listy ofert z zakresem danych:

Eksport może być wykonany do plików z formatem:

Widoczne są kolumny:

Na liście ofert możliwe jest również filtrowanie ofert. Oferty mogą być filtrowane po kolumnach:

Po wyfiltrowaniu i przejściu na szczegóły oferty, po powrocie do listy filtr nadal jest aktywny, aż do momentu usunięcia lub zmiany preferencji.

Dodawanie i edycja oferty

Nowe oferty możemy utworzyć przy pomocy przycisku Dodaj ofertę na liście ofert.

Wyświetlony zostanie wówczas formularz z polami do uzupełnienia:

W przypadku dodawania towaru posiadającego jednostki pomocnicze pojawi się dodatkowo pole:

Dodatkowo, jeśli w zakładce Allegro > Szablony ofert utworzony zostanie szablon oznaczony jako domyślny, wówczas dodając nową ofertę zostanie on użyty.

Kolejny wiersz opisu możesz dodać przy użyciu opcji Dodaj kolejną sekcję.

Zdjęcia dodawane do Opisu na ofercie pobierane są z galerii, w związku z tym aby dodać do Opisu zdjęcia z dysku w pierwszej kolejności należy dodać je na ofercie w sekcji Zdjęcia i opis.

Po dodaniu zdjęć z dysku do Opisu będą one dostępne również w panelu administracyjnym w menu Ustawienia > Pliki użytkownika w folderze Allegro.

Dodając opis do oferty Allegro możesz korzystać tylko z określonych znaczników HTML zgodnych z zasadami serwisu Allegro takich jak:

Wskazówka

Zwróć uwagę, że każdy pakiet promowania różni się sposobem wyróżniania oferty oraz naliczaną opłatą. Po więcej informacji zapraszamy do dedykowanego artykułu w Pomocy Allegro.

Pamiętaj, że im więcej cennych informacji zamieścisz w swojej ofercie tym stanie się ona atrakcyjniejsza dla kupujących.
Po uzupełnieniu wszystkich wymaganych parametrów dotyczących oferty należy zapisać wprowadzone zmiany przyciskiem Zapisz.
Po zapisaniu oferty i wejściu w edycję obok przycisku Zapisz dostępny jest również przycisk Sprawdź opłaty.

Oferty z czasem trwania do wyczerpania zapasów lub oferty dla towarów, które posiadają nieograniczony stan wystawiane są z maksymalną ilością 10 000 sztuk*. Podczas wystawiania ofert z użyciem szablonu w polu liczba sztuk podpowiada się rzeczywisty stan towaru z e-Sale . W przypadku wyłączonej kontroli stanów magazynowych liczbę sztuk można edytować.

Wskazówka

* Od wersji 2021.2. maksymalna ilość sztuk wynosi 100 000.

Podczas wystawiania ofert na formularzu przy polu z ceną podpowiada się aktualna cena towaru w e-Sale. Dodatkowo przy wyłączonym parametrze Kontroluj stany magazynowe dla oferty Allegro przy polu Liczba sztuk podpowiada się aktualna ilość towaru w e-Sale.

W wersji 2020 e-Sale na formularzu oferty został dodany kod towaru w sekcji Podstawowe informacje oraz kod EAN w sekcji Parametry towaru, jeśli jest wymagany dla danej kategorii. Jeżeli kod towaru lub kod EAN dostępny jest na karcie towaru w systemie ERP jest on automatycznie uzupełniany podczas dodania nowej oferty.

Jeżeli podane niżej parametry są dostępne na karcie towaru w systemie ERP wówczas zostaną automatycznie uzupełnione na formularzu oferty:

Wskazówka

Podczas dodawania nowych aukcji wprowadzono automatyczne uzupełnianie pola Stan wartością Nowy w sekcji z Cechami przedmiotu. Wprowadzono także podczas dodawania nowych ofert Allegro uzupełnianie pola Kod produktu w sekcji z Cechami przedmiotu – kodem towaru z systemu ERP.

Wskazówka

Automatyczne uzupełnianie następuje podczas wystawiania oferty Allegro.

Podczas zmiany towaru w ofercie (przy pomocy przycisku Zmień obok pola z nazwą towaru), są aktualizowane dane o towarze (nazwa, ID, kod towaru), kod EAN, cena oraz parametry pobierane z systemu ERP (kod producenta, marka, itp.) pod warunkiem, że dla danej kategorii istnieją takie parametry do uzupełnienia oraz nie znajduje się tam już inna wartość.

Po zamknięciu formularza i zapisaniu roboczo oferta widoczna jest na liście ze statusem Przygotowana. Następnie należy odszukać ją na liście ofert i zaznaczyć pole po lewej stronie checkbox . Pojawi się wówczas lista operacji seryjnych, z których należy wybrać opcję WYSTAW*. Oferta zostanie wówczas dodana DO KOLEJKI. Po chwili jej status zmieni się na WYSTAWIONA.* Ofertę można wystawić od razu po zamknięciu formularza.

Po uzupełnieniu na formularzu oferty Daty i godziny rozpoczęcia, ofertę również należyWystawić.Wówczas status oferty zmieni się na W kolejce i oferta zostanie wystawiona w serwisie Allegro zgodnie zDatą rozpoczęciapodaną na szczegółach oferty.

Do operacji grupowych należą:

+ Mam problem z tym tematem Otwórz w portalu bazy wiedzy »