Integracja API REST (OAuth 2.0) E-commerce i marketplace

Allegro API
— integracja i automatyzacja
procesów B2B

Allegro to największy marketplace w Polsce — ponad 22 miliony aktywnych kupujących i 135 000 sprzedawców. API Allegro REST (wersja 2.0) pozwala zarządzać ofertami, zamówieniami, stanami magazynowymi, reklamacjami i fakturami — wszystko automatycznie, bez logowania do panelu. Dla sklepów sprzedających na Allegro równolegle z innymi kanałami automatyzacja API to jedyna droga do zachowania spójności danych.

Parametry techniczne Allegro API

Typ API
REST (OAuth 2.0)
Autoryzacja
OAuth 2.0 (Client Credentials / Authorization Code)
Kategoria
E-commerce i marketplace
Dokumentacja

5 sposobów automatyzacji z Allegro API

Poniżej znajdziesz konkretne zastosowania Allegro API w projektach automatyzacji procesów B2B — z opisem logiki, endpointów i realnej oszczędności czasu.

1

Automatyczna synchronizacja stanów magazynowych między Allegro a ERP/sklepem

Gdy stan magazynowy w Subiekcie lub WooCommerce spada poniżej progu, automatyzacja (Make lub n8n) odpytuje GET /offers/listing i aktualizuje ilość dostępnych sztuk na Allegro przez PUT /sale/offers/{offerId}. Eliminuje sprzedaż ponad stan — jeden z największych problemów multichannel.

GET /offers/listingPUT /sale/offers/{offerId}GET /sale/offer-price-change-commands
2

Import zamówień Allegro do systemu ERP i generowanie dokumentów WZ

Codziennie rano skrypt pobiera nowe zamówienia (GET /order/checkout-forms?status=READY_FOR_PROCESSING), mapuje dane kupującego i pozycji na format Subiekta nexo i tworzy dokumenty WZ przez Subiekt API. Kurier jest zgłaszany automatycznie przez API InPost lub DPD.

GET /order/checkout-formsGET /order/checkout-forms/{id}POST /order/checkout-forms/{id}/shipments
3

Automatyczne odpowiedzi na wiadomości kupujących i obsługa zwrotów

Bot monitoruje GET /messaging/threads co 15 minut. Dla wiadomości z typowymi pytaniami (status zamówienia, czas wysyłki) odpowiada automatycznie na podstawie szablonów i danych z zamówienia. Dla wniosków o zwrot tworzy zadanie w ClickUp dla działu obsługi.

GET /messaging/threadsPOST /messaging/threads/{threadId}/messagesGET /order/refund-claims
4

Monitoring cen konkurencji i automatyczna korekta ofert

Skrypt pobiera ceny ofert z danej kategorii (GET /offers/listing?category.id=X), porównuje z cenami własnych ofert i jeśli konkurencja jest tańsza o ustalony próg — obniża cenę przez PUT /sale/offers/{id} lub zgłasza alert do Slack. Działa 24/7 bez ingerencji.

GET /offers/listingPUT /sale/offers/{offerId}GET /sale/price-automation-rules
5

Raportowanie sprzedaży Allegro w Google Sheets lub BigQuery

Tygodniowy skrypt zbiera dane ze sprzedaży (GET /order/checkout-forms?status=BOUGHT, paginacja), agreguje po SKU, kategorii i dacie, i ładuje do Google Sheets lub BigQuery. CFO dostaje gotowy dashboard bez eksportów CSV z panelu Allegro.

GET /order/checkout-formsGET /order/order-eventsGET /sale/statistics

Kluczowe endpointy Allegro API

Poniżej lista endpointów najczęściej używanych w automatyzacjach. Każdy endpoint jest częścią standardowego REST API i obsługuje autentykację przez OAuth 2.0 (Client Credentials / Authorization Code).

GET /order/checkout-forms Lista zamówień z filtrowaniem po statusie i dacie
GET /order/checkout-forms/{id} Szczegóły zamówienia — kupujący, pozycje, adres dostawy
POST /order/checkout-forms/{id}/shipments Utwórz wysyłkę i przypisz numer śledzenia
GET /offers/listing Lista własnych ofert z cenami i stanami
PUT /sale/offers/{offerId} Zaktualizuj ofertę — cena, stock, tytuł, zdjęcia
GET /messaging/threads Wiadomości od kupujących
POST /messaging/threads/{threadId}/messages Wyślij wiadomość do kupującego
Wskazówka

Zanim wdrożysz integrację produkcyjnie, przetestuj endpointy w środowisku sandbox (jeśli dostępne) lub na dedykowanym koncie testowym. Dla Allegro API dokumentację techniczną znajdziesz na https://developer.allegro.pl.

