Jak połączyć PrestaShop z Allegro bez BaseLinkera

Jeśli prowadzisz sklep na PrestaShop i sprzedajesz na Allegro, to pytanie „jak połączyć PrestaShop z Allegro” zadałeś już sobie nie raz. I prawdopodobnie szybko trafiłeś na te same dwie odpowiedzi co wszyscy: wtyczka z abonamentem albo BaseLinker. Ten wpis jest o trzeciej drodze — o tym, jak zrobić integrację PrestaShop z Allegro na własnym serwerze, bez pośrednika i bez opłaty od każdego zamówienia.

Ta trzecia droga jest realna od dawna, bo PrestaShop to nasz pierwszy i referencyjny sklep. To od niego zaczęliśmy OpenLinkera i to na nim sprawdziliśmy, że cały ten pomysł w ogóle się trzyma. Później dopiero na tym samym rdzeniu powstał adapter WooCommerce. Dlatego ten wpis chcemy napisać inaczej niż zwykły poradnik „kliknij tu, wpisz tam”.

Dlaczego akurat od PrestaShop zaczęliśmy? Bo to jeden z najpopularniejszych silników sklepowych wśród polskich sprzedawców, którzy wystawiają na Allegro — a najpierw budujemy to, co realnie odblokowuje najwięcej osób.

Co tak naprawdę znaczy „integracja PrestaShop z Allegro”

Zacznijmy od uporządkowania pojęcia, bo „integracja” brzmi jak jedna rzecz, a w praktyce to kilka osobnych przepływów danych, które muszą działać razem.

Dobra integracja PrestaShop z Allegro to co najmniej trzy rzeczy:

• Wystawianie ofert Allegro z PrestaShop — bierzesz produkt ze sklepu i publikujesz go jako ofertę na Allegro: ze zdjęciami, parametrami, danymi GPSR i polityką sprzedaży. Najlepiej również masowo, a nie po jednej ofercie naraz.
• Synchronizacja stanów magazynowych — gdy sprzedasz sztukę w PrestaShop, stan na Allegro powinien spaść. Gdy sprzeda się na Allegro, PrestaShop też powinno pokazać mniejszą dostępność. W obie strony.
• Synchronizacja zamówień — każde zamówienie z Allegro trafia do jednej kolejki obsługi, dokładnie raz, żeby nie zginęło i nie pobrało się dwa razy.

Jeśli któregokolwiek z tych przepływów brakuje albo działa za wolno, pojawiają się dobrze znane problemy: nadsprzedaż, zdublowane zamówienia, pomylone SKU. Tutaj skupiamy się na tym, jak ułożyć to konkretnie dla PrestaShop i Allegro.

Trzy drogi: wtyczka, BaseLinker albo własny silnik

Zanim pokażemy, jak działa to w OpenLinkerze, warto uczciwie nazwać alternatywy — bo każda ma sens i każda ma inny kompromis, przede wszystkim kosztowy.

• Wtyczka PrestaShop do Allegro — instalujesz ją wprost w sklepie. Szybko startuje, ale żyje wewnątrz PrestaShop, zwykle ma abonament, a jej możliwości kończą się tam, gdzie skończył je autor.
• BaseLinker, Apilo i inne SaaS-y — gotowy system w cudzej chmurze. Wygodny, ale dane zamówień i klientów przechodzą przez zewnętrzną platformę, a opłata zwykle rośnie razem z liczbą zamówień. Szczegółową matematykę kosztów rozkładamy w porównaniu z BaseLinkerem.
• Własny silnik self-hosted — działa na Twojej infrastrukturze, trzyma dane po Twojej stronie i nie pobiera prowizji od zamówienia.

Najprościej widać to po samym kształcie rachunku: wtyczka to abonament, SaaS to opłata rosnąca razem ze sprzedażą, a self-hosting to koszt serwera, który nie rośnie z liczbą zamówień, i zero opłat licencyjnych. (Prowizja od sprzedaży na Allegro obowiązuje w każdym z tych wariantów — to opłata marketplace, nie integracji.) To trzecia droga — ta, którą budujemy w OpenLinkerze, i to o niej jest reszta tego wpisu.

