Integracja Allegro ze sklepem i hurtownią B2B – API czy BaseLinker

Dla wielu polskich sklepów i hurtowni Allegro to największy pojedynczy kanał sprzedaży. Problem w tym, że panel Allegro nie wie nic o Twoim magazynie, ERP ani cennikach. Dopóki ktoś przepisuje stany ręcznie, prędzej czy później sprzedasz towar, którego nie ma – albo przegapisz zamówienie, bo utknęło w jednym z trzech paneli. Integracja Allegro zamyka ten temat: stany, ceny i zamówienia płyną automatem. Pytanie brzmi tylko, którą drogą – gotowym integratorem typu BaseLinker czy integracją własną przez Allegro API. Poniżej mapa decyzji z wdrożeń, które robiliśmy dla sklepów i hurtowni B2B.

Co realnie daje integracja Allegro ze sklepem i hurtownią

Dobrze zrobiona integracja spina cztery przepływy:

• stany magazynowe – sprzedaż w sklepie od razu obniża dostępność na Allegro i odwrotnie, więc znika klasyczny oversell,
• ceny – zmiana w ERP lub sklepie propaguje się na oferty bez ręcznego klikania, z osobnymi regułami dla Allegro,
• zamówienia – zakupy z Allegro wpadają do tego samego obiegu co zamówienia ze sklepu: jeden magazyn, jedna wysyłka, jedno fakturowanie,
• oferty – wystawianie i aktualizacja z jednej bazy produktowej, zamiast utrzymywania opisów w dwóch miejscach.

Bez tego Allegro jest osobnym silosem, a każda osoba w firmie ma inną odpowiedź na pytanie „ile sztuk mamy naprawdę”.

Allegro API – co udostępnia REST API

Jedynym aktualnie rozwijanym interfejsem jest Allegro REST API. Dostęp jest bezpłatny: rejestrujesz aplikację na developer.allegro.pl, autoryzujesz się przez OAuth 2.0, a do testów masz osobne środowisko sandbox. Z perspektywy integracji najważniejsze obszary to:

• oferty – zasoby /sale/product-offers powiązane z Katalogiem Produktów Allegro: tworzenie i edycja ofert na bazie kartoteki produktowej,
• grupowe zmiany cen i stanów – komendy typu offer-price-change-commands i offer-quantity-change-commands, które zmieniają wiele ofert jednym żądaniem zamiast serii pojedynczych,
• dziennik zdarzeń zamówień – GET /order/events, czyli zalecany sposób monitorowania sprzedaży: odpytujesz log zdarzeń, a nie listę zamówień,
• zamówienia – GET /order/checkout-forms z danymi kupującego i dostawy, PUT .../fulfillment do statusów, POST .../shipments do numerów śledzenia,
• rozliczenia – wpisy billingowe, z których odczytasz naliczone prowizje i opłaty.

To kompletny zestaw do zbudowania pełnej synchronizacji. Tyle że ktoś musi go oprogramować i utrzymywać – i właśnie o to rozbija się wybór drogi.

Integracja Allegro z BaseLinkerem – kiedy wystarczy

Dla większości sklepów detalicznych pierwszym wyborem będzie gotowy integrator. BaseLinker ma utrzymywany konektor Allegro: wystawianie ofert, pobieranie zamówień, synchronizację stanów z własnego magazynu i automatyzacje „jeśli – to”. Nie potrzebujesz programisty, a zmiany w Allegro API obsługuje za Ciebie dostawca. Szerzej opisaliśmy to narzędzie w tekście czym jest BaseLinker i jak spiąć go ze sklepem.

Integracja allegro baselinker sprawdza się, gdy:

• sprzedajesz wielokanałowo i głównym bólem jest agregacja zamówień,
• logika cen i stanów jest standardowa: jedna cena, jeden stan, proste narzuty,
• wolumen mieści się w abonamencie i nie masz nietypowego ERP.

To dobra droga na start i często wystarcza na lata. Ma jednak sufit.

Kiedy integracja własna przez Allegro API

Własny middleware między Allegro a sklepem lub ERP wchodzi w grę, gdy logika wykracza poza gotowe klocki. W praktyce wdrożeń B2B widzimy trzy powtarzalne powody:

1. Reguły cenowe i stanowe, których integrator nie zna. Hurtownia z indywidualnymi cennikami B2B zwykle chce na Allegro wystawiać cenę detaliczną z innym narzutem, pilnować minimalnej marży po prowizji i rezerwować część stanu dla stałych kontrahentów. To logika biznesowa, nie konfiguracja.
2. Nietypowy ERP albo własna platforma. Gdy sklep stoi na Medusa.js, naturalnym ruchem jest moduł, który słucha zdarzeń z platformy (zmiana stanu, ceny, nowy produkt) i przekłada je na komendy Allegro API – z pełną kontrolą kolejności, buforowaniem i ponowieniami. Ten sam wzorzec co przy integracji Subiekta GT ze sklepem: jedno źródło prawdy i cienka warstwa tłumacząca.
3. Skala i koszty. Przy dużym wolumenie abonament integratora rośnie, a własna integracja to koszt jednorazowy plus utrzymanie. Rachunek trzeba policzyć na własnych liczbach, ale od pewnego progu przestaje być oczywisty na korzyść SaaS-a.

