Allegro API: integracja i automatyzacja bez logowania do panelu sprzedawcy
Zamówienia, oferty, stany, zwroty i wiadomości od kupujących obsługiwane przez API, a nie przez panel. Token OAuth odświeża się sam, zamówienia pobieramy przyrostowo, a każdy przepływ przechodzi najpierw sandbox Allegro. Limity zapytań, ponawianie i kolejka błędów są częścią wdrożenia, nie łatką po pierwszej awarii.
- 2 do 4 tygodniod warsztatu do integracji działającej na produkcji, po przejściu całego przepływu w sandboxie Allegro
- 14 dnityle zwykle mija od warsztatu do pierwszego przepływu, który realnie zdejmuje pracę z rąk
- 0 wywołańtyle integracja robi na Waszym koncie sprzedawcy, dopóki przepływ nie przejdzie testów w środowisku testowym
Problem
Dlaczego integracja z Allegro działa tydzień, a potem pęka?
Scenariusz stoi w nocy, bo token wygasł i nikt go nie odświeżył. Rano w ERP są dwa dokumenty do tego samego zamówienia, bo integracja pobrała listę od początku i nie wiedziała, co przetworzyła wczoraj. Ten sam produkt sprzedał się na Allegro i w sklepie, choć na magazynie leżała jedna sztuka.
Druga grupa problemów to limity i błędy. Integracja odpytuje API co minutę, dostaje odpowiedź o przekroczonym limicie i przestaje działać. Nie ma kolejki, nie ma ponowienia, nie ma logu, więc nikt nie wie, ile zamówień nie weszło do systemu. O braku numeru śledzenia dowiadujecie się od kupującego.
Najdroższa jest trzecia rzecz: testowanie na koncie produkcyjnym. Wiadomość testowa idzie do prawdziwego kupującego, a zła cena albo zerowy stan ląduje na żywej ofercie. Allegro daje oddzielne środowisko testowe i pełną dokumentację REST API dla sprzedawców, w której opisane są tryby autoryzacji, limity zapytań i formaty odpowiedzi. Limity czytamy tam przed wdrożeniem, nie po pierwszej blokadzie.
- Zamówienie z Allegro trafia do ERP dwa razy albo nie trafia wcale
- Ten sam towar sprzedany w dwóch kanałach, bo stan schodził raz na dobę
- Integracja milczy po przekroczeniu limitu zapytań i nikt tego nie widzi
- Wiedza o przepływie siedzi w głowie jednej osoby, bez dokumentacji i bez logu
Dlaczego teraz
Co domyka samo Allegro, a co musisz zrobić po swojej stronie?
Allegro ma REST API z autoryzacją OAuth 2.0 i dwoma trybami: Client Credentials do operacji na własnym koncie i Authorization Code, gdy aplikacja działa w imieniu innego sprzedawcy. Aplikację rejestrujesz raz, a Client ID i Client Secret służą do generowania tokenów. Token ma ograniczoną ważność, więc integracja musi odświeżać go sama, bez udziału człowieka. Dokładne czasy życia bierzemy z dokumentacji, bo to Allegro nimi zarządza.
Jest też oddzielne środowisko testowe: sandbox z własnym kontem i własnymi danymi, z innym adresem autoryzacji. Dzięki temu cały przepływ da się przejść od zamówienia do etykiety kurierskiej, zanim ktokolwiek dotknie Waszego konta sprzedawcy. Dla nas to warunek wdrożenia, a nie opcja.
Reszta zostaje po stronie integracji i to jest praca, której API za Ciebie nie zrobi. Znacznik ostatniego przetworzonego zdarzenia, żeby pobierać przyrostowo. Klucz idempotencji, żeby to samo zamówienie nie zrobiło dwóch dokumentów. Kolejka i ponawianie z rosnącym odstępem, gdy API zwróci błąd 5xx albo przekroczony limit. I jedno miejsce, w którym trzymacie prawdę o stanie magazynowym, bo bez tego synchronizacja kilku kanałów jest tylko przepisywaniem liczb.
Czwarta zmiana to agent AI. Integracja przeniesie dane, ale nie odpowie na pytanie „ile zamówień z Allegro nie weszło wczoraj do Subiekta”. BOND, nasz firmowy agent AI, odpowiada na to zwykłym zdaniem w 5 do 10 sekund, bez wchodzenia do logu i bez eksportu z panelu.
Co się zmienia
Co dostaje zespół po wdrożeniu?
Token odświeża się sam
OAuth 2.0 w trybie właściwym dla Waszego przypadku, z automatycznym odświeżaniem i alertem, gdy odświeżenie się nie uda. Nikt nie generuje kluczy ręcznie i nikt nie trzyma ich w arkuszu.
Client Secret w magazynie sekretów, nie w treści scenariusza i nie w kodzie
Zamówienia pobierane przyrostowo
Integracja pyta o zamówienia po statusie i dacie i pamięta, na czym skończyła. Ten sam identyfikator zamówienia nie tworzy drugiego dokumentu w ERP ani drugiej faktury.
GET /order/checkout-forms co 15 minut plus klucz idempotencji na identyfikatorze zamówienia
Jeden stan magazynowy na wszystkie kanały
Ustalamy jedno źródło prawdy: ERP, sklep albo Waszą bazę. Każda sprzedaż i każdy zwrot zmienia stan w tym jednym miejscu, a integracja propaguje zmianę na oferty w Allegro.
PUT /sale/offers/{offerId} po zmianie stanu, zamiast eksportu raz na dobę
Zwroty i reklamacje z terminem, nie w skrzynce
Wniosek o zwrot albo reklamację zamienia się w zadanie z terminem i właścicielem. Powód zwrotu zapisujemy per produkt, więc po kwartale widać, który model wraca najczęściej i dlaczego.
GET /order/refund-claims, zadanie w ClickUp albo alert na Slacku w kilka minut
Limit zapytań przestaje przewracać integrację
Wywołania idą przez kolejkę z ustalonym tempem, a przekroczony limit albo błąd 5xx uruchamia ponowienie z rosnącym odstępem. Nic nie ginie po cichu, bo każde nieudane wywołanie zostaje w kolejce błędów.
Limity według dokumentacji Allegro, sprawdzane przed wdrożeniem, i monitoring z alertem
Pytania o sprzedaż na Allegro zwykłym zdaniem
„Ile zamówień czeka na wysyłkę”, „które oferty mają stan zero”, „ile zwrotów było w tym miesiącu i z jakiego powodu”. Agent AI odpowiada z Waszych danych, bez wchodzenia do panelu.
Odpowiedź w 5 do 10 sekund, po polsku, bez eksportu CSV
A u Ciebie
Co, jeśli sprzedajecie inaczej?
Cztery zdania, które słyszymy najczęściej przy Allegro, i to, co na nie odpowiadamy.
Mamy BaseLinker, on już rozmawia z Allegro.
Wtedy zwykle nie budujemy drugiej integracji i mówimy to na konsultacji. BaseLinker obsługuje typowy przepływ zamówień, faktur i etykiet. Własna integracja przez API ma sens tam, gdzie gotowy konektor nie sięga: nietypowe pola w ERP, własna logika rabatów, dane ładowane do BigQuery albo proces, którego nie da się ułożyć w statusach.
Nie chcemy, żeby ktokolwiek testował na naszym koncie sprzedawcy.
I nie testujemy. Cały przepływ przechodzi najpierw w sandboxie Allegro, na oddzielnym koncie i oddzielnych danych, z innym adresem autoryzacji. Na Wasze konto produkcyjne integracja wysyła pierwsze wywołanie dopiero po Waszej akceptacji, a pierwszy tydzień działa w trybie ograniczonym, na wybranej grupie ofert.
Nasz magazyn stoi na Subiekcie, a nie w chmurze.
To normalne i nie wymaga migracji. Warstwę pośrednią stawiamy na n8n albo Make, a przy własnej logice piszemy usługę w Node.js lub Pythonie. Z systemem lokalnym łączymy się przez jego API, wymianę plików albo kolejkę, w zależności od tego, co Wasz dostawca dopuszcza.
Zwroty na Allegro obsługuje platforma, więc integracja tu nic nie zmieni.
Zgoda, mechanika zwrotu, terminy i część reguł należą do platformy i integracja ich nie przestawi. Dlatego pracujemy u źródła: pełne dane w ofercie, tabela rozmiarowa, zdjęcia i opis, które zmniejszają liczbę pomyłek przy zakupie. Po stronie procesu domykamy resztę: wniosek trafia od razu do zadania, korekta idzie do księgowości, a powód zwrotu wraca do raportu per produkt.
- Marketplace i sklep
- Allegro, BaseLinker, Shopify, WooCommerce, PrestaShop
- ERP i księgowość
- Subiekt, Comarch Optima, Fakturownia, iFirma
- Wysyłka
- InPost, DPD, inni kurierzy przez API przewoźnika
- Dane i raporty
- BigQuery, Google Sheets, GA4, bazy SQL
- Praca zespołu
- Slack, ClickUp, Google Workspace, Microsoft 365
- Warstwa automatyzacji
- n8n, Make, Zapier, własne integracje przez API
Co spinamy w Allegro API i jak często
Obszary, które najczęściej wchodzą do pierwszego wdrożenia. Zakres wywołań i częstotliwość ustalamy na warsztacie, bo to od nich zależy, czy zmieścicie się w limicie zapytań.
| Obszar | Wywołanie w API Allegro | Jak to spinamy |
|---|---|---|
| Nowe zamówienia | GET /order/checkout-forms | co 15 minut, przyrostowo po statusie i dacie |
| Szczegóły zamówienia | GET /order/checkout-forms/{id} | kupujący, pozycje, adres dostawy, dane do faktury |
| Wysyłka i numer śledzenia | POST /order/checkout-forms/{id}/shipments | po nadaniu paczki, razem z etykietą od przewoźnika |
| Oferty, ceny i stany | PUT /sale/offers/{offerId} | po każdej zmianie stanu w ERP albo w sklepie |
| Uzgodnienie własnych ofert | GET /offers/listing | raz na dobę, do wykrycia rozjazdów stanu i ceny |
| Wiadomości od kupujących | GET /messaging/threads | co 15 minut, odpowiedź przez POST /messaging/threads/{threadId}/messages |
| Zwroty i reklamacje | GET /order/refund-claims | zadanie w ClickUp albo alert na Slacku, z powodem zwrotu |
Zestaw wywołań i ich nazwy sprawdzamy w dokumentacji Allegro przed wdrożeniem, bo API żyje i pola się zmieniają. U większości sprzedawców pierwsze wdrożenie obejmuje trzy do czterech obszarów z tej listy.
Jak to robimy
Pięć kroków od panelu do integracji na produkcji
Każdy krok kończy się czymś, co możesz ocenić, zanim zdecydujesz o następnym.
Warsztat i audyt API
Rozkładamy dzisiejszy obieg zamówienia: kto co przepisuje, ile razy dziennie i gdzie powstają rozjazdy. Po stronie technicznej sprawdzamy, jakie konto Allegro macie, jaki tryb autoryzacji ma sens, co potrafi Wasz ERP i gdzie leży prawda o stanie magazynowym.
Projekt przepływu i rejestracja aplikacji
Rejestrujemy aplikację, ustawiamy tryb OAuth i miejsce przechowywania sekretów. Spisujemy listę wywołań, częstotliwość, sposób pobierania przyrostowego, klucz idempotencji i zachowanie przy błędzie. Wybieramy narzędzie: n8n, Make albo własna usługa, gdy logika jest nietypowa.
Sandbox od początku do końca
Cały przepływ przechodzi w środowisku testowym Allegro, na oddzielnym koncie: nowe zamówienie, dokument w ERP, etykieta kurierska, numer śledzenia z powrotem do zamówienia, wiadomość do kupującego. Testujemy też przypadki brzydkie: brak NIP, zamówienie wieloprzedmiotowe, anulowanie, zwrot, przekroczony limit.
Przełączenie na produkcję z monitoringiem
Pierwszy tydzień na wybranej grupie ofert, obok dotychczasowego trybu pracy, bez wyłączania niczego. Monitoring pilnuje błędów 4xx i 5xx, limitu zapytań i nieudanego odświeżenia tokenu. Alert idzie do nas i do Was, zanim zauważy to kupujący.
Pomiar i przekazanie
Po 30 i po 90 dniach patrzymy na liczby: ile zamówień przeszło bez ręki człowieka, ile trafiło do kolejki błędów i z jakiego powodu. Dostajecie dokumentację przepływu i dostęp do logu, więc kolejną zmianę możecie wprowadzić sami albo z kimkolwiek innym.
Przed i po
Jak zmienia się dzień osoby, która obsługuje Allegro
Przedtem
- Rano przepisuje zamówienia z panelu Allegro do ERP i faktur
- Stany na ofertach poprawia ręcznie, po każdej większej dostawie
- O błędzie integracji dowiaduje się z wiadomości od kupującego
- Powód zwrotu zostaje w wątku i nigdzie się nie zapisuje
Po zmianie
- Zamówienie ma dokument, etykietę i numer śledzenia bez udziału człowieka
- Stan schodzi na ofertach w kilka sekund po sprzedaży w innym kanale
- Nieudane wywołanie stoi w kolejce błędów z alertem, a nie w próżni
- Powód zwrotu ląduje w raporcie per produkt, gotowym do przeglądu
Pierwszy przepływ działa zwykle po 14 dniach od warsztatu. Pełny zakres i limity oceniamy po 30 dniach na produkcji, a wpływ na pracę zespołu po 90.
Dla osoby, która to zatwierdza
Co z tego ma właściciel procesu
Ryzyko projektu siedzi tu w jednym miejscu: w koncie sprzedawcy, na którym stoi Wasza sprzedaż. Dlatego cały przepływ przechodzi najpierw w środowisku testowym, a produkcja startuje na wybranej grupie ofert. Jeśli coś ma pójść nie tak, pójdzie nie tak w sandboxie, a nie na żywej ofercie.
Druga rzecz to niezależność. Dostajecie spisany przepływ, listę wywołań, dostęp do logu i klucze w swoim magazynie sekretów. Integracja nie jest zakładnikiem jednej osoby ani naszej firmy, więc rozmowa o utrzymaniu jest Waszą decyzją, nie koniecznością.
- Testy w sandboxie Allegro, zero wywołań na koncie produkcyjnym przed akceptacją
- Start na wybranej grupie ofert, obok dotychczasowego trybu pracy
- Monitoring błędów, limitu zapytań i odświeżania tokenu, z alertem do Was
- Dokumentacja przepływu i dostęp do logu, więc zmianę zrobi też ktoś inny
Ile to kosztuje
Warsztat ma cenę jawną, wdrożenie wycenę po nim
Warsztat procesowy kosztuje 2500 zł netto za tydzień i przy jednej integracji zwykle wystarcza jeden tydzień. Wdrożenie wyceniamy po warsztacie, gdy wiadomo, ile obszarów wchodzi w grę, w jakim stanie jest ERP i czy trzeba dopisać własną logikę, zamiast złożyć przepływ z gotowych bloków.
Warunki dostępu do API ustala Allegro i sprawdzamy je w dokumentacji przed wdrożeniem, razem z limitami zapytań. Koszt narzędzia automatyzacji, jeśli w ogóle wchodzi, płacisz bezpośrednio jego dostawcy, na przykład n8n albo Make, albo nie płacisz wcale, gdy przepływ stoi na Waszej infrastrukturze. Bez naszej prowizji.
Warsztat procesowy
2500 zł netto
za tydzień, przy jednej integracji zwykle jeden
Zamknięta całość. Kończy się dokumentem, który obroni się bez nas: mapą przepływu, listą wywołań i planem testów.
- Mapa dzisiejszego obiegu zamówienia i miejsc, w których dane się rozjeżdżają
- Wybór trybu OAuth i miejsca przechowywania sekretów
- Lista wywołań API z częstotliwością, pod limit zapytań
- Plan testów w sandboxie i wskaźniki do pomiaru po 30 dniach
- Najczęściej wybierany
Warsztat i integracja Allegro
Wycena po warsztacie
zakres wynika z liczby obszarów i stanu Waszego ERP
Najczęściej wybierany wariant. Działająca integracja w 2 do 4 tygodni od warsztatu, przetestowana w sandboxie przed produkcją.
- Wszystko z warsztatu
- Przepływ w n8n, Make albo własnej usłudze, spięty z ERP i księgowością
- Pobieranie przyrostowe, idempotencja, kolejka i ponawianie błędów
- Sandbox od początku do końca, potem start na wybranej grupie ofert
- Monitoring z alertem i dokumentacja przepływu dla Waszego zespołu
Integracja i agent AI
Wycena po warsztacie
dla zespołów, które pytają o stan sprzedaży kilka razy dziennie
Wszystko z wdrożenia plus BOND, firmowy agent AI, który odpowiada na pytania o Allegro zwykłym zdaniem.
- Wszystko z integracji Allegro
- Agent AI spięty z zamówieniami, ofertami i zwrotami
- Alerty o zamówieniach bez wysyłki i o ofertach ze stanem zero
- Wdrożenie agenta zwykle około 2 miesięcy, obok działającej integracji
Jeśli na warsztacie okaże się, że BaseLinker albo inny gotowy konektor robi wszystko, czego potrzebujecie, mówimy to i pokazujemy, jak go ustawić. Sprawa kończy się wtedy na warsztacie, a dokument z niego zostaje u Was: mapa przepływu, lista wywołań i plan testów obronią się bez nas.
Najczęstsze pytania
Jak uzyskać dostęp do Allegro API?
Rejestrujesz aplikację w portalu dla programistów Allegro i wybierasz tryb autoryzacji: Client Credentials do operacji na własnym koncie albo Authorization Code, gdy aplikacja działa w imieniu innego sprzedawcy. Client ID i Client Secret służą potem do generowania tokenów OAuth 2.0. Token ma ograniczoną ważność, więc integracja musi odświeżać go automatycznie, a sekrety trzymamy w magazynie sekretów, nie w treści scenariusza.
Czy będziecie testować integrację na naszym koncie produkcyjnym?
Nie. Cały przepływ przechodzi najpierw w środowisku testowym Allegro, które ma oddzielne konto, oddzielne dane i inny adres autoryzacji. Na Wasze konto sprzedawcy integracja wysyła pierwsze wywołanie dopiero po Waszej akceptacji, a pierwszy tydzień działa na wybranej grupie ofert, obok dotychczasowego trybu pracy.
Jakie są limity zapytań w Allegro API?
Limity ustala Allegro i podaje w dokumentacji, dlatego sprawdzamy je przed wdrożeniem, a nie po pierwszej blokadzie. Nie zgadujemy liczb, tylko projektujemy przepływ tak, żeby zmieścił się z zapasem: wywołania idą przez kolejkę z ustalonym tempem, dane pobieramy przyrostowo zamiast od początku, a przekroczony limit uruchamia ponowienie z rosnącym odstępem.
Jak pobieracie zamówienia, żeby nie powstawały dwa dokumenty?
Integracja pyta o zamówienia po statusie i dacie i zapisuje znacznik ostatniego przetworzonego zdarzenia, więc kolejny przebieg zaczyna od tego miejsca, a nie od początku listy. Do tego każdy dokument powstaje z kluczem idempotencji zbudowanym na identyfikatorze zamówienia. Ten sam identyfikator nie utworzy drugiej faktury ani drugiego dokumentu magazynowego.
Czy integracja obsłuży zwroty i reklamacje z Allegro?
Obsłuży stronę procesu, nie mechanikę platformy. Terminy, formularz i część reguł zwrotu należą do Allegro i integracja ich nie zmieni. Możemy natomiast pobierać wnioski o zwrot, zamieniać je w zadanie z terminem i właścicielem, zapisywać powód per produkt i przekazywać korektę do księgowości. Liczbę pomyłek przy zakupie zmniejsza się u źródła: pełne dane w ofercie i tabela rozmiarowa.
Jak zsynchronizować stany, gdy sprzedajemy w kilku kanałach?
Zaczynamy od ustalenia jednego źródła prawdy: ERP, sklep albo Wasza baza. Każda sprzedaż i każdy zwrot zmienia stan w tym jednym miejscu, a integracja propaguje zmianę do Allegro i do pozostałych kanałów przez ich API. Bez tego kroku synchronizacja jest tylko przepisywaniem liczb i wcześniej czy później skończy się sprzedażą ponad stan.
Co się dzieje, gdy Allegro API zwróci błąd albo nie odpowie?
Nieudane wywołanie idzie do kolejki błędów i jest ponawiane z rosnącym odstępem, a nie porzucane. Monitoring pilnuje błędów 4xx i 5xx, przekroczonego limitu zapytań i nieudanego odświeżenia tokenu, i wysyła alert do nas oraz do Was. Każde wywołanie zostaje w logu, więc po tygodniu wiadomo, ile zamówień weszło samo, a ile wymagało ręki człowieka.
Ile trwa wdrożenie integracji z Allegro?
Tydzień warsztatu i 2 do 4 tygodni wdrożenia, przy szerszym zakresie dłużej. Pierwszy działający przepływ, zwykle pobieranie zamówień i dokument w ERP, uruchamiamy około 14 dni od warsztatu. Prowadzimy najwyżej dwa wdrożenia równocześnie, więc termin startu ustalamy na konsultacji, a nie po podpisaniu.
Sprawdźmy, co da się spiąć w Waszym Allegro
Bezpłatna konsultacja trwa 30 minut. Opowiadasz, ile zamówień dziennie schodzi z Allegro, co dziś przepisujecie ręcznie i na czym stoi magazyn. Mówimy, co da się spiąć przez API od razu, co obsłuży gotowy konektor bez naszego udziału i co wymaga najpierw porządku w danych o produktach. Nie musisz na tym etapie dawać nam żadnych dostępów.
Prowadzimy najwyżej dwa wdrożenia równocześnie, żeby przy każdym ktoś realnie siedział.
Umów bezpłatną konsultacjęPS. Jeśli ktoś u Was przepisuje zamówienia z panelu Allegro do ERP, to jest dokładnie ten problem. Po wdrożeniu zamówienie ma dokument, etykietę i numer śledzenia bez udziału człowieka, a nieudane wywołanie stoi w kolejce błędów z alertem, zamiast ginąć po cichu. Zaczynamy od warsztatu, nie od dostępów do konta.