Self-hosting znaczy tu coś konkretnego, nie tylko „tańszy abonament”. Zamówienia, dane klientów i konfiguracja zostają na Twoim serwerze — możesz je audytować, podłączyć do własnego ERP i dołożyć reguły (cenowe, GPSR, własne statusy), których gotowe narzędzie nigdy nie przewidziało. Przy rosnącej skali liczy się też to, że masz jeden, wiarygodny stan magazynowy zamiast paneli, które się rozjeżdżają — i rachunek, który nie rośnie tylko dlatego, że sprzedajesz więcej.

Jak połączyć PrestaShop z Allegro bez BaseLinkera — krok po kroku

W uproszczeniu integracja PrestaShop z Allegro bez BaseLinkera sprowadza się do tego, że potrzebujesz systemu, który stoi pomiędzy sklepem a marketplace i rozmawia z oboma przez ich oficjalne API. Tak to wygląda w OpenLinkerze.

1. Uruchamiasz OpenLinkera na własnej infrastrukturze

OpenLinker jest self-hosted, więc startujesz go u siebie — na własnym serwerze, w Dockerze. Od tego momentu wszystkie dane — zamówienia, stany, mapowania produktów, dane klientów — zostają pod Twoim dachem. Nie przechodzą przez żadną zewnętrzną usługę.

2. Podłączasz sklep PrestaShop i konto Allegro

Połączenia konfigurujesz w kreatorze krok po kroku. Po stronie PrestaShop podajesz dane dostępowe do sklepu i instalujesz towarzyszący moduł, po stronie Allegro autoryzujesz konto przez OAuth. Dane uwierzytelniające każdego połączenia są szyfrowane i trzymane osobno, więc możesz mieć obok siebie kilka sklepów PrestaShop i kilka kont Allegro w jednej instancji.

Dokładne kroki po stronie marketplace — autoryzację OAuth i konfigurację — opisaliśmy w przewodniku konfiguracji Allegro.

3. Wystawiasz produkty z PrestaShop na Allegro

Kreator wystawiania bierze produkt ze sklepu, pomaga dobrać kategorię Allegro (również po numerze EAN), uzupełnia parametry, zdjęcia, dane GPSR i politykę sprzedaży, i publikuje ofertę. To jest sedno wystawiania ofert Allegro z PrestaShop bez ręcznego przepisywania każdej oferty od zera.

4. Włączasz dwukierunkową synchronizację stanów

Od tej chwili stan magazynowy pilnuje się sam w obie strony. Sprzedaż w PrestaShop schodzi ze stanu widocznego na Allegro, a sprzedaż na Allegro — ze stanu w PrestaShop. To jest sedno synchronizacji PrestaShop z Allegro: jeden, wiarygodny stan zamiast dwóch paneli, które się rozjeżdżają.

5. Pobierasz zamówienia z Allegro i domykasz obieg wysyłki

Zamówienia z Allegro wpadają do jednego miejsca obsługi i przechodzą przez pełny cykl życia po stronie PrestaShop. Pobieranie opiera się na kursorze — trwałym znaczniku postępu — dzięki czemu zawsze można je wznowić. Po stronie sklepu OpenLinker wykorzystuje date_upd PrestaShop jako znacznik ostatniej zmiany, więc jeśli cokolwiek się zatrzyma, system wie, na czym skończył, i podejmuje pracę od właściwego miejsca, zamiast zaczynać od zera albo gubić zamówienia.

Żeby domknąć wysyłkę marketplace, adapter PrestaShop dokłada towarzyszący moduł „OL Dynamic Carrier”. To on sprawia, że dane przewoźnika i przesyłki z Allegro poprawnie trafiają do PrestaShop, a etykieta i śledzenie wracają tam, gdzie powinny — z mapowaniem na przewoźników InPost i DPD. To właśnie różni stabilną synchronizację zamówień PrestaShop i Allegro od weekendowego skryptu.

A gdy zamówienie już wpadnie, fakturę do niego wystawisz w tym samym systemie — OpenLinker ma osobny adapter KSeF, więc dokument trafia do Krajowego Systemu e-Faktur bez przepisywania do kolejnego programu.

Dlaczego ufamy, że to działa: PrestaShop to nasz punkt odniesienia

Tu chcemy być uczciwi co do tego, co naprawdę zbudowaliśmy, a nie tylko obiecali.

PrestaShop to sklep, od którego OpenLinker się zaczął — pierwszy adapter i wzorzec, na którym oparliśmy porty i architekturę wtyczkową całego systemu. Kiedy później dokładaliśmy drugi sklep, WooCommerce, nie przepisywaliśmy silnika — napisaliśmy tylko nowy adapter na tym samym rdzeniu. To dla nas dowód, że model wtyczkowy naprawdę się trzyma, a punktem odniesienia był właśnie PrestaShop.

