Integracja Allegro ze sklepem internetowym: jak połączyć zamówienia i stany

Co znaczy integracja Allegro ze sklepem

Integracja to stała wymiana danych między Twoim kontem sprzedawcy na Allegro a sklepem albo systemem, który obsługuje oba kanały. Allegro udostępnia do tego REST API opisane na developer.allegro.pl. Z tego samego API korzysta wtyczka sklepu, integrator i integracja pisana na zamówienie. Różnią się tym, co synchronizują, jak często to robią i kto je utrzymuje, gdy Allegro zmienia API.

Co musi się synchronizować i w którą stronę

Zamówienie z Allegro przynosi dane do faktury, jeśli klient ich zażądał: nazwę firmy i NIP. Dzięki temu dokument da się wybrać automatycznie, o czym piszemy w artykule KSeF dla sprzedawców internetowych 2026.

Trzy sposoby połączenia

1. Połączenie w platformie sklepu

Część platform sklepowych ma drogę do Allegro w swoim panelu. Przykład: Shoper w swoim centrum wiedzy (artykuł zaktualizowany 02.07.2026) opisuje podłączenie Allegro przez aplikację Apilo (Apilo należy do Grupy Shoper), która jest domyślnie zainstalowana w sklepie. Ceny i stany zmieniasz wtedy tylko w panelu Apilo, bo zmiany zrobione w Shoperze lub na Allegro zostaną nadpisane, a zamówienia z Allegro trafiają do sklepu po włączeniu tej opcji w ustawieniach kanału. W praktyce to też integrator, uruchamiany z panelu sklepu. WooCommerce i PrestaShop łączysz z Allegro przez wtyczki lub moduły firm zewnętrznych albo przez integrator.

Ta droga wystarcza, gdy sprzedajesz tylko w sklepie i na Allegro. Przy kolejnym kanale, np. Erli albo Empik, i tak potrzebujesz narzędzia, które obsłuży wszystkie naraz.

2. Integrator

Integrator (Base.com, Apilo, Sellasist, Commerce OS Integrator i inne) pobiera zamówienia z Allegro, sklepu i innych kanałów do jednego panelu, prowadzi wspólne stany i drukuje etykiety. Abonament według oficjalnych cenników, netto miesięcznie, dla Commerce OS Integrator przy dwóch kanałach (Allegro i sklep):

Przy samym abonamencie najtańsze są Apilo i Sellasist. Do 100 zamówień możesz korzystać z Base Freemium za 0 zł. Oprócz ceny porównaj, jak często narzędzie aktualizuje stany, bo od tego zależy ryzyko sprzedaży tej samej sztuki dwa razy:

3. Własna integracja przez API Allegro

Własna integracja ma sens, gdy masz własny ERP lub WMS albo nietypowy proces, którego gotowe narzędzia nie obsługują. Według dokumentacji Allegro wymaga ona m.in.:

• aplikacji zarejestrowanej w Allegro i autoryzacji konta sprzedawcy (OAuth) z odświeżaniem tokenów,
• regularnego pobierania zdarzeń z dziennika zamówień (/order/events), który Allegro zaleca do śledzenia nowych zamówień, w tym anulowań,
• wysyłania statusu realizacji i numerów przesyłek do zamówienia, z identyfikatorem przewoźnika,
• obsługi limitów zapytań i zmian w API.

To koszt jednorazowy i stałe utrzymanie. U nas integracja przez API spoza listy kosztuje od 4 900 zł netto, z ceną i terminem podanymi przed rozpoczęciem pracy.

Pułapki, które psują stany i statusy

Zestawy i opakowania zbiorcze

Oferta „zestaw 3 sztuk” zużywa trzy sztuki produktu, a oferta z kompletem kilku różnych produktów zużywa po sztuce z każdego. Jeśli integracja traktuje taką ofertę jak jedną sztukę, stan w magazynie rozjeżdża się po pierwszej sprzedaży. Sprawdź, czy narzędzie pozwala podać liczbę sztuk w ofercie albo zbudować zestaw ze składników, którego stan liczy się z najmniejszego stanu składnika. Przetestuj to na jednym zestawie przed podłączeniem całej oferty.

Sprzedaż tej samej sztuki dwa razy

Ryzyko rośnie z czasem między sprzedażą a aktualizacją stanu w drugim kanale. Przy produktach, których masz jedną lub dwie sztuki, ustaw na Allegro bufor, czyli wystawiaj o sztukę mniej, niż masz na półce. Integratory zwykle mają też opcję automatycznego zamykania oferty przy zerowym stanie, a Base wymienia ją w cenniku. Najważniejsze, żeby stan oferty zmieniało tylko jedno narzędzie. Stara wtyczka i nowy integrator podłączone naraz nadpisują sobie nawzajem stany.

Mapowanie statusów

Allegro ma własne statusy realizacji, m.in. NEW, PROCESSING (w realizacji), READY_FOR_SHIPMENT (gotowe do wysyłki), SENT (wysłane) i PICKED_UP (odebrane). Twój sklep ma inne. Ustal, który status w panelu odpowiada któremu statusowi na Allegro, i sprawdź na zamówieniu testowym trzy przypadki: zwykłą wysyłkę, anulowanie przed wysyłką (towar musi wrócić na stan) i wysyłkę w dwóch paczkach.

SKU i sygnatura oferty

Integrator łączy ofertę z produktem po kodzie. Najprościej, gdy w polu sygnatury oferty na Allegro jest ten sam SKU co w sklepie. Gdy ten sam produkt ma różne SKU w kanałach, stany nie połączą się same i trzeba je powiązać ręcznie.

Tabela decyzji

Jak to działa w Commerce OS Integrator

W Commerce OS Integrator konto sprzedawcy Allegro łączymy na wdrożeniu. Zamówienia z Allegro, własnego sklepu, Erli, Empik, Kaufland, Amazon i eBay trafiają na jedną listę z folderami statusów. Stany z kilku magazynów są w jednym miejscu i wracają do kanałów sprzedaży bez przepisywania. Numer przesyłki wraca do Allegro sam, wiadomości z Allegro są w panelu, a automatyczne ceny na Allegro pilnują minimalnego zysku na sztuce. Faktury idą do KSeF, paragony drukują się na drukarce fiskalnej.

Sklep możesz mieć w tym samym panelu albo zostać przy WooCommerce, PrestaShop, Shoper lub IdoSell, z których pobieramy zamówienia. Plan Integrator Start kosztuje 345 zł netto miesięcznie z 300 zamówieniami i do 3 kanałów, a Wdrożenie Start 2 490 zł jednorazowo. Szczegóły są w cenniku Integratora. Jeśli dziś łączysz Allegro ze sklepem przez BaseLinkera, zobacz migrację z BaseLinkera i policz zwrot z migracji.

Jak uruchomić integrację krok po kroku

1. Spisz kanały, konta Allegro, liczbę zamówień i aktywnych ofert miesięcznie.
2. Uporządkuj SKU: ten sam produkt ma ten sam kod w sklepie i w sygnaturze oferty.
3. Zdecyduj, w którym narzędziu zmieniasz stany i ceny, i wyłącz tę funkcję w pozostałych.
4. Ustal mapowanie statusów i sprawdź anulowanie na jednym zamówieniu.
5. Przetestuj jeden zestaw i jeden produkt z małym stanem w obu kanałach.
6. Podłączaj resztę oferty partiami i przez pierwszy tydzień porównuj stany w obu kanałach.