Integracja WooCommerce z Allegro - wtyczka czy własne rozwiązanie

Łukasz Palej

Technical Implementation Expert

27.01.2026

Integracja WooCommerce z Allegro - wtyczka czy własne rozwiązanie

Wsparcie programistyczne dla e-commerce

Łukasz PalejTechnical Implementation Expert

Programiści

Integrację WooCommerce z Allegro można zrobić gotową wtyczką, przez integrator, taki jak Base, albo własnym rozwiązaniem napisanym na WooCommerce REST API i Allegro REST API. Wtyczka wystarczy, gdy masz jedno konto Allegro, prosty katalog i kilkadziesiąt zamówień dziennie. Własne rozwiązanie ma sens wtedy, gdy proces wyraźnie odbiega od standardu: ceny liczysz według własnych reguł, katalog zasilasz z hurtowni, a zamówienia muszą trafiać do ERP albo magazynu zewnętrznego.

W tym wpisie wyjaśniamy, czym różnią się te trzy drogi, jakie ograniczenia ma WordPress jako baza integracji i po czym poznać, że wtyczka przestała wystarczać. Tekst jest dla właścicieli sklepów na WooCommerce, którzy sprzedają albo chcą sprzedawać na Allegro i zastanawiają się, ile pracy programistycznej to wymaga.