Te drogi się nie wykluczają: częsty układ to BaseLinker do logistyki i etykiet plus własny moduł pilnujący cen i stanów według reguł firmy.

Synchronizacja stanów i cen z hurtownią i ERP

Niezależnie od drogi, o sukcesie decyduje architektura przepływów, nie narzędzie. Trzy zasady z wdrożeń:

• Jedno źródło prawdy. Stany ustala ERP albo magazyn hurtowni, nigdy dwa systemy naraz. Allegro jest zawsze odbiorcą stanu, a nadawcą wyłącznie zamówień.
• Bufor bezpieczeństwa. Na Allegro wystawiaj stan pomniejszony o bufor (np. rezerwę dla kanału B2B). Opóźnienie synchronizacji zawsze istnieje – bufor zamienia oversell w rzadkość zamiast codzienność.
• Osobna polityka cen dla Allegro. Prowizja od sprzedaży zależy od kategorii i potrafi zjeść marżę, jeśli bezmyślnie kopiujesz cenę ze sklepu. Reguła typu „cena bazowa plus narzut kanału” powinna być jawnie zapisana w integracji, a rozliczenia warto kontrolować po wpisach billingowych z API.

Jeśli dopiero projektujesz sprzedaż hurtową online, ten temat jest częścią większej układanki – opisaliśmy ją w przewodniku po budowie hurtowni online.

Obsługa zamówień z Allegro

Najczęstszy błąd początkujących integracji: cykliczne pobieranie listy checkout-forms i porównywanie jej ze stanem lokalnym. Allegro zaleca inaczej – odpytywanie dziennika zdarzeń GET /order/events, który zwraca kolejne zdarzenia (nowe zamówienie, zmiana statusu) i pozwala niczego nie zgubić nawet przy chwilowej awarii integracji. Szczegóły zamówienia dociągasz wtedy punktowo, ustawiasz status realizacji przez fulfillment i odsyłasz numer przesyłki. Dla kupujących na firmę z zamówienia odczytasz dane do faktury z NIP-em, co przy sprzedaży B2B na Allegro jest codziennością.

Pułapki: limity API, warianty, prowizje

Limity zapytań

Podstawowy limit to 9000 zapytań na minutę na Client ID, ale wybrane zasoby mają własne, niższe progi – np. dla /sale/product-offers/{offerId} Allegro wprowadziło limit 3500 zapytań na minutę dla GET i 2500 dla PATCH. Do tego działa mechanizm leaky bucket per użytkownik: za dużo równoległych żądań kończy się błędem 429. Wnioski praktyczne: zmiany cen i stanów rób komendami grupowymi zamiast pojedynczych żądań, a integracja musi mieć kolejkę i ponowienia z odczekaniem.

Oferty wielowariantowe

Tu w 2026 zaszła duża zmiana: 14 kwietnia 2026 Allegro wyłączyło zasoby /sale/offer-variants do ręcznego łączenia ofert w zestawy wariantów. Zastąpiły je warianty produktowe budowane automatycznie na podstawie Katalogu Produktów. Jeśli integracja powstała wcześniej i tworzyła zestawy wariantów po staremu, dziś dostaje 404. W nowych integracjach kluczowe staje się porządne dopasowanie produktów do katalogu Allegro – najlepiej po EAN – bo to od kartoteki produktowej zależy, jak warianty się sklejają.

Prowizje i marża

Prowizja naliczana jest od sprzedaży i zależy od kategorii. W hurtowni, gdzie marże bywają jednocyfrowe, ta sama cena co w sklepie własnym może oznaczać sprzedaż poniżej progu opłacalności. Integracja powinna to egzekwować automatycznie: minimalna marża po prowizji jako twarda reguła, nie dobra wola operatora.

Od czego zacząć

Sytuacja	Sensowna droga
Detal, standardowa logika, szybki start	BaseLinker lub inny integrator
Hurtownia B2B, własne reguły cen i stanów	Integracja własna przez Allegro API
Duży wolumen, nietypowy ERP	Własny middleware, często obok integratora

Zacznij od decyzji, kto jest źródłem prawdy o stanach i cenach, potem wybierz drogę integracji – a nie odwrotnie. Gotowy integrator załatwia 80% standardowych przypadków, ale w B2B to właśnie pozostałe 20% decyduje o marży. Projektowanie i budowa takich przepływów, od Allegro przez ERP po sklep, to dokładnie zakres naszej oferty integracji systemów.