Integracja PrestaShop z Allegro 2026 — konfiguracja krok po kroku
Sprzedaż na Allegro i we własnym sklepie PrestaShop jednocześnie to standard w polskim e-commerce. Problemem jest synchronizacja: stany magazynowe, ceny, zamówienia i opisy muszą być spójne na obu platformach. Ten poradnik prowadzi przez cały proces integracji — od wyboru modułu i autoryzacji API po synchronizację katalogową, obsługę zamówień i rozwiązywanie typowych błędów.
Allegro to największy marketplace w Polsce — odpowiada za kilkadziesiąt procent polskiego handlu internetowego. Dla sklepu na PrestaShop integracja z Allegro oznacza dostęp do gotowego ruchu i klientów, którzy nie trafiliby bezpośrednio na sklep. Problem polega na tym, że zarządzanie dwoma kanałami sprzedaży ręcznie — osobno w PrestaShop i osobno w Allegro — szybko staje się niemożliwe: rozsynchronizowane stany magazynowe, zduplikowane zamówienia, błędne ceny.
Integracja techniczna między PrestaShopem a Allegro rozwiązuje te problemy przez automatyczną synchronizację: produkt wystawiasz raz w PS, integracja wystawia go na Allegro. Zamówienie z Allegro trafia do PS. Stan magazynowy aktualizuje się w obu miejscach jednocześnie. Ten artykuł opisuje, jak to skonfigurować — od wyboru narzędzia integracyjnego po rozwiązywanie błędów.
Metody integracji PrestaShop z Allegro — porównanie opcji
Istnieją dwa główne podejścia do integracji: bezpośredni moduł PrestaShop lub zewnętrzne narzędzie pośredniczące (BaseLinker). Każde ma zalety i wady zależne od skali, liczby kanałów i wymagań biznesowych.
Opcja 1 — Bezpośredni moduł PrestaShop dla Allegro
Moduł zainstalowany bezpośrednio w PrestaShop komunikuje się z API Allegro bez pośredników.
Zalety: jedna konfiguracja, niższy koszt miesięczny (jednorazowy zakup modułu lub subskrypcja vs BaseLinker), dane przepływają bezpośrednio między PS a Allegro.
Wady: ograniczenie do integracji PS-Allegro. Jeśli dodasz kolejne kanały (Amazon, eBay, Empik), potrzebujesz osobnych modułów lub przejścia na BaseLinker.
Popularne moduły: AllegroConnector (jeden z bardziej rozbudowanych), moduły od polskich deweloperów dostępne na PrestaShop Addons i direktnie od producentów.
Koszt: 200–800 PLN jednorazowo lub subskrypcja miesięczna 30–80 PLN, zależnie od producenta i zakresu funkcji.
Opcja 2 — BaseLinker jako hub integracyjny
BaseLinker to zewnętrzna platforma pośrednicząca — łączy PrestaShop z Allegro i dziesiątkami innych kanałów (Amazon, eBay, Empik, Etsy, własne sklepy).
Zalety: jeden panel do zarządzania wszystkimi kanałami, automatyzacje zamówień, masowe zarządzanie aukcjami, zaawansowana konfiguracja synchronizacji.
Wady: miesięczna subskrypcja (od ~100 PLN/miesiąc zależnie od liczby zamówień i modułów), dodatkowa warstwa systemu — ewentualne awarie BaseLinker wpływają na synchronizację.
BaseLinker rekomendujemy przy sprzedaży na 3+ kanałach lub przy dużym wolumenie zamówień wymagającym automatyzacji (etykiety, powiadomienia, statusy).
Dla sklepu sprzedającego tylko na PS i Allegro — dedykowany moduł jest prostszym i tańszym rozwiązaniem.
Niezależnie od wybranej metody integracji, konieczna jest rejestracja aplikacji w panelu deweloperskim Allegro, żeby uzyskać dane dostępowe do REST API.
Przejdź do developer.allegro.pl i zaloguj się kontem sprzedawcy Allegro. Przejdź do sekcji 'Moje aplikacje' i kliknij 'Utwórz nową aplikację'.
Podaj nazwę aplikacji (np. 'PrestaShop - NazwaSklepu'), opis i wybierz środowisko. Na etapie testów wybierz Sandbox, docelowo — środowisko produkcyjne.
Po rejestracji Allegro wygeneruje Client ID i Client Secret. Zapisz te dane bezpiecznie — Client Secret jest widoczny tylko raz przy tworzeniu aplikacji.
Wejdź na developer.allegro.pl
Moje aplikacje → Utwórz nową aplikację
Podaj nazwę, opis, wybierz środowisko (Sandbox do testów, Produkcja docelowo)
Zapisz Client ID i Client Secret (Client Secret widoczny tylko raz)
Wklej Redirect URI podany przez moduł PS lub BaseLinker
Krok 2 — Instalacja i konfiguracja modułu PrestaShop
Krok 2Zainstaluj moduł i wprowadź dane API
Jeśli wybrałeś bezpośredni moduł PrestaShop: pobierz moduł od producenta, zaloguj się do panelu PS i przejdź do Moduły → Menedżer modułów → Prześlij moduł. Załaduj plik .zip.
Po instalacji kliknij Konfiguruj i przejdź do ustawień autoryzacji. Znajdziesz tu pola na Client ID i Client Secret z Allegro Developer. Wprowadź dane i kliknij 'Autoryzuj' lub 'Połącz z Allegro'.
Moduł przekieruje Cię do strony Allegro, gdzie musisz potwierdzić uprawnienia aplikacji do zarządzania ofertami i zamówieniami. Po potwierdzeniu nastąpi powrót do panelu PS z aktywną autoryzacją.
Allegro używa własnego drzewa kategorii, które różni się od struktury kategorii w PrestaShop. Moduł integracji musi wiedzieć, w jakiej kategorii Allegro wystawić produkty z danej kategorii PS.
W panelu konfiguracji modułu znajdziesz sekcję mapowania kategorii. Dla każdej kategorii PS (lub grupy kategorii) wybierz odpowiednią kategorię Allegro z drzewa. To krok wymagający uwagi — błędne mapowanie skutkuje wystawieniem produktów w złej kategorii, co obniża ich widoczność na Allegro.
Zwróć uwagę na atrybuty wymagane przez Allegro w danej kategorii. Allegro wymaga konkretnych parametrów (np. dla elektroniki: marka, model, EAN). Jeśli Twoje produkty w PS nie mają tych atrybutów — dodaj je przed synchronizacją.
Konfiguracja modułu → Mapowanie kategorii
Przyporządkuj każdą kategorię PS do kategorii Allegro
Sprawdź wymagane atrybuty Allegro dla każdej kategorii
Uzupełnij brakujące atrybuty produktów w PS (EAN, marka, parametry)
Przetestuj mapowanie na 2–3 produktach testowych
Krok 4 — Synchronizacja produktów z PS na Allegro
Krok 4Skonfiguruj synchronizację katalogową
Synchronizacja produktów to eksport danych produktu z PS do Allegro w formie oferty. Moduł tłumaczy dane PS (nazwa, opis, zdjęcia, cena, stany) na format oferty Allegro.
Kluczowe ustawienia synchronizacji: cennik (czy cena na Allegro = cena PS, czy z narzutem procentowym lub kwotowym), szablon dostawy (wybierasz jeden z szablonów dostawy skonfigurowanych na koncie Allegro), format oferty (aukcja, kup teraz, Allegro Lokalnie).
Jeśli sprzedajesz produkty z kombinacjami (np. koszulki w rozmiarach S/M/L/XL) — sprawdź, czy moduł obsługuje kombinacje PS jako warianty Allegro. Allegro obsługuje warianty w niektórych kategoriach, ale mechanizm mapowania może wymagać dodatkowej konfiguracji.
Pierwsze wystawienie: zaznacz kilka produktów testowych, uruchom synchronizację i sprawdź na Allegro, czy oferty wyglądają poprawnie. Nie synchronizuj całego katalogu bez weryfikacji pojedynczych produktów.
Skonfiguruj cennik (cena PS / cena PS + narzut / cena manualna)
Wybierz szablon dostawy skonfigurowany na Allegro
Wybierz format oferty (Kup Teraz rekomendowane)
Zaznacz kilka produktów testowych i uruchom synchronizację
Sprawdź oferty na Allegro po synchronizacji testowej
Krok 5 — Synchronizacja stanów magazynowych
Krok 5Włącz dwukierunkową synchronizację stanów
Synchronizacja stanów to krytyczna funkcja integracji. Jeśli klient kupi ostatnią sztukę produktu w sklepie PS, oferta na Allegro musi zostać automatycznie zaktualizowana (stan 0 = oferta zatrzymana lub dostępność 0). Analogicznie — sprzedaż na Allegro musi zmniejszyć stan w PS.
Większość modułów oferuje dwukierunkową synchronizację stanów. Sprawdź, jak szybko moduł aktualizuje stany — zbyt rzadka synchronizacja (np. co 6 godzin) może prowadzić do sprzedaży towaru, którego nie ma w magazynie.
Przy dużym wolumenie sprzedaży (kilkaset zamówień dziennie z obu kanałów) synchronizacja stanów musi działać w czasie niemal rzeczywistym (co kilka minut) lub przez webhook API, żeby uniknąć oversellingu.
Sprawdź częstotliwość synchronizacji — co ile minut/godzin
Przetestuj: zmień stan produktu testowego w PS → sprawdź Allegro
Przetestuj: złóż zamówienie testowe na Allegro → sprawdź stan w PS
Krok 6 — Importowanie zamówień z Allegro do PrestaShop
Krok 6Skonfiguruj import zamówień
Zamówienia złożone przez klientów na Allegro powinny trafiać do PrestaShop jako normalne zamówienia — z danymi klienta, produktami, adresem dostawy i statusem płatności. Pozwala to zarządzać całą sprzedażą z jednego miejsca.
W konfiguracji modułu znajdziesz ustawienia mapowania statusów zamówień Allegro na statusy zamówień PS. Allegro ma własne statusy (BOUGHT, READY_FOR_PROCESSING, SENT, CANCELLED) — musisz je zmapować na odpowiedniki w PS.
Sprawdź, czy moduł tworzy lub dopasowuje konta klientów. Klient, który kupił przez Allegro, może nie chcieć zakładać konta w PS — ale jego dane (imię, nazwisko, adres) powinny trafić do zamówienia.
Ustal zasadę dla produktów: czy importowane zamówienia Allegro zmniejszają stany w PS (konieczne jeśli magazyn nie jest aktualizowany przez synchronizację stanów) i czy jest to dwukrotne odliczenie przy jednoczesnej aktywnej synchronizacji.
Konfiguracja → Zamówienia Allegro → włącz import
Zmapuj statusy Allegro na statusy PS
Sprawdź tworzenie/dopasowywanie klientów
Ustal czy import zamówień aktualizuje stany (unikaj podwójnego odliczenia)
Przetestuj: złóż zamówienie testowe na Allegro Sandbox → sprawdź PS
Krok 7 — Synchronizacja cen
Krok 7Skonfiguruj zasady cenowe dla Allegro
Ceny na Allegro mogą różnić się od cen w sklepie PS. Typowe scenariusze: wyższa cena na Allegro (wliczona prowizja Allegro), identyczna cena, lub niższa cena na Allegro przy akcjach marketplace.
Większość modułów pozwala skonfigurować globalny narzut lub rabat procentowy/kwotowy aplikowany do cen PS przy tworzeniu oferty Allegro. Można też ustawić indywidualne ceny Allegro dla wybranych produktów.
Pamiętaj o Dyrektywie Omnibus w kontekście Allegro — jeśli wystawiasz produkt po cenie niższej niż regularna cena PS, Allegro wyświetli historię cen zgodnie z wymogami. Upewnij się, że ceny w Allegro są spójne z polityką cenową sklepu.
Przy wdrożeniu dynamicznego cenowania (repricing) na Allegro — sprawdź, czy moduł lub BaseLinker obsługuje reguły repricingowe reagujące na konkurencję.
Skonfiguruj globalny narzut na ceny Allegro (opcjonalnie)
Sprawdź możliwość indywidualnych cen Allegro per produkt
Przetestuj wyświetlanie ceny na wystawionej ofercie testowej
Sprawdź zgodność z Omnibus (historia cen) dla produktów przecenionych
Typowe błędy i jak je rozwiązać
Integracja PS-Allegro to jeden z bardziej złożonych procesów konfiguracyjnych w e-commerce. Poniżej najczęstsze błędy i sposoby ich rozwiązania.
Błąd autoryzacji OAuth (401 Unauthorized)
Przyczyna: token dostępu wygasł (Allegro OAuth tokeny mają ograniczony czas życia) lub Client Secret jest błędny.
Rozwiązanie: w panelu modułu kliknij 'Odnów autoryzację' lub 'Ponownie autoryzuj'. Jeśli błąd się powtarza — sprawdź Client ID i Client Secret w panelu Allegro Developer. Upewnij się, że Redirect URI w aplikacji Allegro zgadza się z URI podanym przez moduł.
Oferta odrzucona przez Allegro (walidacja)
Przyczyna: brakujące wymagane atrybuty dla kategorii Allegro, za krótki opis, brak zdjęć o minimalnej rozdzielczości lub niezgodna kategoria.
Rozwiązanie: sprawdź komunikat błędu API — zawiera szczegółowe informacje o przyczynie odrzucenia. Najczęściej: uzupełnij brakujące atrybuty (EAN, marka, parametry techniczne) w edycji produktu PS lub w mapowaniu atrybutów modułu.
Stany magazynowe nie synchronizują się
Przyczyna: synchronizacja CRON nie działa (brak poprawnie skonfigurowanego CRON job na serwerze), problem z uprawnieniami lub błąd w API.
Rozwiązanie: sprawdź konfigurację CRON na hostingu (cPanel → Zadania CRON lub SSH: crontab -l). Uruchom synchronizację ręcznie z panelu modułu i sprawdź logi błędów. Zweryfikuj czy serwer ma dostęp do Internetu i API Allegro (niektóre hostingi blokują wychodzące połączenia HTTP).
Duplikaty zamówień — zamówienie liczone dwa razy
Przyczyna: moduł importuje zamówienie Allegro do PS, a jednocześnie synchronizacja stanów odlicza ten sam towar dwukrotnie.
Rozwiązanie: wyłącz automatyczne odliczanie stanów przy imporcie zamówień jeśli synchronizacja stanów jest aktywna. Sprawdź dokumentację modułu w zakresie które mechanizmy powinny być aktywne jednocześnie.
Oferta wystawiona w złej kategorii Allegro
Przyczyna: błędne mapowanie kategorii PS → Allegro lub automatyczne mapowanie przez nazwę kategorii, które nie trafiło w właściwą.
Rozwiązanie: ręcznie przejdź przez mapowanie kategorii w panelu modułu i zweryfikuj każde przyporządkowanie. Allegro oferuje narzędzie sugestii kategorii przez API — sprawdź czy moduł z niego korzysta.
Integracja przez BaseLinker — różnice w konfiguracji
Jeśli wybierasz BaseLinker zamiast bezpośredniego modułu, proces konfiguracji różni się na kilku etapach.
Zainstaluj moduł BaseLinker w PrestaShop (dostępny na Addons Marketplace lub stronie BaseLinker) — służy do połączenia PS z platformą BaseLinker.
Zaloguj się do panelu BaseLinker i dodaj integrację PrestaShop (Ustawienia → Integracje → PrestaShop → podaj URL sklepu i klucz API modułu).
Dodaj integrację Allegro w BaseLinker (Ustawienia → Integracje → Allegro → autoryzuj przez OAuth). BaseLinker obsługuje autoryzację samodzielnie.
Konfiguruj reguły automatyzacji zamówień: BaseLinker oferuje rozbudowany system warunków i akcji (np. 'jeśli zamówienie z Allegro i status PAID → prześlij do PS i wyślij e-mail potwierdzający').
Synchronizacja stanów i produktów w BaseLinker jest konfigurowana przez zakładkę 'Magazyn' — możliwa dwukierunkowa synchronizacja między PS a Allegro przez platformę BaseLinker.
Jeśli Twój sklep jest na PrestaShop 1.7 i planujesz integrację z Allegro — najpierw rozważ aktualizację do PrestaShop 8 lub 9, opisaną w artykule aktualizacja PrestaShop 1.7 do 9. Pełną ofertę modułów integracyjnych dla PrestaShop znajdziesz w sekcji moduły i integracje PrestaShop. Jeśli rozważasz migrację sklepu — sprawdź też migrację PrestaShop.
Koszty prowizji Allegro — co warto wiedzieć przed integracją
Allegro pobiera prowizję od każdej transakcji — jej wysokość zależy od kategorii produktu i wynosi od kilku do kilkunastu procent. Przed uruchomieniem integracji przelicz marżę uwzględniając prowizję Allegro. Cena na Allegro powinna pokrywać prowizję marketplace, koszty wysyłki (jeśli bezpłatna dla klienta) i zachować planowaną marżę.
Sprawdź aktualną prowizję Allegro dla swoich kategorii produktów (allegro.pl/informacje/prowizje).
Skonfiguruj narzut cenowy w module integracji, żeby cena Allegro automatycznie uwzględniała prowizję.
Monitoruj Program Allegro Smart! — produkty objęte programem z bezpłatną dostawą mogą wymagać dostosowania progów cenowych.
Rozważ różnicowanie oferty: produkty z wyższą marżą na Allegro, produkty unikalne lub z niższą marżą — tylko we własnym sklepie.
Allegro a SEO sklepu PrestaShop
Sprzedaż na Allegro i we własnym sklepie to dwa różne kanały SEO. Allegro ma własne algorytmy rankingowe i indeksację przez Google. Treści produktowe powielane między PS a Allegro (identyczne opisy, tytuły) mogą być traktowane jako duplikacja przez Google — choć w praktyce Allegro i własny sklep są oceniane jako oddzielne domeny.
Opisy produktów w PS i na Allegro warto różnicować — nie tylko dla SEO, ale też dlatego, że Allegro ma własne wymagania dotyczące formatu oferty.
Własny sklep PS ma pełniejsze możliwości SEO (meta tagi, schema.org, content marketing) — to długoterminowo cenne.
Allegro generuje szybki ruch z istniejącej bazy klientów — traktuj go jako kanał do pozyskiwania klientów, którzy potem mogą wrócić bezpośrednio do sklepu.
Nie przerywaj działań SEO dla własnego sklepu na rzecz Allegro — dywersyfikacja kanałów sprzedaży zmniejsza ryzyko zależności od jednej platformy.
Checklist przed uruchomieniem integracji produkcyjnie
Autoryzacja OAuth działa — status 'Połączono' w panelu modułu.
Mapowanie kategorii PS → Allegro zweryfikowane dla wszystkich kategorii.
Wymagane atrybuty Allegro uzupełnione w produktach PS.
Testowa synchronizacja produktów zakończona bez błędów.
Oferty testowe wyglądają poprawnie na Allegro (zdjęcia, opis, cena, dostawa).
Synchronizacja stanów przetestowana w obu kierunkach.
Import zamówień z Allegro do PS przetestowany (zamówienie Sandbox).
Mapowanie statusów zamówień skonfigurowane.
CRON synchronizacji aktywny i działający na serwerze.
Cennik na Allegro uwzględnia prowizję marketplace.
Backup sklepu zrobiony przed uruchomieniem produkcyjnym.
prestashop integracja z allegro
prestashop allegro
moduł allegro prestashop
synchronizacja allegro prestashop
allegro api prestashop
sprzedaż wielokanałowa
FAQ
Najczęściej zadawane pytania
Integracja PrestaShop z Allegro wymaga: rejestracji aplikacji w panelu Allegro Developer (developer.allegro.pl), uzyskania Client ID i Client Secret, zainstalowania modułu integracyjnego w PS lub skonfigurowania BaseLinker, autoryzacji przez OAuth i konfiguracji synchronizacji produktów, stanów i zamówień.
Dla sprzedaży tylko na PS i Allegro — dedykowany moduł jest prostszy i tańszy. Dla sprzedaży wielokanałowej (Allegro + Amazon + eBay + inne) lub przy dużym wolumenie zamówień wymagającym automatyzacji — BaseLinker jest lepszym wyborem dzięki jednemu paneloprzez zarządzania wszystkimi kanałami.
Moduł integracji lub BaseLinker oferują dwukierunkową synchronizację stanów: sprzedaż w PS aktualizuje stan oferty na Allegro, a sprzedaż na Allegro zmniejsza stan w PS. Synchronizacja odbywa się przez CRON (co kilka do kilkunastu minut) lub przez webhook API (niemal w czasie rzeczywistym). Regularność synchronizacji jest kluczowa dla unikania oversellingu.
Konfiguracja podstawowej integracji (autoryzacja, synchronizacja produktów, stany) jest dostępna dla osób z podstawową wiedzą techniczną o PrestaShop. Trudniejsze etapy to: mapowanie atrybutów wymaganych przez Allegro, konfiguracja synchronizacji kombinacji (wariantów) i debugowanie błędów API. Pełna, przetestowana integracja dla sklepu ze złożonym katalogiem wymaga kilku–kilkunastu godzin konfiguracji.
Koszt bezpośredniego modułu: 200–800 PLN jednorazowo lub 30–80 PLN/miesiąc w subskrypcji. BaseLinker: od ~100 PLN/miesiąc (zależy od liczby zamówień i aktywnych modułów). Do tego dochodzi czas konfiguracji i testowania — przy zleceniu integracji agencji: 400–1500 PLN za konfigurację, zależnie od złożoności katalogu.
Tak, Allegro działa niezależnie od sklepu. Integracja z PS ma sens, jeśli już masz sklep PrestaShop i chcesz zsynchronizować katalog, stany i zamówienia zamiast zarządzać nimi ręcznie w dwóch miejscach. Dla osób bez własnego sklepu Allegro oferuje własny panel zarządzania ofertą.
OAuth 2.0 to standard autoryzacji używany przez Allegro REST API. Zamiast podawania hasła do konta Allegro, aplikacja integracyjna (moduł PS lub BaseLinker) uzyskuje token dostępu przez bezpieczny przepływ OAuth. Wymaga to jednorazowej rejestracji aplikacji w panelu Allegro Developer i uzyskania Client ID / Client Secret.
PrestaShop obsługuje warianty jako kombinacje (np. rozmiar S/M/L × kolor czerwony/niebieski). Allegro obsługuje warianty w wybranych kategoriach. Moduł integracji musi umieć zmapować kombinacje PS na warianty Allegro. Sprawdź dokumentację wybranego modułu — nie wszystkie obsługują to automatycznie, część wymaga ręcznej konfiguracji per produkt.
Część modułów obsługuje jeszcze PrestaShop 1.7, ale trend jest jasny: producenci modułów koncentrują się na PS 8 i 9. Jeśli masz PS 1.7, możesz mieć trudności z znalezieniem aktywnie wspieranego modułu Allegro. To jeden z dodatkowych argumentów za aktualizacją do PrestaShop 8 lub 9 przed wdrożeniem nowych integracji.
Kluczowe jest skonfigurowanie synchronizacji stanów w czasie niemal rzeczywistym (przez webhook lub CRON co 2–5 minut). Przy dużym wolumenie rozważ utrzymywanie buforu magazynowego (np. wystawiaj na Allegro stan o 5 sztuk mniejszy niż faktyczny) lub przełącz na model fulfillment, gdzie każde zamówienie rezerwuje towar przed potwierdzeniem.
Bezpłatna konsultacja
Porozmawiajmy o Twoim projekcie
Opisz, czego potrzebujesz — zaproponujemy zakres, technologię i realny harmonogram. Bez zobowiązań.
24–48 hCzas odpowiedzi
100%Wycena indywidualna
0 złBez zobowiązań
kontakt
Masz projekt lub pytanie? Napisz do nas
Opisz, czego potrzebujesz — strony, sklepu, integracji czy wsparcia technicznego. Odpowiemy z konkretnymi propozycjami i orientacyjną wyceną, zwykle w ciągu jednego dnia roboczego.
