Integracja Allegro WooCommerce łączy sklep z największym polskim marketplace’em: oferty powstają z produktów w sklepie, stany magazynowe i ceny aktualizują się automatycznie, a zamówienia z obu kanałów trafiają w jedno miejsce.
W tym poradniku przejdziemy przez cały proces: od konta firmowego Allegro, przez wybór integratora, po mapowanie kategorii i zamówienie testowe. Integrację uruchomisz samodzielnie, jeśli masz dostęp do panelu WordPressa i konta Allegro.
Jak działa integracja Allegro WooCommerce

Integracja Allegro WooCommerce to połączenie sklepu z marketplace’em przez API Allegro. Produkty, ceny, stany magazynowe i zamówienia przepływają między systemami automatycznie, zgodnie z ustawionymi przez Ciebie zasadami.
W praktyce produkt z WooCommerce może posłużyć do utworzenia oferty na Allegro. Gdy klient kupi go w jednym kanale, integracja aktualizuje dostępny stan w drugim. Zamówienia z marketplace’u trafiają do wybranego panelu, gdzie możesz wystawić dokument sprzedaży, przygotować etykietę i zmienić status wysyłki.
Allegro nie udostępnia w katalogu WordPressa darmowej oficjalnej wtyczki, która synchronizowałaby oferty z WooCommerce. Oficjalna wtyczka „One by Allegro” służy do obsługi dostaw: tworzenia przesyłek i drukowania etykiet. Nie wystawia produktów ani nie przenosi zamówień między kanałami.
Pozostałe wtyczki znalezione po wpisaniu „Allegro” często wyświetlają oferty na stronie albo nie były aktualizowane od kilku lat. Dlatego standardem stały się zewnętrzne platformy integracyjne. Najczęściej wybierany jest Base, wcześniej działający pod nazwą BaseLinker.
Zanim zaczniesz – konto firmowe Allegro i wymagania

