Allegro API: co może integracja, a czego Allegro nie pozwala

Allegro udostępnia rozbudowane API, przez które działa większość narzędzi do sprzedaży: BaseLinker, wtyczki do sklepów, własne integracje. Da się przez nie wystawiać oferty, pobierać zamówienia, aktualizować stany i ceny, odpowiadać na pytania i obsługiwać zwroty. Ale API ma granice, część wynika z techniki, a część z regulaminu. Zanim zaplanujesz integrację, warto wiedzieć, gdzie one leżą.

W skrócie

API Allegro pozwala zautomatyzować niemal cały cykl: od wystawienia oferty, przez zamówienia i etykiety, po dyskusje i zwroty.
Nie pozwala na kontakt z kupującym poza kanałami Allegro ani na używanie jego danych do własnego marketingu.
Limity zapytań wymuszają mądrą synchronizację: zmiany, a nie pełne przeładowania.
Prowizja 1–17 procent netto zależnie od kategorii, liczona od ceny z dostawą, gdy kupujący za nią płaci. Integracja powinna ją uwzględniać przy cenach i stanach.

Co da się zrobić przez API

API Allegro to REST z autoryzacją OAuth. Aplikacja dostaje dostęp do konta sprzedawcy po jednorazowej zgodzie i od tej pory działa w jego imieniu. Zakres jest szeroki i obejmuje praktycznie wszystko, co sprzedawca robi w panelu.

Obszar	Co da się zautomatyzować	Typowy problem
Oferty	tworzenie, edycja, wznawianie, zakończenie, dopasowanie do katalogu produktów Allegro, parametry, zdjęcia	produkt musi pasować do karty w katalogu Allegro; brak dopasowania blokuje wystawienie lub podnosi prowizję
Stany i ceny	aktualizacja ilości i cen, masowo i pojedynczo	opóźnienie przy pełnym przeładowaniu dużego katalogu
Zamówienia	pobieranie nowych i zmienionych, dane kupującego i dostawy, status realizacji, numer przesyłki	adres paczkomatu i dane do faktury w osobnych polach, które łatwo pomylić
Dostawa	cenniki dostaw, generowanie etykiet przez Wysyłam z Allegro, numery przesyłek	metoda wybrana przez kupującego musi być odwzorowana na przewoźnika
Dyskusje i wiadomości	odczyt pytań i dyskusji, odpowiedzi, załączniki	tylko w ramach konta Allegro, bez eksportu do własnego marketingu
Zwroty i reklamacje	odczyt zgłoszeń, oświadczeń o odstąpieniu, zwroty płatności	termin zwrotu pieniędzy biegnie niezależnie od tego, czy integracja działa
Rozliczenia	faktury od Allegro, operacje na saldzie, prowizje	parowanie prowizji z zamówieniami przy większej liczbie transakcji
Promocje	kampanie, kupony, Monety, wyróżnienia	koszt wyróżnienia od 19,90 zł za 10 dni liczy się osobno od prowizji

Najczęściej wdrażany zestaw to stany i ceny w jedną stronę oraz zamówienia i numery przesyłek w drugą. To eliminuje nadsprzedaż i ręczne przepisywanie, czyli dwa największe koszty sprzedaży na Allegro przy własnym magazynie. Pisaliśmy o tym w artykule o Allegro i sklepie na jednym magazynie.

Czego Allegro nie pozwala

Część ograniczeń jest techniczna, część wynika z regulaminu dla sprzedawców i dla aplikacji korzystających z API. Łamanie tych drugich grozi blokadą aplikacji albo konta, więc warto je znać przed projektowaniem.

