# Jak połączyć PrestaShop z Allegro? Zakres, konfiguracja i testy

> Moduł integracyjny nie musi importować produktów z Allegro do sklepu. Pokazujemy pięć osobnych przepływów, wybór narzędzia, autoryzację OAuth, właścicieli danych i demonstracyjną próbę ponowienia po awarii.

Autor: WebAlpha (WebAlpha). Opublikowano: 2026-06-08. Zaktualizowano: 2026-09-03. Kanoniczny adres: https://webalpha.pl/blog/integracja-prestashop-allegro

Około 11 min czytania (szacunek; bez czasu wykonania instrukcji).

Aby połączyć PrestaShop z Allegro, najpierw ustal, co ma przepływać między systemami. Import produktów do sklepu, powiązanie istniejących ofert, aktualizacja stanów, pobieranie zamówień i nadawanie przesyłek to różne zadania. Hasło „pełna integracja” nie potwierdza żadnego z nich bez opisu kierunku danych i testu.

Ten poradnik pomaga przygotować konfigurację oraz odbiór. Nazwy ekranów i możliwości opisuje dokumentacja konkretnego produktu i jego wersji. Uzgodniona mapa przepływów pozwala sprawdzić, czy ustawienia panelu pokrywają cały wymagany proces.

Zakres wykonania i wycenę znajdziesz na stronie [integracji Allegro z PrestaShop](https://webalpha.pl/sklep/integracja-allegro-prestashop). Poniżej wyjaśniamy, jak rozpoznać potrzebny zakres i sprawdzić jego działanie.

<a id="sekcja-piec-przeplywow-co-dokladnie-ma-robic-integracja"></a>

## Pięć przepływów: co dokładnie ma robić integracja?

**Lista kontrolna do rozmowy z dostawcą modułu lub wykonawcą. Każdy wiersz wymaga osobnego potwierdzenia.**

| Przepływ | Co ustalasz | Czego nie wolno zakładać |
| --- | --- | --- |
| 1. Import katalogu do PrestaShop | Czy z ofert lub innego źródła powstaną produkty, kombinacje, zdjęcia i kategorie w sklepie? | Możliwość wystawiania ofert nie potwierdza importu katalogu w przeciwną stronę. |
| 2. Powiązanie istniejących ofert | Jak oferta Allegro zostanie przypisana do istniejącego produktu lub wariantu PS? | Podobna nazwa albo ten sam EAN nie zawsze daje jednoznaczne dopasowanie. |
| 3. Synchronizacja oferty | Który system zapisuje stan, cenę, treść i dostępność? W jakim kierunku i po jakim zdarzeniu? | Włączenie synchronizacji nie oznacza natychmiastowego ani dwukierunkowego zapisu wszystkich pól. |
| 4. Zamówienia i rozliczenie skutków | Kiedy utworzyć zamówienie, rezerwację, dokument i aktualizację stanu? | Każde ponownie odebrane zdarzenie nie może tworzyć nowego zamówienia. |
| 5. Wysyłam z Allegro | Kto wybiera usługę, tworzy przesyłkę, pobiera etykietę i zapisuje numer nadania? | Pobranie adresu dostawy nie oznacza wdrożenia procesu nadawania. |

Przykład praktyczny: masz aktywne oferty na Allegro, ale pusty sklep PrestaShop. Potrzebujesz importu katalogu, porządkowania danych oraz późniejszego połączenia produktów z ofertami. Jeśli sklep ma już produkty, drugi import może stworzyć duplikaty — wówczas pierwszym zadaniem jest mapowanie. To dwie różne wyceny i dwa różne zestawy testów.

Nie jest to wyłącznie teoretyczna różnica: producent [modułu Allegro x13](https://x13.pl/integracje-prestashop/integracja-allegro-z-prestashop.html) w opisie odczytanym 3 września 2026 r. oddziela integrację od importu produktów z Allegro do PrestaShop. Sprawdź dokumentację kupowanej wersji zamiast przenosić zakres jednego dodatku na wszystkie integratory.

<a id="sekcja-modul-bezposredni-hub-czy-wlasna-integracja"></a>

## Moduł bezpośredni, hub czy własna integracja?

**Porównuj rozwiązania na tym samym briefie. To kryteria wyboru, nie ranking producentów.**

| Podejście | Kiedy warto sprawdzić | Pytanie rozstrzygające |
| --- | --- | --- |
| Moduł w PrestaShop | Sklep jest centrum obsługi, a potrzebne przepływy mieszczą się w jego funkcjach. | Czy wybrana wersja obsługuje mój checkout, warianty, istniejące oferty oraz wymagany proces wysyłki? |
| Hub integracyjny | Kilka kanałów ma korzystać ze wspólnej obsługi zamówień i reguł. | Czy hub ma być właścicielem danych, czy tylko przekazywać je z ERP? Jak wyeksportuję mapowania i logi? |
| Własna integracja | Gotowe rozwiązania nie pokrywają udokumentowanej potrzeby biznesowej. | Kto utrzyma autoryzację, zmiany API, błędy, monitoring i obsługę ponowień po starcie? |

Poproś o potwierdzenie zgodności z dokładną wersją PrestaShop i PHP, licencję, zakres aktualizacji i sposób obsługi awarii. Cena licencji nie jest kosztem całego procesu. Porównaj konfigurację, porządkowanie katalogu, testy, abonament, utrzymanie oraz ewentualne opłaty za dodatkowe funkcje. Nie traktuj niepodanej ceny jako zera.

<a id="sekcja-autoryzacja-allegro-uzytkownik-integratora-to-nie-autor-aplikacji"></a>

## Autoryzacja Allegro: użytkownik integratora to nie autor aplikacji

W gotowym module lub hubie sprzedawca powinien autoryzować dostęp w przepływie OAuth dostawcy. Aktualna dokumentacja Allegro wskazuje, że aplikacje nie mogą żądać od użytkowników ich Client_ID i Client_Secret; powinny posługiwać się własnymi danymi aplikacji. Nie wklejaj sekretów do przypadkowego formularza na podstawie starego poradnika.

Rejestracja aplikacji dotyczy jej autora, np. przy tworzeniu własnego połączenia. Wtedy należy wdrożyć odpowiedni przepływ autoryzacji, zakresy uprawnień i obsługę tokenów zgodnie z dokumentacją. Sam przepływ client_credentials nie daje dostępu do prywatnych zamówień sprzedawcy.

Źródło: [uwierzytelnianie i autoryzacja w Allegro REST API](https://developer.allegro.pl/tutorials/uwierzytelnianie-i-autoryzacja-zlq9e75GdIR), stan sprawdzony 3 września 2026 r.

- Przed zgodą zweryfikuj nazwę aplikacji, właściwe konto sprzedawcy i zakres żądanych uprawnień. Zapisz osobę odpowiedzialną za dostęp.
- Nie zapisuj sekretów ani pełnych tokenów w zgłoszeniach, publicznym repozytorium czy logach dostępnych dla klienta. Materiały diagnostyczne powinny być zanonimizowane.
- Oddziel autoryzację testową od produkcyjnej. W odbiorze uwzględnij utratę uprawnień, odświeżenie dostępu i alert do osoby, która może ponownie udzielić zgody.

<a id="sekcja-produkty-i-istniejace-oferty-najpierw-mapa-identyfikatorow"></a>

## Produkty i istniejące oferty: najpierw mapa identyfikatorów

Zbuduj tabelę połączeń: identyfikator oferty Allegro → identyfikator produktu PS → identyfikator kombinacji → identyfikator w systemie nadrzędnym. SKU i EAN mogą pomagać w dopasowaniu, lecz trzeba sprawdzić ich kompletność i jednoznaczność. Brakujący lub powielony kod powinien trafić do kolejki wyjaśnień, nie do automatycznej publikacji.

- Dla importu katalogu wybierz próbkę obejmującą prosty produkt, wariant, brak kodu, obraz i produkt już obecny w sklepie. Ustal, które pola wolno tworzyć, a których nie wolno nadpisywać.
- Dla istniejącej oferty potwierdź powiązanie i wynik na próbce przed włączeniem masowej synchronizacji. Sprawdź także nieaktywne oferty oraz sytuację, gdy jeden produkt występuje w kilku ofertach.
- Rozdziel treść sklepu od treści marketplace. Import nie powinien bez uzgodnienia nadpisywać ręcznie opracowanych opisów, title, zdjęć i adresów produktów.

<a id="sekcja-wlasciciel-kazdego-pola-jak-uniknac-zapisu-w-petli"></a>

## Właściciel każdego pola: jak uniknąć zapisu w pętli

Właściciel danych to system, który rozstrzyga wartość danego pola. Integrator może ją przekazywać, ale nie powinien jednocześnie konkurować o zapis z innym modułem. Uzgodnij regułę osobno dla stanów, rezerwacji, cen, opisów i realizacji. Poniższy wariant jest autorską demonstracją architektury, nie uniwersalną konfiguracją każdego sklepu.

**DEMO: ERP jest nadrzędny dla magazynu, PrestaShop dla treści sklepu, integrator obsługuje wymianę. Żaden test klienta nie jest tu deklarowany.**

| Pole | Właściciel w przykładzie | Dozwolony przepływ i kontrola |
| --- | --- | --- |
| Dostępny stan produktu/wariantu | ERP po uwzględnieniu uzgodnionych rezerwacji | ERP → integrator → kanały. Odczyt wartości z Allegro nie nadpisuje nadrzędnego stanu. |
| Rezerwacja zamówienia | ERP, po rozpoznaniu jednoznacznego zamówienia | Integrator przekazuje zlecenie tylko raz; ponowienie rozpoznaje zapisany identyfikator. |
| Cena oferty Allegro | Reguła cenowa dla kanału zatwierdzona przez właściciela | Integrator wylicza z uzgodnionych danych; ręczna zmiana wymaga jawnego wyjątku. |
| Opis produktu w sklepie | PrestaShop / redakcja | Brak automatycznego nadpisania z Allegro. Zmiana wymaga osobnego zlecenia. |
| Powiązanie oferty z kombinacją | Rejestr mapowań integratora | Zmiany rejestrowane z poprzednią wartością; nieznany wariant blokuje zapis. |
| Stan pakowania i numer przesyłki | Uzgodniony system obsługi zamówień | Jeden wykonawca operacji; drugi system odczytuje wynik zamiast tworzyć kolejną przesyłkę. |

Taka mapa zapobiega nieporozumieniu „włączmy synchronizację w obie strony”. Dla konkretnego wdrożenia dopisz, co dzieje się przy braku stanu, opóźnieniu, ręcznej korekcie, anulowaniu i zwrocie. Nie wyłączaj globalnie zmniejszania magazynu jako pierwszej reakcji na duplikat — najpierw ustal, który system wykonał ruch i dlaczego.

<a id="sekcja-zamowienia-zdarzenie-platnosc-i-realizacja-to-rozne-rzeczy"></a>

## Zamówienia: zdarzenie, płatność i realizacja to różne rzeczy

W dzienniku Allegro /order/events BOUGHT oraz READY_FOR_PROCESSING są typami zdarzeń, a nie nazwami statusów zamówienia w PrestaShop. BOUGHT nie potwierdza opłacenia. READY_FOR_PROCESSING może obejmować również pobranie lub odpowiedni odbiór osobisty, więc nie należy utożsamiać go automatycznie z wpłatą.

Stan płatności, status zamówienia i fulfillment.status opisują różne aspekty. Mapowanie do PrestaShop musi uwzględniać metodę płatności i ustalony proces realizacji. Zdarzenia mogą się powtarzać lub docierać w innej kolejności; to samo checkoutForm.id nie powinno tworzyć kolejnego zamówienia przy każdym odbiorze.

Podstawę tych rozróżnień i obsługi powtórzeń opisuje [oficjalny poradnik obsługi zamówień Allegro](https://developer.allegro.pl/tutorials/jak-obslugiwac-zamowienia-GRaj0qyvwtR). Sprawdź mapowanie w dokumentacji konkretnego integratora, nie tylko podobieństwo nazw statusów.

Przed uruchomieniem przygotuj listę: jakie zdarzenie rozpoczyna import, kiedy powstaje rezerwacja, co zatwierdza płatność, kto tworzy dokument i kto decyduje o wysyłce. Stan po anulowaniu lub zwrocie zależy od etapu obsługi; nie przywracaj ilości bez sprawdzenia, czy towar został wysłany i czy inny system już wykonał korektę.

<a id="sekcja-wysylam-z-allegro-etykieta-to-osobny-proces-odbioru"></a>

## Wysyłam z Allegro: etykieta to osobny proces odbioru

Dla Wysyłam z Allegro sprawdź obsługę wyboru usługi, utworzenia przesyłki, pobrania etykiety oraz ewentualnego zamówienia podjazdu. Przetestuj właściwą metodę dostawy i dane odbiorcy. Numer listu przewozowego w zamówieniu nie jest sam w sobie dowodem poprawnego utworzenia i obsługi przesyłki.

Istotne dla utrzymania na przełomie 2026/2027: dokumentacja Allegro zapowiada wyłączenie GET /shipment-management/delivery-services w I kwartale 2027 r. i opisuje pobieranie propozycji dostawy przez /shipment-management/delivery-proposals/{orderId}. Zapytaj dostawcę, jakiej ścieżki używa Twoja wersja integracji; nie traktuj endpointu jako już wyłączonego we wrześniu 2026 r.

Źródło i aktualizacje: [zarządzanie przesyłkami przez Wysyłam z Allegro](https://developer.allegro.pl/tutorials/jak-zarzadzac-przesylkami-przez-wysylam-z-allegro-LRVjK7K21sY).

<a id="sekcja-wypelniona-proba-po-awarii-zamowienie-nie-moze-wykonac-sie-dwa-razy"></a>

## Wypełniona próba po awarii: zamówienie nie może wykonać się dwa razy

Poniżej znajduje się demonstracyjny scenariusz odbioru, nie raport z wykonanych testów ani opis klienta. Syntetyczny produkt DEMO-M ma 5 sztuk dostępnych. W tym przykładzie ERP jest jedynym właścicielem rezerwacji, a jedno zamówienie DEMO-01 rezerwuje 1 sztukę. Założenia trzeba zastąpić własnymi regułami przed rzeczywistą próbą.

**DEMO: oczekiwane zachowanie po przerwaniu połączenia. Wiersze opisują specyfikację testu, nie potwierdzony wynik.**

| Krok | Zdarzenie w próbie | Oczekiwany stan |
| --- | --- | --- |
| 1. Początek | Brak DEMO-01; dostępny stan 5 szt. | 0 zamówień DEMO-01, 0 rezerwacji. |
| 2. Pierwsze przetworzenie | Zapis DEMO-01 i potwierdzona rezerwacja 1 szt. w ERP. | 1 zamówienie, 1 rezerwacja, dostępny stan 4 szt. |
| 3. Awaria | Po zapisie połączenie zostaje przerwane przed potwierdzeniem odbioru. | Wynik operacji jest niepewny dla nadawcy; nie zakładamy, że zapis się nie odbył. |
| 4. Ponowienie | Odbiorca dostaje ten sam identyfikator zlecenia. | Odnajduje zapis; nadal 1 zamówienie i 1 rezerwacja, stan 4, nie 3. |
| 5. Wznowienie | Kolejka kontynuuje pracę od uzgodnionego punktu i porównuje dane. | Log wyjaśnia pominięte powtórzenie; wartości kanałów uzgodnione ze źródłem nadrzędnym. |
| 6. Odbiór | Porównanie systemów po zakończeniu próby. | W protokole identyfikatory testowe, czasy, liczby i PASS/FAIL; bez tokenów i danych klienta. |

Przetestuj również niepewny wynik nadania przesyłki: po przerwaniu połączenia sprawdź wynik istniejącej operacji zgodnie z możliwościami API, zanim utworzysz kolejną. Mechanizm rozpoznawania ponowień dla zamówień nie oznacza automatycznie, że identycznie działa on dla etykiet, płatności lub każdego innego zapisu.

<a id="sekcja-plan-uruchomienia-probka-ograniczony-zakres-pelne-wlaczenie"></a>

## Plan uruchomienia: próbka, ograniczony zakres, pełne włączenie

- Przed startem zapisz istniejące mapowania, konfigurację i punkt rozpoczęcia importu zamówień. Ustal, czy starsze zamówienia mają być pomijane, pobrane wyłącznie do podglądu czy obsługiwane.
- Na próbce obejmij produkt prosty, wariant, brak mapowania, zmianę ceny, stan zero, ponowione zamówienie, płatność i wysyłkę. Wykonuj operacje testowe w uzgodnionym środowisku.
- Włącz uzgodnione przepływy dla ograniczonego zakresu i porównaj wynik. Dopiero po odbiorze rozszerz synchronizację; nie rozpoczynaj od masowego nadpisania całego katalogu.
- Wyznacz warunki zatrzymania zapisów: nieznane mapowanie, rozbieżne stany, duplikat skutku finansowego lub brak możliwości uzgodnienia zamówień. Ustal osobę, która podejmuje decyzję.
- Powrót do poprzedniej konfiguracji nie cofa automatycznie zmian wykonanych w Allegro lub ERP. Zapisz sposób uzgodnienia takich skutków i zachowaj log zmian.

<a id="sekcja-co-monitorowac-po-uruchomieniu"></a>

## Co monitorować po uruchomieniu?

Raport techniczny powinien pokazywać opóźnienie kolejki, ostatni poprawny przebieg, liczbę błędów, nierozpoznane mapowania oraz rozbieżności stanów i zamówień. Każdy alert musi mieć właściciela. Harmonogram sprawdzeń i dopuszczalne opóźnienie uzgodnij z procesem sprzedaży; sam zielony status zadania nie potwierdza poprawnych danych.

Efekt biznesowy mierz osobno: czas obsługi, anulowania z powodu braku towaru, koszty narzędzi, rozliczone opłaty i marżę zamówień danego kanału. Techniczna integracja nie gwarantuje nowych klientów, określonej marży ani wzrostu widoczności sklepu w Google.

Jeżeli równolegle modernizujesz silnik, wykorzystaj [plan aktualizacji PrestaShop 1.7 do 8/9](https://webalpha.pl/blog/aktualizacja-prestashop-1-7-do-9). Zasady prezentowania obniżek wymagają osobnej oceny — zobacz [poradnik Omnibus w PrestaShop](https://webalpha.pl/blog/omnibus-prestashop). Nie utożsamiaj synchronizacji ceny z automatyczną zgodnością prawną.

<a id="sekcja-brief-do-wyceny-integracji"></a>

## Brief do wyceny integracji

Wyślij wersje sklepu i dodatków, nazwę obecnego huba lub ERP, informację o istniejących ofertach i produktach, liczbę kont oraz listę pięciu przepływów, które mają działać. Dodaj przykłady problematycznych wariantów i opis właściciela stanów. Wskaż wymagany proces nadania, zakres monitoringu i osobę odpowiedzialną za odbiór.

Taki brief pozwala rozdzielić konfigurację od importu i prac niestandardowych. Przejdź do [zakresu integracji Allegro z PrestaShop](https://webalpha.pl/sklep/integracja-allegro-prestashop) bez przesyłania haseł ani sekretów przez formularz.

## Masz oferty na Allegro i chcesz połączyć je ze sklepem?

Podaj wersję PrestaShop, używany integrator lub ERP, liczbę ofert oraz informację, czy produkty już istnieją w sklepie. Ustalimy potrzebne przepływy i zakres testów. Nie przesyłaj haseł, tokenów ani sekretów aplikacji w formularzu.

[Integracja Allegro z PrestaShop — zakres i wycena](https://webalpha.pl/sklep/integracja-allegro-prestashop)

## Najczęstsze pytania (FAQ)

### Czy moduł Allegro przeniesie produkty do pustego sklepu PrestaShop?

Nie każdy. Import katalogu do sklepu jest inną funkcją niż wystawianie i synchronizacja ofert. Przed zakupem trzeba potwierdzić kierunek danych, warianty, zdjęcia, kategorie i sposób rozpoznania produktów już istniejących.

### Czy muszę założyć własną aplikację Allegro, korzystając z gotowego integratora?

Zwykle autoryzujesz gotową aplikację dostawcy w OAuth. Rejestracja dotyczy autora aplikacji, np. przy własnej integracji. Aktualna dokumentacja Allegro wskazuje, że aplikacje nie mogą żądać od użytkowników ich Client_ID i Client_Secret.

### Czy stany magazynowe powinny synchronizować się w obie strony?

Nie należy tego włączać bez mapy odpowiedzialności. Trzeba wybrać źródło nadrzędne dla stanu i rezerwacji oraz ustalić reguły dla pozostałych systemów. Dwa niezależne procesy zapisu mogą nadpisywać wyniki lub podwójnie rozliczać ten sam zakup.

### Czy READY_FOR_PROCESSING zawsze oznacza opłacone zamówienie?

Nie. To typ zdarzenia Allegro, który może dotyczyć także pobrania lub odpowiedniego odbioru osobistego. Mapowanie powinno uwzględniać dane płatności, sposób realizacji i reguły sklepu.

### Czy obsługa zamówień obejmuje Wysyłam z Allegro?

Nie wynika to automatycznie z pobierania zamówień. Osobno trzeba potwierdzić usługę dostawy, tworzenie przesyłki, etykietę, numer nadania i zachowanie przy niepewnym wyniku lub powtórzeniu operacji.

### Jak sprawdzić, czy integracja nie dubluje zamówień?

Na danych testowych przerwij połączenie po zapisie i odtwórz ponowienie tego samego zlecenia. Porównaj identyfikatory, liczbę zamówień, rezerwacje i stan źródła nadrzędnego. Odbiór wymaga rzeczywistego logu oraz wyniku, a nie samego scenariusza.