[#wazne] W skrócie: integracja WooCommerce z Allegro przez wtyczkę jest najtańsza na start i wystarcza przy jednym koncie, prostych wariantach i umiarkowanej liczbie zamówień. Przy kilku kanałach sprzedaży lepiej sprawdza się integrator, np. Base, a przy nietypowych regułach cen, dużym katalogu lub połączeniu z ERP - dedykowana integracja działająca poza WordPressem. Vinson jest certyfikowanym partnerem Base, a nasi programiści konfigurują wtyczki, wdrażają integratory i piszą własne integracje WooCommerce z Allegro.

Jak działa integracja WooCommerce z Allegro

Integracja WooCommerce z Allegro to połączenie, które przenosi dane między sklepem na WordPressie a kontem sprzedawcy na Allegro. Obejmuje zwykle cztery przepływy: wystawianie ofert z produktów sklepu, synchronizację stanów magazynowych, synchronizację cen oraz import zamówień z Allegro do WooCommerce. Bardziej rozbudowane integracje przekazują też numery przesyłek, statusy realizacji i dane do faktury.

Po stronie Allegro wszystkie te operacje idą przez Allegro REST API. Aplikację trzeba zarejestrować w portalu dla deweloperów Allegro, a sprzedawca autoryzuje ją przez OAuth 2.0. Token dostępu jest ważny krótko i odświeża się go tokenem odświeżającym, więc integracja musi przechowywać tokeny bezpiecznie i odnawiać je automatycznie. Allegro udostępnia też środowisko testowe (sandbox), na którym można sprawdzić integrację bez ryzyka dla prawdziwych ofert.

Po stronie WooCommerce dane można odczytywać i zapisywać przez WooCommerce REST API (klucze generuje się w ustawieniach zaawansowanych sklepu) albo bezpośrednio przez funkcje WordPressa, jeśli integracja działa jako wtyczka na tym samym serwerze. WooCommerce ma też webhooki, które informują zewnętrzny system o utworzeniu zamówienia albo zmianie produktu.

Tak wygląda decyzja między gotową wtyczką a dedykowaną integracją w najczęstszych sytuacjach:

[#chart:wpr21a]

Wtyczka WooCommerce Allegro - kiedy wystarczy

Na rynku jest kilka płatnych wtyczek, które łączą WooCommerce z Allegro. Instaluje się je w panelu WordPressa, autoryzuje konto Allegro i mapuje kategorie, parametry oraz metody dostawy. Ich największą zaletą jest szybki start: podstawowe wystawianie ofert i import zamówień da się uruchomić w kilka dni, a koszt to licencja wtyczki.

Wtyczka zwykle wystarczy, gdy spełnione są te warunki:

sprzedajesz z jednego konta Allegro i jednego magazynu,
produkty mają proste warianty i unikalne kody SKU lub EAN,
ceny na Allegro są takie same jak w sklepie albo różnią się stałym narzutem,
zamówień jest tyle, że opóźnienie synchronizacji o kilka minut nie powoduje sprzedaży bez pokrycia,
nie potrzebujesz przekazywać zamówień do ERP ani zewnętrznego magazynu.

Ograniczenia wtyczek po stronie WordPressa

Wtyczka działa wewnątrz WordPressa, więc dzieli z nim zasoby serwera i mechanizmy. Zadania cykliczne w WordPressie (WP-Cron) uruchamiają się przy wejściach na stronę, a nie o stałej godzinie, chyba że administrator podłączy je do systemowego crona. Wiele wtyczek korzysta też z Action Scheduler, czyli kolejki zadań WooCommerce. Gdy katalog liczy tysiące produktów, a kolejka rośnie szybciej, niż serwer ją przetwarza, synchronizacja stanów zaczyna się opóźniać. Do tego dochodzą konflikty z innymi wtyczkami i aktualizacje WooCommerce, po których wtyczka integracyjna wymaga poprawki od producenta.

[#tip] Jeśli zostajesz przy wtyczce, ustaw prawdziwy cron systemowy zamiast WP-Cron i regularnie sprawdzaj kolejkę zadań w WooCommerce (Narzędzia - Zaplanowane działania). Nieprzetworzone lub nieudane zadania to pierwszy sygnał, że synchronizacja z Allegro nie nadąża.

Bezpłatna konsultacja programistyczna

Potrzebujesz programisty do sklepu, integracji lub automatyzacji?

Wycena zadania w 24 h w dni robocze
Integracje, API, feedy i poprawki w sklepie
Rozliczenie godzinowe albo za projekt

Konsultację poprowadzi Łukasz Palej, Technical Implementation Expert

Zobacz szczegóły usługi →

Integrator czy własne rozwiązanie dla WooCommerce i Allegro

Między wtyczką a pisaniem integracji od zera jest trzecia droga: integrator. Sklep WooCommerce i konto Allegro łączą się wtedy z jednym systemem, który zbiera zamówienia, pilnuje stanów i obsługuje wysyłki. Taki układ dobrze sprawdza się przy sprzedaży wielokanałowej, bo do integratora można podłączyć też inne marketplace'y, kurierów i program do faktur.

Rozwiązanie	Jak działa	Dla kogo	Ograniczenia
Wtyczka w WordPressie	Integracja działa wewnątrz sklepu, wystawia oferty i importuje zamówienia	Jedno konto Allegro, prosty katalog, mały wolumen	Zależność od WP-Cron, wydajności serwera i aktualizacji WooCommerce
Integrator, np. Base	Sklep i Allegro łączą się z jednym systemem do zamówień, stanów i wysyłek	Kilka kanałów sprzedaży, kurierzy, automatyzacja dokumentów	Abonament, konieczność ustalenia źródła prawdy dla danych
Dedykowana integracja	Osobna usługa łączy WooCommerce REST API, Allegro REST API i ewentualnie ERP	Nietypowe reguły cen, duże katalogi, ERP lub WMS	Koszt wytworzenia i utrzymania, aktualizacje przy zmianach API

Wybór między integratorem a własnym rozwiązaniem opisujemy szerzej w artykule integracja API sklepu internetowego - jak to działa. Krótko: integrator wygrywa, gdy potrzebujesz wielu standardowych połączeń, a dedykowana integracja - gdy kluczowa jest logika, której żaden gotowy system nie ma.

Dedykowana integracja WooCommerce z Allegro - jak jest zbudowana

Dedykowana integracja to zwykle osobna usługa działająca na własnym serwerze lub w chmurze, a nie wtyczka w WordPressie. Dzięki temu nie obciąża sklepu, może pracować według własnego harmonogramu i ma własne logi. Do WooCommerce łączy się przez REST API lub webhooki, do Allegro przez Allegro REST API.

Najważniejszy jest przepływ zamówienia. Allegro udostępnia dziennik zdarzeń zamówień, który integracja odpytuje cyklicznie, zapamiętując ostatnie przetworzone zdarzenie. Dzięki temu nie pomija zamówień nawet po chwilowej awarii. Tak wygląda typowa ścieżka zamówienia z Allegro do WooCommerce:

[#chart:wpr21b]

Elementy, które odróżniają integrację od skryptu

Mapa identyfikatorów - tabela, która łączy produkt i wariant w WooCommerce z ofertą na Allegro. Bez niej integracja zgaduje po nazwie, a to prowadzi do błędów.
Kolejka zmian - stany i ceny aktualizuje się tylko dla produktów, które się zmieniły, z kontrolą tempa zapytań, żeby nie przekraczać limitów Allegro API.
Odporność na duplikaty - integracja zapisuje identyfikatory zamówień Allegro i nie tworzy drugi raz zamówienia, które już istnieje w WooCommerce.
Logi i powiadomienia - każde nieudane wystawienie oferty lub import zamówienia trafia do raportu, a krytyczne błędy do e-maila lub komunikatora.
Środowisko testowe - kopia sklepu i sandbox Allegro, na których sprawdza się zmiany przed wdrożeniem.

Autoryzacja i limity Allegro API w integracji z WooCommerce

Allegro REST API wymaga, żeby każde zapytanie w imieniu sprzedawcy miało ważny token dostępu. Token dostępu jest ważny 12 godzin, a token odświeżający 3 miesiące (stan na styczeń 2026 - sprawdź aktualną dokumentację Allegro API). Jeśli integracja nie odświeża tokenów na bieżąco, po dłuższej przerwie sprzedawca musi ponownie autoryzować aplikację. Dlatego w dedykowanej integracji tokeny przechowuje się w bazie w postaci zaszyfrowanej, odświeża automatycznie, a każdy błąd autoryzacji od razu wysyła powiadomienie do osoby odpowiedzialnej za sklep.

Allegro ogranicza też liczbę zapytań do API w jednostce czasu. Przy pojedynczych zmianach nie ma to znaczenia, ale przy aktualizacji cen kilku tysięcy ofert naraz integracja, która wysyła zapytania bez kontroli tempa, dostanie odpowiedzi z błędem i część zmian się nie zapisze. Dobrze zbudowana integracja korzysta z poleceń zbiorczych tam, gdzie Allegro je udostępnia, na przykład do zmiany ceny lub liczby sztuk w wielu ofertach, i ponawia nieudane zapytania z opóźnieniem. Wtyczka w WordPressie zwykle nie daje wglądu w takie szczegóły, więc trudniej ustalić, czy zmiana w ogóle dotarła do Allegro.

Przy WooCommerce warto też pamiętać o HPOS, czyli nowym sposobie przechowywania zamówień w osobnych tabelach bazy danych. Od wersji 8.2 jest domyślny w nowych sklepach. Integracja, która zapisuje zamówienia bezpośrednio do bazy w starym formacie, może przestać działać po jego włączeniu, dlatego bezpieczniej korzystać z REST API albo oficjalnych funkcji WooCommerce.

Typowe problemy z integracją WooCommerce Allegro

Niezależnie od wybranej drogi większość zgłoszeń ma kilka powtarzających się przyczyn. Oto te, z którymi sprzedawcy przychodzą do nas najczęściej:

Sprzedaż bez pokrycia - stan w sklepie spadł, ale oferta na Allegro wciąż pokazuje dostępny towar, bo synchronizacja działa co kilkadziesiąt minut albo zatrzymała się kolejka zadań.
Zdublowane zamówienia - wtyczka i integrator importują te same zamówienia równolegle, np. w okresie przejściowym.
Warianty bez kodów - warianty w WooCommerce nie mają unikalnego SKU lub EAN, więc integracja nie potrafi połączyć ich z ofertą.
Parametry kategorii - Allegro w większości kategorii wymaga powiązania oferty z produktem w katalogu i uzupełnienia parametrów, których w sklepie brakuje.
Wygasła autoryzacja - token odświeżający przestał działać i integracja po cichu przestała wysyłać dane.

Poniżej objawy, które widać w panelu sprzedawcy, z przyczyną i poprawkami, od których zaczynamy diagnozę.

[#chart:wpr21c]

Szerzej o tym, jak utrzymać zgodne stany w sklepie i na marketplace, piszemy we wpisie synchronizacja stanów magazynowych między sklepem a marketplace. Przed każdą większą zmianą integracji zrób też pełną kopię sklepu, plików i bazy danych, i sprawdź, że da się ją przywrócić.

Jak przejść z wtyczki na dedykowaną integrację

Najwięcej ryzyka nie leży w programowaniu, tylko w momencie przełączenia, gdy zamówienia z Allegro wpływają bez przerwy. Dlatego migrację planujemy w kilku krokach:

inwentaryzacja produktów i wariantów - uzupełnienie brakujących SKU i EAN,
zbudowanie mapy identyfikatorów ofert Allegro i produktów WooCommerce,
testy na kopii sklepu i w sandboxie Allegro, w tym zamówienia z wariantem, pobraniem i fakturą,
ustalenie daty i godziny przełączenia oraz wyłączenie importu we wtyczce,
kontrola pierwszych zamówień i raportu błędów przez kilka dni po przełączeniu.

[#uwaga] Nie odinstalowuj starej wtyczki od razu po przełączeniu. Najpierw wyłącz w niej import zamówień i synchronizację stanów, a usuń ją dopiero, gdy nowa integracja przez kilka dni działa bez błędów. Część wtyczek przy odinstalowaniu usuwa też swoje dane, w tym powiązania produktów z ofertami.

Jak Vinson pomaga przy integracji WooCommerce z Allegro

Programiści Vinson zaczynają od audytu obecnego połączenia: sprawdzamy, który system importuje zamówienia, jak działają zadania cykliczne i czy produkty mają kody, po których da się je powiązać z ofertami. Jeśli wtyczka wystarcza, konfigurujemy ją poprawnie i ustawiamy monitoring. Jeśli nie, wdrażamy integrator jako certyfikowany partner Base albo piszemy dedykowaną integrację na WooCommerce REST API i Allegro REST API, z kolejką zmian, logami i połączeniem z ERP czy kurierami. Szczegóły współpracy znajdziesz na stronie Wsparcie programistyczne dla e-commerce, a o wdrożeniach integratora - na stronie wdrożenie Base.

Najczęściej zadawane pytania

Czy WooCommerce ma wbudowaną integrację z Allegro?

Nie, WooCommerce nie ma wbudowanej integracji z Allegro. Połączenie zapewnia płatna wtyczka, integrator, np. Base, albo dedykowana integracja napisana na WooCommerce REST API i Allegro REST API. Wybór zależy od liczby kanałów sprzedaży, wielkości katalogu i tego, czy zamówienia mają trafiać do ERP.

Jaka wtyczka do integracji WooCommerce z Allegro jest najlepsza?

Nie ma jednej najlepszej wtyczki dla każdego sklepu. Przy wyborze sprawdź, czy wtyczka obsługuje warianty, powiązanie z katalogiem produktów Allegro, import zamówień przez dziennik zdarzeń i HPOS w WooCommerce. Ważne są też częstotliwość aktualizacji i wsparcie producenta po zmianach w Allegro API.

Dlaczego stany na Allegro nie zgadzają się ze sklepem WooCommerce?

Najczęściej dlatego, że synchronizacja działa przez WP-Cron, który uruchamia się tylko przy ruchu na stronie, albo kolejka zadań w WooCommerce jest zablokowana. Inne przyczyny to brak powiązania wariantu z ofertą lub wygasła autoryzacja konta Allegro. Zacznij od sprawdzenia zaplanowanych działań i logów wtyczki.

Ile kosztuje dedykowana integracja WooCommerce z Allegro?

Koszt zależy od zakresu: liczby przepływów, wariantów, reguł cenowych i tego, czy integracja łączy się też z ERP lub kurierami. Do wyceny potrzebna jest mapa danych i lista wymagań. Trzeba też doliczyć utrzymanie, bo Allegro i WooCommerce regularnie zmieniają swoje API.

Czy można połączyć WooCommerce z kilkoma kontami Allegro?

Tak, ale nie każda wtyczka to obsługuje. Przy kilku kontach lepiej sprawdza się integrator albo dedykowana integracja, która przechowuje osobne tokeny dla każdego konta i dzieli wspólny stan magazynowy między wszystkie oferty.

Integracja WooCommerce z Allegro działa stabilnie wtedy, gdy narzędzie pasuje do skali sprzedaży, a każdy produkt ma jednoznaczne powiązanie z ofertą. Jeśli wtyczka przestała nadążać albo potrzebujesz połączenia z ERP, sprawdź wsparcie programistyczne Vinson. O tym, jak bezpiecznie obsługiwać powiadomienia ze sklepu, przeczytasz we wpisie webhooki w e-commerce - do czego służą.