Kontakt z kupującym poza Allegro. Dane kupującego z zamówienia służą do realizacji tego zamówienia. Nie można dopisać go do newslettera, wysyłać SMS-ów z promocjami ani zapraszać do własnego sklepu w wiadomości przez Allegro. Powiadomienia o realizacji zamówienia są w porządku, marketing nie.
Obchodzenie prowizji. Oferty, które kierują do zakupu poza Allegro, kontakt z propozycją „taniej u nas w sklepie”, dane kontaktowe w treści oferty. Regulamin tego zabrania, a integracja nie powinna takich treści generować.
Masowe zapytania bez ograniczeń. API ma limity liczby zapytań na jednostkę czasu, określone w dokumentacji dla konkretnych zasobów. Integracja, która co minutę pobiera cały katalog, zostanie spowolniona albo zablokowana.
Omijanie katalogu produktów. W większości kategorii oferta musi być powiązana z produktem z katalogu Allegro. Nie da się wystawić dowolnej karty z własnymi parametrami. Produkty bez kategorii lub nieprzypisane obciążone są najwyższą stawką 17 procent.
Automatyczne opinie i oceny. Nie można wystawiać ani wpływać na oceny przez API w sposób inny niż przewidziany przez Allegro.
Zmiana ceny po sprzedaży. Zamówienie ma cenę z momentu zakupu. Integracja nie zmieni jej wstecz, a korekty robi się przez zwrot części płatności.

Ważne

Dane kupujących z Allegro trzymaj w systemie oddzielnie od bazy klientów sklepu albo oznaczaj źródłem. Jeśli ktoś w firmie wyeksportuje „wszystkich klientów” do kampanii e-mailowej, wysyłka do kupujących z Allegro będzie naruszeniem regulaminu i prawdopodobnie przepisów o ochronie danych, bo nie było zgody.

Prowizja a integracja

Integracja nie zmieni prowizji, ale powinna ją rozumieć, bo wpływa na to, co warto automatyzować. Fakty na marzec 2026: prowizja wynosi od 1 do 17 procent netto zależnie od kategorii. Liczona jest od ceny z dostawą, gdy kupujący płaci za dostawę, a od ceny produktu przy darmowej dostawie. W modzie stawka to 11,5 procent od pierwszych 110 zł i 7,5 procent od reszty. Bez abonamentu dochodzi opłata transakcyjna 1 zł od każdej sprzedaży; abonamenty kosztują 49, 199 i 3000 zł miesięcznie. Przy anulowaniu zamówienia prowizja wraca, jeśli zgłosisz to w ciągu 45 dni.

Co z tego wynika dla integracji. Po pierwsze, cena na Allegro powinna być liczona osobną regułą od ceny w sklepie, z uwzględnieniem prowizji dla konkretnej kategorii. Po drugie, anulowania trzeba zgłaszać przez API od razu, żeby nie przegapić 45 dni na zwrot prowizji. Po trzecie, dopasowanie do właściwej kategorii ma wymiar finansowy: różnica między 7 a 17 procent przy tysiącu zamówień to realne pieniądze, a integracja wystawiająca oferty bez poprawnej kategorii generuje tę stratę automatycznie.

Allegro Smart i koszt dostawy

Od 2 marca 2026 próg darmowej dostawy Smart dla kupującego to 49,90 zł u jednego sprzedawcy. Dopłata sprzedawcy do przesyłki Smart zależy od wartości zamówienia w pięciu progach: 30–44,99; 45–64,99; 65–99,99; 100–149,99 i 150 zł wzwyż. W najniższym progu paczkomat InPost to 1,59 zł, a kurier DPD 1,99 zł, w najwyższym kurier kosztuje sprzedawcę około 11–12 zł. Maksymalny koszt dostawy, jaki możesz przerzucić na kupującego poza Smart, to 11,49 zł za InPost i 14,99 zł za kuriera. Integracja, która liczy marżę na zamówieniu, powinna te dopłaty znać i doliczać je według wartości zamówienia, inaczej raport zysku z Allegro będzie zawyżony.

Z naszej praktyki

Sprzedawca z branży narzędziowej miał własną integrację napisaną kilka lat wcześniej, która co 5 minut pobierała pełną listę 4000 ofert, żeby porównać stany. Allegro zaczęło ograniczać jej zapytania i stany aktualizowały się z godzinnym opóźnieniem, co kończyło się nadsprzedażą. Przepisaliśmy synchronizację tak, żeby wysyłała tylko zmiany stanów z ERP od ostatniego uruchomienia, a pełne porównanie robiła raz w nocy. Liczba zapytań spadła kilkadziesiąt razy, opóźnienie do kilku minut. Dodatkowo integracja zaczęła zgłaszać anulowania przez API tego samego dnia, co odzyskało prowizje, które wcześniej przepadały po 45 dniach.