Do sprzedaży w ramach działalności potrzebujesz konta firmowego Allegro z uzupełnionymi danymi firmy. Po stronie sklepu wystarczy działający WooCommerce, dostęp administratora do WordPressa oraz uporządkowany katalog produktów.
Przed uruchomieniem integracji przygotuj:
- dane logowania do firmowego konta Allegro,
- dostęp administracyjny do WordPressa,
- nazwy i opisy produktów,
- zdjęcia w odpowiedniej jakości,
- numery EAN w kategoriach, które ich wymagają,
- informacje o wariantach, takich jak rozmiar czy kolor,
- ustalone ceny i aktualne stany magazynowe.
Sprawdź też koszty sprzedaży. Allegro pobiera prowizję zależną od kategorii produktu. Zwykle wynosi ona od kilku do kilkunastu procent, a aktualne stawki znajdziesz w cenniku dla sprzedających. Podstawą naliczenia prowizji jest wartość zamówienia wraz z kosztem wysyłki opłaconym przez kupującego.
Osobne zasady dotyczą programu Allegro Smart. Sprzedawca współfinansuje dostawy, więc ten koszt również powinien znaleźć się w kalkulacji marży. Najlepiej policzyć go przed wystawieniem ofert, szczególnie przy tanich produktach i niewielkiej marży.
Porządek w katalogu zaoszczędzi Ci sporo czasu. Brakujące EAN-y, przypadkowe nazwy wariantów i zdjęcia przypisane do złych wersji produktu później utrudniają masowe wystawianie ofert.
Sposoby integracji: integrator, dedykowana wtyczka czy API
Integrację z Allegro możesz uruchomić przez platformę integracyjną, rozwiązanie napisane na zamówienie albo wtyczkę do WordPressa. Dla większości małych i średnich sklepów najprostszym wyborem będzie gotowy integrator.
Pierwsza droga to platforma taka jak Base, dawniej BaseLinker. Łączy WooCommerce, Allegro, firmy kurierskie i systemy fakturowe w jednym panelu. Base ma oficjalną wtyczkę w katalogu WordPressa oraz osobny moduł do obsługi Allegro. Podobnie działa Apilo, mocno skupione na polskich marketplace’ach.
Druga możliwość to integracja szyta na miarę za pomocą REST API Allegro. Allegro udostępnia publiczną dokumentację dla programistów, więc można przygotować połączenie dostosowane do konkretnego procesu. Takie rozwiązanie ma sens przy nietypowym modelu cenowym, rozbudowanym magazynie, własnym systemie ERP albo dużej liczbie wyjątków, których gotowa platforma nie obsługuje.
| Sposób | Kiedy ma sens | Na co uważać |
|---|---|---|
| Integrator (Base, Apilo) | Małe i średnie sklepy, szybkie uruchomienie sprzedaży bez budowania własnego systemu | Plan integratora dopasowany do łącznej sprzedaży ze wszystkich kanałów |
| Własna integracja przez REST API Allegro | Nietypowy model cenowy, rozbudowany magazyn, własny ERP, dużo wyjątków | Prace programistyczne i późniejsze utrzymanie integracji |
| Wtyczki „Allegro + WooCommerce” | Gdy wtyczka jest aktualizowana i zgodna z aktualną wersją WooCommerce | Wiele starszych projektów porzucono; po zmianach w API mogą przestać działać |
Konfiguracja Allegro z Base krok po kroku
Połączenie sklepu z Allegro w Base obejmuje dodanie WooCommerce, autoryzację konta sprzedażowego, przygotowanie parametrów i uruchomienie synchronizacji. W innych integratorach proces wygląda podobnie, choć nazwy zakładek mogą się różnić.
Krok 1. Załóż konto w Base i połącz sklep WooCommerce
Plan Freemium w Base kosztuje 0 zł i obejmuje do 100 zamówień miesięcznie. Przy większej sprzedaży plan Business kosztuje 279 zł netto miesięcznie do 1000 zamówień.
- Po założeniu konta dodaj integrację WooCommerce w panelu Base. System poprosi o adres sklepu oraz klucze REST API.
- Wygenerujesz je w WordPressie, przechodząc do: WooCommerce → Ustawienia → Zaawansowane → REST API.
- Utwórz klucz dla użytkownika z odpowiednimi uprawnieniami, a następnie skopiuj klucz klienta i sekret do panelu Base.
- Po zapisaniu połączenia wykonaj test pobierania produktów. Sprawdź kilka pozycji, warianty, ceny i stany.
Jeśli dane zgadzają się już na tym etapie, dalsza konfiguracja pójdzie sprawniej.
Krok 2. Autoryzuj konto Allegro
Dodaj integrację Allegro w Base i rozpocznij autoryzację. Zostaniesz przekierowany na stronę Allegro, gdzie zalogujesz się na konto firmowe oraz zaakceptujesz zakres dostępu.
Autoryzacja korzysta z oficjalnego mechanizmu Allegro. Hasło wpisujesz na stronie marketplace’u, więc nie przekazujesz go integratorowi. Base otrzymuje zgodę na wykonywanie określonych operacji przez API, między innymi pobieranie ofert i obsługę zamówień.
Po powrocie do panelu upewnij się, że podłączone zostało właściwe konto. To ważne, jeśli obsługujesz kilka marek lub masz dostęp do więcej niż jednego profilu sprzedażowego.
Krok 3. Zmapuj produkty na kategorie i parametry Allegro
Każda oferta musi zostać przypisana do konkretnej kategorii Allegro. Kategoria określa zestaw wymaganych parametrów, na przykład EAN, markę, kolor, rozmiar, materiał lub stan produktu.
Base podpowiada kategorie i pozwala uzupełniać część danych hurtowo. Możesz przypisać wspólne parametry całej grupie podobnych produktów, a wartości zmienne pobierać z atrybutów WooCommerce.
Ten etap zwykle zajmuje najwięcej czasu. Jeśli w sklepie kolor zapisano raz jako „granat”, a innym razem jako „ciemny niebieski”, automatyczne mapowanie może wymagać poprawek. Podobny problem pojawia się przy wariantach bez kodów SKU albo produktach z brakującymi numerami EAN.
Zacznij od kilku reprezentatywnych produktów. Dobierz jeden prosty produkt, jeden z wariantami i jeden z kategorii wymagającej wielu parametrów. Dzięki temu szybciej wychwycisz braki przed masowym wystawieniem ofert.
Krok 4. Wystaw oferty i włącz synchronizację stanów oraz cen
Gotowe produkty możesz wystawiać pojedynczo lub całymi grupami. Przed publikacją sprawdź tytuł, kategorię, parametry, zdjęcia, opis, warunki dostawy i cenę każdej przykładowej oferty.
Po wystawieniu uruchom synchronizację magazynu. Zakup w sklepie powinien wtedy obniżyć stan na Allegro, a sprzedaż na Allegro zaktualizować dostępność w WooCommerce. Ustaw także zachowanie dla produktu, którego stan spadnie do zera: zakończenie oferty albo jej wstrzymanie do czasu uzupełnienia zapasu.
Ceny mogą być synchronizowane w proporcji 1:1. Możesz też ustawić inną cenę dla Allegro, na przykład wyższą o określony procent lub stałą kwotę. Pozwala to uwzględnić prowizję marketplace’u, współfinansowanie dostaw i pozostałe opłaty.
Krok 5. Ustaw import zamówień i zrób zamówienie testowe
Zamówienia z Allegro mogą trafiać do panelu Base, a stamtąd również do WooCommerce. Wybierz jedno miejsce, w którym zespół będzie prowadził codzienną obsługę.
Jeśli pracujesz w Base, możesz tam sprawdzać płatności, przygotowywać przesyłki, drukować etykiety i aktualizować statusy. Jeżeli dotychczasowy proces opiera się na WooCommerce, skonfiguruj przekazywanie zamówień do sklepu i sprawdź, jak są zapisywane dane kupującego, koszty dostawy oraz metody płatności. Wysyłki paczkomatowe obsłużysz też bezpośrednio w sklepie – zobacz przewodnik po integracji InPost z WooCommerce.
Przed pełnym startem wykonaj test na jednej ofercie. Przejdź całą ścieżkę: zakup, pobranie zamówienia, aktualizacja magazynu, wygenerowanie etykiety i przekazanie statusu wysyłki. Sprawdź również dokument sprzedaży oraz wiadomości wysyłane do klienta.
Synchronizacja stanów i cen – na co uważać
- Jedno źródło danych. Najbezpieczniejsza konfiguracja ma jedno źródło danych dla stanów i cen, zwykle WooCommerce. Integrator pobiera z niego zmiany i przekazuje je do Allegro według ustalonych reguł.
- Prosta zasada nadpisywania. Jeżeli pracownik poprawi stan ręcznie w WooCommerce, drugi zrobi to w Base, a trzeci zmieni liczbę sztuk na Allegro, szybko pojawią się rozbieżności. Ustal prostą zasadę: gdzie aktualizujecie magazyn, gdzie ceny i który system może nadpisywać pozostałe.
- Wyprzedaże i bufor. Podczas wyprzedaży albo nagłego wzrostu ruchu aktualizacja może nie nastąpić natychmiast. Przy ostatnich sztukach produktu zwiększa to ryzyko sprzedaży ponad dostępny zapas. Warto ustawić bufor magazynowy lub wcześniej wstrzymać najbardziej oblegane oferty.
- Warianty i usunięte oferty. Szczególnej uwagi wymagają warianty. Każdy rozmiar czy kolor powinien mieć własny identyfikator i stan. Sprawdź także oferty ręcznie usunięte na Allegro. Integrator może nadal próbować je aktualizować, jeśli powiązanie pozostało aktywne.
- Przejrzyj ustawienia faktur. Dokument powinien powstawać w jednym systemie, aby klient nie dostał dwóch faktur do tego samego zamówienia.
Ile kosztuje integracja Allegro z WooCommerce
Koszt integracji Allegro WooCommerce obejmuje prowizje marketplace’u, plan integratora oraz czas potrzebny na konfigurację produktów. Przy indywidualnym połączeniu przez API dochodzą prace programistyczne i późniejsze utrzymanie integracji.
| Pozycja | Ile | Uwagi |
|---|---|---|
| Prowizja Allegro | Od kilku do kilkunastu procent | Liczona od wartości zamówienia razem z kosztem dostawy |
| Base, plan Freemium | 0 zł | Przy maksymalnie 100 zamówieniach miesięcznie |
| Base, plan Business | 279 zł netto miesięcznie | Obejmuje do 1000 zamówień |
| Integracja przez API | Prace programistyczne i późniejsze utrzymanie | Połączenie dostosowane do konkretnego procesu |
| Czas na uporządkowanie produktów | Kilkanaście dobrze opisanych produktów: sprawnie; kilkaset pozycji z wariantami: więcej pracy | Kategorie, parametry, EAN-y, warianty i atrybuty |
Do kalkulacji dodaj czas na uporządkowanie produktów, przypisanie kategorii i uzupełnienie parametrów. Przy kilkunastu dobrze opisanych produktach prace mogą przebiec sprawnie. Kilkaset pozycji z wariantami, brakującymi EAN-ami i niespójnymi atrybutami wymaga znacznie więcej uwagi.
Własny sklep nie pobiera prowizji od każdej transakcji. Trzeba jednak samodzielnie pozyskać ruch, zadbać o reklamę, pozycjonowanie i powracających klientów. Pełne zestawienie kosztów prowadzenia sklepu znajdziesz w artykule ile kosztuje sklep internetowy.
Sklep, Allegro czy jedno i drugie
Model mieszany pozwala korzystać z zasięgu Allegro i jednocześnie rozwijać własny sklep. Integracja Allegro z WooCommerce upraszcza obsługę obu kanałów, ponieważ produkty i zamówienia korzystają ze wspólnego magazynu.
| Kryterium | Allegro | Własny sklep WooCommerce |
|---|---|---|
| Zasięg i ruch | Dostęp do dużej grupy kupujących | Ruch rośnie wolniej i wymaga działań promocyjnych |
| Koszt sprzedaży | Za każdą sprzedaż ponosisz prowizję | Sklep nie pobiera prowizji od transakcji; ruch pozyskujesz samodzielnie |
| Relacja z klientem i marka | Ograniczone możliwości budowania bezpośredniej relacji | Większa kontrola nad marką, cenami i bazą klientów |
| Rola w modelu mieszanym | Szybki dostęp do nowych zamówień | Rozwija markę i sprzedaż z pełniejszą marżą |
Jeśli dopiero planujesz własny kanał sprzedaży, zobacz poradnik jak założyć sklep internetowy.
W wielu małych firmach sprawdza się prosty podział. Allegro zapewnia szybki dostęp do nowych zamówień, a sklep rozwija markę i sprzedaż z pełniejszą marżą. Dobrze ustawiona integracja z Allegro pozwala prowadzić oba kanały w jednym procesie, bez ręcznego przepisywania zamówień i ciągłego poprawiania stanów.
FAQ
-
W katalogu WordPressa nie ma oficjalnej wtyczki Allegro synchronizującej oferty z WooCommerce. Oficjalna wtyczka „One by Allegro” obsługuje usługę dostawy, w tym przesyłki i etykiety. Do pełnej integracji zwykle wykorzystuje się platformę Base lub Apilo.
-
Tak. Plan Freemium w Base kosztuje 0 zł przy maksymalnie 100 zamówieniach miesięcznie. Nadal ponosisz prowizje Allegro oraz pozostałe koszty sprzedaży wynikające z cennika i wybranych usług.
-
Tak, po uruchomieniu synchronizacji sprzedaż w jednym kanale obniża dostępny stan w drugim. Ustal jedno źródło danych magazynowych i poprawnie powiąż produkty oraz ich warianty.
-
Tak. Integrator pobiera zamówienia z Allegro i może przekazywać je do WooCommerce. Możesz również obsługiwać całą sprzedaż w panelu integratora, jeśli tam przygotowujesz wysyłki i dokumenty.
-
Sprzedaż prowadzona w ramach działalności wymaga konta firmowego z danymi firmy. Takie konto zapewnia dostęp do narzędzi dla sprzedających i pozwala autoryzować integrację przez API Allegro.