--- title: "Allegro API: integracja w 2 do 4 tygodni | JustAutomate" description: "Zamówienia, oferty i stany z Allegro przez API: token OAuth odświeżany sam, pobieranie przyrostowe, kolejka i ponawianie. Testy w sandboxie, nie u Was." url: "https://justautomate.ai/api/allegro/" lang: pl --- Integracje przez API # 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. Umów bezpłatną konsultację [Zobacz, jak wygląda warsztat](https://justautomate.ai/produkty/warsztat-procesowy/) - 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](https://developer.allegro.pl/documentation), 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. 1. ### 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. 2. ### 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. 3. ### 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. 4. ### 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. 5. ### 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 Zacznij od warsztatu - 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 Umów rozmowę o wdrożeniu - ### 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 Zapytaj o agenta 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ę](https://justautomate.ai/kontakt/) **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. ## Powiązane - [Integracja z BaseLinker](https://justautomate.ai/integracje/baselinker/) - [Integracja systemów przez API](https://justautomate.ai/uslugi/integracja-api/) - [Automatyzacja e-commerce](https://justautomate.ai/dla/e-commerce/) - [Subiekt nexo API](https://justautomate.ai/api/subiekt/) - [Fakturownia API](https://justautomate.ai/api/fakturownia/) - [Warsztat procesowy](https://justautomate.ai/produkty/warsztat-procesowy/) --- **JustAutomate** · kontakt: contact@justautomate.ai · formularz: https://justautomate.ai/kontakt/