Dla Ciebie liczy się coś bardziej praktycznego: to nie jest świeży, nieprzetestowany kawałek kodu. Adapter PrestaShop ma prawdziwe testy integracyjne — nasz pakiet @openlinker/test-kit uruchamia harness na Testcontainers przeciwko prawdziwemu PrestaShop (oraz Postgresowi i Redisowi), więc pobieranie zamówień, mapowanie identyfikatorów i synchronizacja stanów są weryfikowane wobec realnego sklepu, a nie „na oko”.

Bądźmy szczerzy co do granic

Nie chcemy, żeby ten wpis brzmiał jak ulotka, więc kilka rzeczy mówimy wprost.

Po pierwsze, wśród marketplace’ów działają dziś Allegro i ERLI. eBay, Amazon, OLX, Empik i kolejne są w planach, ale jeszcze nie działają — i nie udajemy, że jest inaczej. Jeśli Twój drugi kanał to dziś Amazon, OpenLinker jeszcze go nie obsługuje.

Po drugie, OpenLinker jest w fazie alfa, przed wersją 1.0. Sama integracja Allegro ma testy jednostkowe i integracyjne oraz obsługuje sandbox Allegro, ale — powiedzmy to wprost — nic nie działa przeciwko produkcyjnemu Allegro w CI. To architektura klasy produkcyjnej, ale wykończenie wciąż na poziomie alfy. Dlatego prowadzimy projekt w otwarty sposób: na stronie integracji na bieżąco pokazujemy, co już działa, co jest w trakcie, a co dopiero planujemy. Możesz tam zweryfikować każdą obietnicę z tego wpisu.

Po trzecie, self-hosting to realny kompromis. Ktoś po Twojej stronie musi utrzymać infrastrukturę, aktualizacje i monitoring — dlatego sklepy bez własnego developera zwykle uruchamiają to z partnerem wdrożeniowym, a nie samodzielnie. W zamian dostajesz dane na własność i brak rachunku rosnącego razem ze sprzedażą — ale to nie jest „zero pracy”. Hostujesz to sam; na tym polega ten układ.

Dla kogo ta droga ma sens

Integracja PrestaShop z Allegro w modelu self-hosted nie jest dla każdego. Jeśli chcesz podłączyć sklep w pięć minut i nie utrzymywać żadnej infrastruktury, gotowy SaaS będzie wygodniejszy — i to jest w porządku.

Ta droga ma sens, jeśli rozpoznajesz się w którymś z tych zdań:

• chcesz zautomatyzować sprzedaż PrestaShop na Allegro bez ręcznego aktualizowania stanów i zamówień,
• rachunek za SaaS rośnie razem z Twoją sprzedażą i zaczyna boleć,
• chcesz mieć dane zamówień i klientów po swojej stronie, a nie na cudzym serwerze,
• potrzebujesz dołożyć własną logikę — reguły cenowe, obsługę GPSR, wpięcie do ERP — której gotowe narzędzie nie przewidziało,
• masz kogoś, kto utrzyma infrastrukturę, albo pracujesz z partnerem wdrożeniowym, który to zrobi.

Jeśli to o Tobie, to właśnie dla Ciebie budujemy ten fundament.

Co możesz zrobić teraz

OpenLinker jest wciąż w budowie i chętnie poznamy Twoje uwagi już na wczesnym etapie — szczególnie od sprzedawców, którzy łączą PrestaShop z Allegro na co dzień.

• Odezwij się jako sklep lub partner wdrożeniowy — pracujemy blisko z pierwszymi sklepami i jest miejsce dla kolejnych.
• Zapisz się do newslettera — krótkie aktualizacje o tym, co dochodzi i co się zmienia.
• Sprawdź szczegóły integracji PrestaShop — co dokładnie działa dziś po stronie sklepu.
• Zobacz szczegóły integracji Allegro — pełny zakres tego, co obsługujemy po stronie marketplace.
• Zobacz pełną listę integracji — uczciwy obraz tego, co gotowe, co w toku, a co planowane.
• Zostaw gwiazdkę na GitHubie — jeśli chcesz wesprzeć rozwój otwartego systemu.

Zbuduj to z nami.