Przykładowy przepływ: Przepływ: Nowe zamówienie Allegro → Subiekt WZ → InPost kurier → e-mail klient

  1. Make odpytuje GET /order/checkout-forms?status=READY_FOR_PROCESSING co 15 minut
  2. Dla nowych zamówień Make pobiera szczegóły: kupujący, pozycje, adres
  3. Make tworzy dokument WZ w Subiekcie nexo przez API (REST)
  4. Make sprawdza metodę dostawy — jeśli InPost Paczkomat, wywołuje InPost Shipping API (POST /v1/shipments)
  5. InPost zwraca etykietę PDF i numer przesyłki
  6. Make aktualizuje zamówienie Allegro: POST /order/checkout-forms/{id}/shipments z numerem śledzenia
  7. Make wysyła e-mail do kupującego z potwierdzeniem wysyłki i linkiem do śledzenia
⏱ 45–90 sekund od złożenia zamówienia
Czas realizacji
📈 8–12 min ręcznej pracy na zamówienie
Oszczędność

Jak JustAutomate wdraża integracje Allegro

W projektach JustAutomate integracja Allegro API to jeden z najczęstszych elementów automatyzacji. Nasz proces zaczyna się od audytu API — sprawdzamy dostępne endpointy, rate limity, stabilność tokenów i formatów danych po stronie klienta.

W większości przypadków używamy Make lub n8n jako middleware — narzędzia, które łączą Allegro z innymi systemami bez pisania kodu. Dla złożonych przypadków (własna logika transformacji danych, integracja z legacy systemem, niestandardowe formaty) piszemy skrypty Node.js lub Python z pełną obsługą błędów i logowaniem.

Każda integracja, którą budujemy, ma monitoring — wiemy natychmiast, gdy API zwróci błąd 5xx lub przekroczymy rate limit. Klient nie dowiaduje się o awarii z opóźnieniem — system jest samo-naprawiający i alertuje nas zanim wpłynie to na procesy.

Bezpłatna konsultacja

Jeśli chcesz zintegrować Allegro ze swoimi systemami, możemy omówić zakres i ROI w 30-minutowej rozmowie. Pierwsza konsultacja jest bezpłatna.

FAQ — najczęstsze pytania o Allegro API

Jak uzyskać dostęp do API Allegro?

Zarejestruj aplikację w Allegro Developer Console (developer.allegro.pl). Wybierz typ flow: Client Credentials (dla operacji na własnym koncie) lub Authorization Code (gdy użytkownicy autoryzują Twoją aplikację). Client ID i Client Secret to dane do generowania tokenów OAuth 2.0. Token wygasa co godzinę — implementuj automatyczne odświeżanie.

Ile kosztuje dostęp do API Allegro?

API Allegro jest bezpłatne dla sprzedawców z aktywnym kontem. Limity: 9000 requestów na godzinę (standardowe konto) lub 18000 dla kont z wyższymi planami. Przy intensywnym użyciu (synchronizacja co minutę) implementuj kolejkowanie requestów.

Czy API Allegro obsługuje środowisko sandbox do testów?

Tak. Sandbox Allegro dostępny pod allegro.pl.allegrosandbox.pl ma oddzielne konto i dane testowe. Tokeny sandbox generujesz z tymi samymi danymi aplikacji, ale endpoint autoryzacji to allegro.pl.allegrosandbox.pl/auth/oauth. Zalecamy testowanie wszystkich przepływów w sandboxie przed produkcją.

Jak synchronizować stany magazynowe między Allegro a kilkoma kanałami?

Potrzebujesz "single source of truth" — Subiekt, WooCommerce lub własna baza. Każda sprzedaż (na Allegro, w sklepie, przez CRM) dekrementuje centralny stan. Automatyzacja propaguje zmianę do wszystkich kanałów przez ich API. Make i n8n mają gotowe moduły Allegro do tego scenariusza.

Czy mogę automatycznie wystawiać faktury do zamówień Allegro?

Tak. Integracja Allegro → Fakturownia lub iFirma przez Make: nowe zamówienie (status READY_FOR_PROCESSING) triggeruje webhook, Make pobiera dane kupującego i NIP (jeśli podany) i tworzy fakturę lub paragon w systemie księgowym. Faktura wraca do kupującego e-mailem automatycznie.

Wdrożenie pod klucz

Potrzebujesz integracji Allegro
w swoich procesach?

Budujemy integracje Allegro API z CRM, ERP, fakturowaniem i narzędziami AI. Bezpłatna konsultacja — 30 minut, konkretny plan z ROI.

Bezpłatna konsultacja Wróć do: Co to jest API?