Gotowa integracja czy własna

BaseLinker i podobne narzędzia mają gotowe integracje z Allegro, które wystarczają większości sprzedawców. Własną integrację piszemy, gdy proces wymaga czegoś, czego gotowe narzędzie nie robi, albo gdy firma ma już własny OMS czy ERP i dokłada Allegro jako kolejny kanał.

Kiedy gotowe narzędzie

Standardowy towar z kodami EAN, który łatwo dopasować do katalogu Allegro.
Jeden magazyn, jedno konto Allegro.
Zespół woli jeden panel do wszystkich marketplace’ów.

Kiedy własna integracja

Kilka kont Allegro albo konta w kilku krajach z osobnymi cennikami.
Ceny na Allegro liczone z reguł zależnych od kategorii, prowizji i konkurencji.
Oferty generowane z danych ERP z własną logiką tytułów i parametrów.
Dyskusje i wiadomości obsługiwane z własnego systemu obsługi klienta.
Rozliczenia prowizji parowane automatycznie z zamówieniami w księgowości.

Jak zaprojektować integrację, która nie wpadnie w limity

Krok po kroku

Rejestracja aplikacji. W panelu dewelopera Allegro. Aplikacja dostaje identyfikator i zakres uprawnień. Zgoda sprzedawcy jest jednorazowa, token odświeża się automatycznie.
Dopasowanie produktów. Każdy produkt z ERP dostaje identyfikator oferty Allegro. Nowe produkty dopasowujemy do katalogu Allegro po EAN, resztę ręcznie z listy.
Synchronizacja zmian, nie całości. Stany i ceny wysyłamy tylko dla produktów, które zmieniły się od ostatniego uruchomienia. Pełne porównanie raz dziennie.
Zamówienia przez zdarzenia. Pobieramy listę zdarzeń od ostatniego punktu zamiast przeglądać wszystkie zamówienia. To najtańszy sposób pod kątem limitów.
Obsługa błędów. Każda odpowiedź o przekroczeniu limitu wstrzymuje kolejkę na wskazany czas. Każdy błąd walidacji trafia na listę do ręcznego sprawdzenia.
Dziennik i raport. Co i kiedy zostało wysłane, co odrzucone i dlaczego. Raz dziennie podsumowanie.

Allegro udostępnia API po to, żebyś sprzedawał więcej na Allegro. Każda integracja, która próbuje wyprowadzić kupującego gdzie indziej, prędzej czy później trafi na ścianę.

Pytania, które słyszymy najczęściej

Czy potrzebuję programisty, żeby korzystać z API Allegro?

Do własnej integracji tak. Do korzystania z gotowych narzędzi nie, bo one już są zbudowane na API. Programista jest potrzebny, gdy gotowe narzędzie nie robi tego, czego potrzebujesz.

Czy mogę pobierać e-maile kupujących do własnej bazy?

Do realizacji zamówienia tak, do marketingu nie. Regulamin Allegro zabrania wykorzystania danych kupujących poza obsługą transakcji, a przepisy o ochronie danych wymagają osobnej zgody.

Co się dzieje, gdy integracja przestanie działać?

Zamówienia czekają na Allegro, a stany przestają się aktualizować, co grozi nadsprzedażą. Dlatego każda integracja musi mieć monitoring i powiadomienie, gdy synchronizacja nie działa dłużej niż ustalony czas.

Czy zwrot prowizji przy anulowaniu da się zautomatyzować?

Tak. Integracja zgłasza anulowanie przez API z podaniem powodu, a Allegro zwraca prowizję, jeśli zgłoszenie mieści się w 45 dniach. Przy większej liczbie anulowań to zauważalna kwota.

Sprzedajesz na Allegro i chcesz, żeby stany, zamówienia i ceny działały same? Napisz, jaki masz sklep i program magazynowy, a doradzimy, czy wystarczy gotowe narzędzie, czy potrzebna jest własna integracja. Zobacz, jak pomagamy prowadzić sprzedaż na marketplace’ach.

Zapytaj o integrację z Allegro