Jak połączyć WooCommerce z ERLI bez BaseLinkera

Jeśli prowadzisz sklep na WooCommerce i chcesz sprzedawać na ERLI, to pytanie „jak połączyć WooCommerce z ERLI” zadałeś już sobie nie raz. I prawdopodobnie szybko trafiłeś na te same odpowiedzi co wszyscy: BaseLinker, Apilo, xSale, Sellasist — wszystkie z abonamentem, który rośnie razem ze sprzedażą (poza darmowym progiem dla najmniejszych sklepów). Ten wpis jest o trzeciej drodze: o tym, jak zrobić integrację WooCommerce z ERLI na własnym serwerze, bez pośrednika i bez opłaty od każdego zamówienia.

Czym jest ERLI i dlaczego sprzedawcy zaczynają go traktować poważnie

ERLI to polski marketplace, który wystartował w 2020 roku jako alternatywa dla Allegro. Przez pierwsze lata pozostawał w cieniu — dziś to już inna historia. W 2024 roku platforma zwiększyła sprzedaż (GMV) o 67%, do 1,23 mld zł, przy ponad 30 tysiącach aktywnych sprzedawców. Rok 2025 zamknęła wynikiem 1,8 mld zł GMV, 8,9 mln transakcji i 6,7 mln kont użytkowników — rosnąc kilkukrotnie szybciej niż cały polski rynek e-commerce.

Zanim zaczniesz sprzedawać na ERLI, warto wiedzieć, że z perspektywy sprzedawcy liczą się przede wszystkim trzy rzeczy. Po pierwsze, wystawianie ofert jest bezpłatne — płacisz głównie prowizję od sprzedaży, zwykle w okolicach 5–10%, zależnie od kategorii. Po drugie, ErliPRO to darmowa dostawa dla kupujących przy zakupach od 79 zł u jednego sprzedawcy — i, w przeciwieństwie do Allegro Smart!, bez abonamentu po stronie kupującego. Po trzecie, konkurencja w wielu kategoriach jest mniejsza niż na Allegro, co oznacza łatwiejsze wybicie się z ofertą bez dużego budżetu reklamowego.

To nie jest platforma, która zastąpi Allegro z dnia na dzień. Ale jako drugi kanał sprzedaży — z inną strukturą kosztów, bez subskrypcji kupujących i z mniejszą wojną cenową — coraz więcej sprzedawców traktuje ERLI poważnie. Jeśli czytałeś nasz wpis o tym, na czym polega uzależnienie od Allegro, wiesz, dlaczego drugi kanał ma znaczenie. I właśnie dlatego podpięliśmy ERLI do OpenLinkera.

Co tak naprawdę znaczy „integracja WooCommerce z ERLI”

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 WooCommerce z ERLI to co najmniej trzy rzeczy:

• Publikacja produktów — bierzesz produkt ze sklepu WooCommerce i wystawiasz go jako ofertę na ERLI: ze zdjęciami, parametrami i czasem wysyłki. Najlepiej masowo, a nie po jednej ofercie naraz.
• Synchronizacja stanów magazynowych — gdy sprzedasz sztukę w WooCommerce, stan na ERLI powinien spaść. Gdy sprzeda się na ERLI, WooCommerce też powinno pokazać mniejszą dostępność. W obie strony.
• Synchronizacja zamówień — każde zamówienie z ERLI 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 stany. Rozpisaliśmy ten mechanizm szczegółowo w osobnym wpisie o synchronizacji zamówień i stanów magazynowych — tutaj skupiamy się na tym, jak ułożyć to konkretnie dla WooCommerce i ERLI.

Trzy drogi: wtyczka, SaaS 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 WooCommerce do ERLI — instalujesz ją wprost w sklepie. Szybko startuje, ale żyje wewnątrz WooCommerce, zwykle ma abonament, a jej możliwości kończą się tam, gdzie skończył je autor.
• SaaS: Apilo, xSale, Sellasist, BaseLinker — 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 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. To trzecia droga — ta, którą budujemy w OpenLinkerze.

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, 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ć WooCommerce z ERLI bez BaseLinkera — krok po kroku

W uproszczeniu integracja WooCommerce z ERLI bez BaseLinkera sprowadza się do tego, że potrzebujesz systemu, który stoi pomiędzy sklepem a marketplace’em 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 WooCommerce i konto ERLI

Połączenia konfigurujesz w kreatorze krok po kroku. Po stronie WooCommerce generujesz klucz REST API — Consumer Key i Secret z uprawnieniem read/write — wklejasz go w OpenLinkerze i klikasz „Test połączenia”. Konto ERLI podłączasz jednym kluczem ERLI API (w dokumentacji ERLI: Shop API), który wygenerujesz w panelu sprzedawcy; ERLI nie ma OAuth, więc to naprawdę jedno pole. Dane uwierzytelniające każdego połączenia są szyfrowane i trzymane osobno, więc możesz mieć obok siebie kilka sklepów WooCommerce i kilka kont ERLI w jednej instancji.

W praktyce samo przejście kreatora to jakieś pięć minut — najwięcej czasu zajmuje zebranie danych dostępowych po stronie WooCommerce i ERLI. Kolejne sklepy idą już z górki.

3. Wystawiasz produkty z WooCommerce na ERLI

Kreator wystawiania bierze produkt ze sklepu, pomaga dobrać kategorię, uzupełnia parametry, zdjęcia i czas wysyłki, a na koniec publikuje ofertę. Działa to też masowo, więc nie musisz klikać każdej oferty osobno.

Jedna ciekawostka techniczna, która oszczędza sporo pracy: ERLI przyjmuje identyfikatory kategorii i parametrów z taksonomii Allegro. Jeśli więc masz już produkty zmapowane pod Allegro, OpenLinker po prostu ponownie użyje tych mapowań przy wystawianiu na ERLI — bez ponownego przechodzenia przez drzewo kategorii. A jeśli nie sprzedajesz na Allegro, oferta i tak się wystawi: ERLI traktuje kategorię jako opcjonalną.

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

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

5. Pobierasz zamówienia z ERLI do jednej kolejki

Zamówienia z ERLI wpadają do jednego miejsca obsługi — dwoma drogami naraz. ERLI wysyła webhooka, gdy coś się zmienia, a niezależnie od tego OpenLinker odpytuje dziennik zdarzeń ERLI kursorem — trwałym znacznikiem postępu. Webhook przyspiesza, kursor gwarantuje kompletność: 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. Zdarzenia są deduplikowane, więc podwójna droga nie oznacza podwójnego zamówienia.

Pełny, techniczny przewodnik — od klucza API po pierwsze zamówienie — znajdziesz w dokumentacji OpenLinkera.

Dlaczego ufamy, że to działa: dwa marketplace’y na tym samym rdzeniu

ERLI to dla nas drugi marketplace podpięty do dokładnie tego samego rdzenia, na którym od początku działa Allegro. Oba korzystają z tych samych portów i tej samej architektury wtyczkowej — logika pobierania zamówień, mapowania identyfikatorów, idempotencji (czyli odporności na duplikaty) i synchronizacji stanów jest wspólna, a adapter ERLI tylko „tłumaczy” ją na ERLI Shop API.

Dla nas to dowód, że model wtyczkowy działa: drugi marketplace nie wymagał przepisywania silnika, tylko napisania adaptera — dokładnie tak samo, jak drugi sklep, WooCommerce, nie wymagał przepisywania silnika napisanego pod PrestaShop. Dla Ciebie znaczy to coś praktycznego: integracja ERLI nie jest osobnym, oderwanym kawałkiem kodu, tylko tym samym, sprawdzonym mechanizmem, który obsługuje już Allegro.

Bądźmy tu precyzyjni co do dowodów. Adapter ERLI ma testy jednostkowe i integracyjne obejmujące całą ścieżkę zamówienia, a cały przepływ — od klucza API, przez webhooki, po pierwszą ofertę i pierwsze zamówienie — przeszliśmy w środowisku testowym ERLI (sandbox) i udokumentowaliśmy krok po kroku, ze zrzutami ekranu. To nie jest to samo co adapter WooCommerce, który ma testy E2E uruchamiane przeciwko prawdziwemu WooCommerce w Dockerze; ERLI nie udostępnia środowiska, które dałoby się podpiąć do CI. Mówimy to wprost, zamiast pisać „w pełni przetestowane”.

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.

Po drugie, OpenLinker jest w fazie alfa, przed wersją 1.0. To architektura klasy produkcyjnej, ale wykończenie wciąż na poziomie alfy. 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ś musi utrzymać infrastrukturę, aktualizacje i monitoring — Ty, partner wdrożeniowy albo my. W zamian dostajesz dane na własność i brak rachunku rosnącego razem ze sprzedażą, ale to nie jest „zero pracy”. Ktoś to hostuje — na tym polega ten układ.

Dla kogo ta droga ma sens

Integracja WooCommerce z ERLI w modelu self-hosted nie jest dla każdego. Jeśli nie chcesz 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ż WooCommerce na ERLI bez ręcznego aktualizowania stanów i zamówień,
• dokładasz ERLI jako drugi kanał obok Allegro i nie chcesz drugiego panelu ani drugiego abonamentu,
• 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, 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 sprzedają na ERLI na co dzień.

• Zobacz, jak wygląda ta sama integracja WooCommerce z Allegro — ten sam rdzeń, inny marketplace.
• Sprawdź szczegóły integracji z ERLI — co dokładnie działa dziś po stronie marketplace’u.
• Zobacz pełną listę integracji — wszystkie integracje: sklepy, marketplace’y, firmy kurierskie i fakturowanie, z uczciwym statusem każdej.
• 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.
• Zostaw gwiazdkę na GitHubie — jeśli chcesz wesprzeć rozwój otwartego systemu.

Zbuduj to z nami.