OpenCart lub Shopify z Allegro i InPost One API — BaseLinker krok po kroku, migracja i 6 błędów [2026]

Integracja Shopify z Allegro, InPost i BaseLinker — od czego zacząć?

Shopify w Polsce obsługuje już ponad 11 tysięcy sklepów, a ta liczba rośnie z kwartału na kwartał. Problem pojawia się w momencie, gdy właściciel sklepu chce sprzedawać jednocześnie na Allegro, wysyłać paczki przez InPost i ogarnąć to wszystko w jednym panelu. Bez odpowiedniej integracji — robi się chaos.

Z mojego doświadczenia w HeyNeuron wynika jedno: sklep na Shopify bez integracji z polskimi systemami to jak samochód bez GPS. Niby jedzie, ale trasa jest trzy razy dłuższa. W tym artykule pokażę dokładnie, jak połączyć Shopify z kluczowymi narzędziami polskiego e-commerce, ile to kosztuje i jakich błędów unikać.

Dlaczego sam Shopify nie wystarczy na polskim rynku?

Shopify to świetna platforma sprzedażowa — elastyczna, szybka, z ogromnym ekosystemem aplikacji. Ale została zaprojektowana z myślą o rynku amerykańskim i zachodnioeuropejskim. Na polskim rynku e-commerce, którego wartość przekracza już 92 miliardy złotych według edrone, brakuje natywnych integracji z kluczowymi systemami.

Allegro z 24 milionami aktywnych użytkowników i ponad 120 milionami ofert to marketplace, na którym trzeba być — ale Shopify nie ma wbudowanej integracji z Allegro. InPost z Paczkomatami dominuje w logistyce e-commerce, a tutaj też potrzebna jest dodatkowa warstwa. Do tego dochodzą polskie systemy fakturowania (iFirma, Fakturownia), magazynowe (Subiekt GT, Optima) i hurtownie.

W jednym z naszych projektów klient prowadził sklep Shopify i ręcznie kopiował zamówienia do Allegro, a etykiety InPost generował osobno. Tracił na to 3 godziny dziennie. Po wdrożeniu BaseLinker ten czas spadł do zera — wszystko działało automatycznie.

Oto obszary, które wymagają integracji:

1. Marketplace — Allegro, Amazon, Empik, Ceneo (feed produktowy)
2. Logistyka — InPost, DPD, DHL, Poczta Polska, Orlen Paczka
3. Fakturowanie — iFirma, Fakturownia, wFirma, InFakt
4. ERP/Magazyn — Subiekt GT, Comarch Optima, Enova
5. Hurtownie — synchronizacja stanów magazynowych i cen z dostawcami

Narzędzia do integracji Shopify — porównanie

Na polskim rynku istnieją trzy główne platformy integracyjne, które łączą Shopify z lokalnymi systemami. Każda ma inne mocne strony i inny model cenowy.

Narzędzie	Cena od (netto/mies.)	Najlepsze dla
BaseLinker	0 zł (free) / 99 zł (Business)	Wielokanałowa sprzedaż, 1300+ integracji
Sellasist	od 79 zł	Allegro + Shopify w jednym panelu
Apilo	od 99 zł	Automatyzacja procesów fulfillment

BaseLinker (oficjalnie od 2025 roku rebrandowany jako Base) to zdecydowanie najpopularniejsze rozwiązanie w Polsce. Według danych z kcmobile.pl, plan Freemium obsługuje do 100 zamówień miesięcznie za darmo, a plan Business (99 zł netto/miesiąc) dodaje opłatę 0,59 zł za zamówienie do 1000 sztuk. Dla sklepu przetwarzającego 500 zamówień miesięcznie realistyczny koszt to około 394 zł netto miesięcznie.

Sellasist skupia się na integracji marketplace’ów — łączy Shopify z dowolną liczbą kont Allegro i umożliwia wystawianie ofert z jednego miejsca. Model cenowy oparty jest na liczbie zamówień, bez ukrytych opłat za integrację z konkretnymi kurierami.

Apilo stawia na automatyzację — od momentu złożenia zamówienia do wygenerowania etykiety kurierskiej proces może przebiegać całkowicie bez ingerencji człowieka. Silne w logistyce, słabsze w integracji z polskimi systemami ERP.

W mojej praktyce najczęściej rekomenduję BaseLinker — nie dlatego, że jest najtańszy, ale dlatego, że obsługuje ponad 1300 integracji i sprawdza się zarówno przy 100, jak i 10 000 zamówień miesięcznie. Jeśli szukasz kompleksowego porównania narzędzi integracyjnych, przeczytaj nasz przewodnik po integracji sklepu internetowego.

Integracja Shopify z Allegro — krok po kroku

To najczęściej wyszukiwana integracja wśród polskich sprzedawców na Shopify. Allegro nie oferuje natywnego połączenia z Shopify, więc potrzebujesz pośrednika.

Krok 1: Wybierz narzędzie integracyjne. BaseLinker, Sellasist lub Apilo — każde z nich łączy się zarówno z Shopify API, jak i z Allegro REST API. Podłączenie techniczne zajmuje 15-30 minut na każdą stronę.

Krok 2: Zmapuj katalog produktów. To najważniejszy i najczęściej niedoceniany etap. Allegro wymaga specyficznych atrybutów produktów (parametry kategorii, opisy zgodne z regulaminem, zdjęcia w określonych formatach). Nie wystarczy „przerzucić” oferty z Shopify — trzeba je dostosować.

Krok 3: Skonfiguruj synchronizację stanów magazynowych. Dwukierunkowa synchronizacja oznacza, że sprzedaż na Allegro automatycznie zmniejsza stan w Shopify i na odwrót. Bez tego ryzykujesz overselling — a Allegro za to karze obniżeniem jakości konta.

Krok 4: Ustaw automatyzację zamówień. Zamówienie z Allegro powinno automatycznie pojawiać się w panelu Shopify (lub BaseLinker) z kompletem danych do realizacji: adres, metoda wysyłki, płatność. Skonfiguruj też automatyczne statusy — Allegro wymaga aktualizacji statusu wysyłki z numerem przesyłki.

Krok 5: Przetestuj na małej partii. Wystaw 5-10 produktów, złóż testowe zamówienie, sprawdź czy stany się synchronizują i czy statusy aktualizują się poprawnie. Dopiero potem otwórz pełny katalog.

Widziałem sklepy, które pomijały krok 2 i wrzucały na Allegro niezmapowane produkty — efekt? Oferty odrzucone, konto zablokowane na 7 dni. Więcej o pułapkach integracji z marketplace znajdziesz w naszym artykule o integracji z Allegro.

Integracja Shopify z InPost — automatyzacja wysyłek

Paczkomaty InPost obsługują ponad 60% przesyłek e-commerce w Polsce. Jeśli prowadzisz sklep na Shopify i nie oferujesz dostawy do Paczkomatu — tracisz klientów.

Bezpośrednia integracja Shopify z InPost jest możliwa przez aplikację Shopify (np. Furgonetka, Baselinker Shipping) lub przez platformę integracyjną. W BaseLinker proces wygląda tak:

1. Podłączasz konto InPost w panelu BaseLinker (klucz API z panelu InPost Manager)
2. Tworzysz regułę automatyzacji: „Jeśli zamówienie opłacone + dostawa Paczkomat → wygeneruj etykietę InPost i zmień status na Gotowe do wysyłki”
3. Drukujesz etykiety zbiorczo — BaseLinker pozwala wygenerować 50, 100 czy 500 etykiet jednym kliknięciem

Automatyzacja jest kluczowa przy skali. Przy 20 zamówieniach dziennie ręczne generowanie etykiet zajmuje 40-60 minut. Przy 200 zamówieniach — to fizycznie niemożliwe bez automatyzacji.

Oprócz InPost warto od razu skonfigurować DPD (dla paczek niestandardowych) i Pocztę Polską (dla klientów preferujących tradycyjną dostawę). BaseLinker obsługuje ponad 100 firm kurierskich. Szczegóły integracji kurierskich opisaliśmy w artykule o integracji InPost ze sklepem internetowym.

Integracja Shopify z BaseLinker — centralny hub operacyjny

BaseLinker (Base) pełni rolę centralnego systemu zarządzania e-commerce. Zamiast logować się osobno do Shopify, Allegro, InPost i Fakturowni — zarządzasz wszystkim z jednego panelu.

Podłączenie Shopify do BaseLinker zajmuje dosłownie 5 minut: w panelu BaseLinker dodajesz nowy sklep, wybierasz Shopify, wklejasz adres sklepu i autoryzujesz dostęp przez OAuth. Od tego momentu zamówienia z Shopify automatycznie pojawiają się w BaseLinker.

Co zyskujesz po integracji:

• Zamówienia ze WSZYSTKICH kanałów w jednym widoku (Shopify + Allegro + Amazon)
• Automatyczne generowanie faktur (podłączasz iFirmę lub Fakturownię)
• Zbiorcze drukowanie etykiet kurierskich
• Synchronizacja stanów magazynowych w czasie rzeczywistym
• Automatyczne powiadomienia do klienta o statusie przesyłki

Według danych z kcmobile.pl, koszt wdrożenia BaseLinker przez agencję to od 2 000 do 8 000 zł netto jednorazowo, w zależności od liczby kanałów i poziomu automatyzacji. Oficjalne pakiety BaseLinker zaczynają się od 1 000 zł (Start) do 4 800 zł (Premium).

Jeśli Twój sklep przetwarza więcej niż 500 zamówień miesięcznie, warto rozważyć wdrożenie z agencją — inwestycja zwraca się w ciągu 2-3 miesięcy dzięki oszczędności czasu. Więcej o kosztach i pułapkach BaseLinker znajdziesz w naszym przewodniku po integracji BaseLinker.

Integracja z hurtowniami i ERP

Dla sklepów Shopify działających w modelu dropshipping lub z wieloma dostawcami, integracja z hurtowniami jest niezbędna. Synchronizacja obejmuje:

• Stany magazynowe — aktualizacja co 15-60 minut z systemu hurtowni
• Ceny — automatyczne przeliczanie z narzutem (np. cena hurtowa + 30% marża)
• Opisy i zdjęcia — import z feedu XML/CSV hurtowni do Shopify

BaseLinker obsługuje import z plików XML, CSV i przez API. Dla popularnych polskich hurtowni (AB, Action, ALSO) istnieją gotowe wtyczki. Dla mniej popularnych — potrzebna jest konfiguracja mapowania pól, co zajmuje od kilku godzin do 2 dni roboczych.

Integracja z systemami ERP (Subiekt GT, Comarch Optima, Enova) to osobny temat. Wymaga ona dedykowanego middleware’u — np. SellIntegro, SubSync lub niestandardowego łącznika. Koszt takiej integracji zaczyna się od 1 380 zł rocznie (SubSync) i rośnie w zależności od złożoności. O tym pisaliśmy szczegółowo w artykule o integracji WooCommerce z Subiekt GT — mechanizm jest analogiczny dla Shopify.

Nie zapominaj też o integracji z hurtowniami, która jest kluczowa dla modelu dropshipping na Shopify.

Ile kosztuje pełna integracja Shopify z polskimi systemami?

To pytanie, które słyszę na każdym spotkaniu z klientem. Odpowiedź zależy od skali, ale mogę podać realistyczne widełki.

Scenariusz 1: Mały sklep (do 200 zamówień/miesiąc)

• BaseLinker Freemium → Business: 0-217 zł/mies.
• Wdrożenie samodzielne: 0 zł (dokumentacja BaseLinker jest dobra)
• Shopify Basic: 139 zł/mies.
• Łącznie: 139-356 zł miesięcznie

Scenariusz 2: Średni sklep (200-1000 zamówień/miesiąc)

• BaseLinker Business: 217-689 zł/mies.
• Wdrożenie przez agencję: 3 000-5 000 zł jednorazowo
• Integracja ERP (opcja): 1 380-3 000 zł/rok
• Shopify: 349 zł/mies.
• Łącznie: 566-1038 zł/mies. + jednorazowe wdrożenie

Scenariusz 3: Duży sklep (1000+ zamówień/miesiąc)

• BaseLinker Business/Enterprise: 689-1500+ zł/mies.
• Wdrożenie dedykowane: 5 000-15 000 zł jednorazowo
• Integracja ERP + hurtownie: 3 000-10 000 zł/rok
• Shopify Advanced: 1 499 zł/mies.
• Łącznie: 2 188-3 000+ zł/mies. + wdrożenie

Koszty integracji stanowią zazwyczaj 15-25% całkowitych kosztów operacyjnych sklepu. Brzmi dużo? Porównaj to z kosztem 2-3 pracowników, którzy ręcznie obsługiwaliby te same procesy — sam wynagrodzenie to minimum 10 000-15 000 zł miesięcznie.

Jeśli zastanawiasz się nad kosztami ERP, przeczytaj nasz artykuł ile kosztuje wdrożenie ERP w firmie. A jeśli dopiero wybierasz bramkę płatności dla sklepu, warto to zrobić równolegle z konfiguracją integracji.

Ukryte koszty, o których nikt nie mówi

W mojej pracy z kilkudziesięcioma sklepami e-commerce zauważyłem, że klienci regularnie nie doszacowują trzech obszarów kosztowych:

Czas na mapowanie produktów. Jeśli masz 5 000 SKU, zmapowanie ich do kategorii Allegro (z poprawnym uzupełnieniem parametrów) zajmie 40-80 roboczogodzin. Przy stawce 100 zł/h to dodatkowe 4 000-8 000 zł, które nie pojawiają się w żadnym cenniku narzędzia.

Koszty błędów na Allegro. Overselling, opóźnione wysyłki, brak numerów przesyłek — Allegro za każde z tych przewinień obniża jakość konta. Spadek poniżej progu Super Sprzedawcy oznacza utratę widoczności ofert i realny spadek sprzedaży o 20-40%. Dobra integracja to nie koszt — to ubezpieczenie.

Utrzymanie i aktualizacje. API Allegro zmienia się 2-4 razy w roku. API Shopify — podobnie. Każda zmiana może wymagać aktualizacji konfiguracji w BaseLinker. Przy samodzielnej obsłudze to kilka godzin rocznie. Przy dedykowanej integracji (custom middleware) — potencjalnie kilkadziesiąt godzin pracy developera.

Checklist przed rozpoczęciem integracji

Zanim zaczniesz podłączać systemy, upewnij się, że masz przygotowane fundamenty. Z doświadczenia wiem, że pominięcie któregokolwiek z tych punktów kończy się cofaniem i powtarzaniem pracy.

• Konto firmowe na Allegro — zweryfikowane, z uzupełnionym profilem sprzedawcy
• Klucze API — wygenerowane w panelu Allegro (REST API), InPost (Manager) i Shopify (Admin API)
• Zmapowany katalog produktów — lista SKU z przypisanymi kategoriami Allegro i EAN-ami
• Polityka cenowa — ustalone reguły: czy cena na Allegro = cena w Shopify, czy z narzutem na prowizję?
• System fakturowania — konto w iFirma, Fakturownia lub wFirma gotowe do podłączenia
• Umowy kurierskie — wynegocjowane stawki z InPost, DPD lub innymi kurierami (stawki indywidualne są 30-50% niższe niż cennikowe)
• Plan automatyzacji — które procesy automatyzujesz na start, a które ręcznie (nie automatyzuj wszystkiego od razu)
• Osoba odpowiedzialna — kto w zespole będzie administrował BaseLinker i reagował na alerty

5 najczęstszych błędów przy integracji Shopify z polskimi systemami

Przez lata pracy z e-commerce widziałem te same błędy powtarzane przez dziesiątki sklepów. Oto pięć, które kosztują najwięcej.

1. Brak testowania synchronizacji stanów. Sklep podłącza Allegro, wystawia 2 000 produktów i… okazuje się, że stany nie synchronizują się w czasie rzeczywistym, tylko co 30 minut. Efekt: 15 zamówień na produkty, których nie ma na stanie. Zawsze rób testy na małej partii.

2. Jedno konto BaseLinker na wielu pracowników. BaseLinker oferuje konta użytkowników z różnymi uprawnieniami. Ignorowanie tego kończy się sytuacją, w której magazynier przypadkowo zmienia ceny, a handlowiec kasuje automatyzacje.

3. Ignorowanie prowizji Allegro w polityce cenowej. Prowizja Allegro to 5-12% w zależności od kategorii, plus opłata za Allegro Smart. Jeśli Twoja cena na Allegro jest taka sama jak w Shopify — marża na Allegro jest o te 5-12% niższa. Skonfiguruj automatyczne doliczanie prowizji w BaseLinker.

4. Brak planu B na awarię integracji. API pada, BaseLinker ma przerwę techniczną, Allegro zmienia format danych. Zawsze miej procedurę awaryjną: kto ręcznie realizuje zamówienia, jak szybko, z jakim priorytetem.

5. Automatyzacja wszystkiego od pierwszego dnia. Widziałem sklepy, które jednocześnie podłączały Allegro, Amazon, 3 kurierów, ERP i hurtownie. Gdy coś nie działało — nie wiadomo było, co jest źródłem problemu. Zacznij od jednego kanału, ustabilizuj, dodaj następny.

Integracja OpenCart z Allegro — krok po kroku w 2026

OpenCart to popularna platforma w polskim e-commerce, szczególnie wśród sklepów B2B i hurtowni. Jednak natywna integracja OpenCart z Allegro nie istnieje — musisz użyć jednej z trzech metod.

3 metody integracji OpenCart z Allegro

Metoda 1 — BaseLinker (rekomendowana). BaseLinker to najwygodniejsze rozwiązanie dla OpenCart. Instalujesz moduł BaseLinker dla OpenCart (wersja 2.x, 3.x i 4.x), łączysz z kontem BaseLinker, a stamtąd zarządzasz wystawianiem ofert na Allegro. Koszt: abonament BaseLinker od 99 zł/mies. + moduł jednorazowo 199-499 zł. Integracja działa dla OpenCart 2.3+, 3.0+ i 4.0+.

Krok po kroku: OpenCart + BaseLinker + Allegro:

1. Zarejestruj konto BaseLinker i podłącz kanał Allegro
2. Pobierz moduł BaseLinker dla OpenCart z Marketplace lub od resellera
3. Zainstaluj moduł w panelu OpenCart (Extensions → Installer)
4. Skonfiguruj token API BaseLinker w ustawieniach modułu
5. Włącz synchronizację stanów magazynowych (ważne: jednostronna OC → BL lub dwustronna)
6. W BaseLinker utwórz szablony aukcji Allegro i uruchom eksport
7. Skonfiguruj automatyczne tworzenie zamówień w OpenCart po sprzedaży na Allegro

Metoda 2 — dedykowany moduł Allegro dla OpenCart. Na rynku jest kilka płatnych modułów bezpośrednich (np. Iai-Allegro, AllegroSeller). Koszt: 300-800 zł jednorazowo. Mają mniej funkcji niż BaseLinker (np. brak zarządzania innymi kanałami), ale jeśli sprzedajesz TYLKO na Allegro — są wystarczające.

Metoda 3 — custom integracja przez API Allegro REST. Dedykowane rozwiązanie dla sklepów z niestandardowymi procesami. Allegro REST API v2 obsługuje pełny cykl: wystawianie, aktualizacja stanów, pobieranie zamówień. Koszt realizacji: 8 000–25 000 zł. Czas: 3–8 tygodni. W HeyNeuron realizujemy takie integracje dla sklepów B2B z integracją ERP.

Najczęstsze problemy przy integracji OpenCart z Allegro

• Stany magazynowe nie synchronizują się: Sprawdź ustawienia crona w OpenCart — synchronizacja wymaga aktywnego harmonogramu zadań.
• Zdjęcia produktów nie przechodzą: Allegro wymaga zdjęć min. 800×800px w ratio 1:1. OpenCart generuje różne rozmiary miniatur — sprawdź które URL'e przekazujesz do BaseLinker.
• Zamówienia nie tworzą się w OpenCart: Sprawdź mapowanie statusów zamówień i czy webhook od BaseLinker ma dostęp do Twojego serwera (białe IP, firewall).

Jak zintegrować OpenCart z Allegro?

Najszybciej przez BaseLinker: instalujesz moduł OpenCart, łączysz z kontem BaseLinker, a stamtąd wystawiasz na Allegro i zarządzasz zamówieniami. Koszt od 99 zł/mies. Alternatywa: dedykowany moduł Allegro dla OpenCart (300–800 zł jednorazowo) lub custom integracja przez Allegro REST API.

Czy OpenCart ma natywną integrację z Allegro?

Nie — OpenCart nie ma wbudowanej integracji z Allegro. Do połączenia obu systemów potrzebujesz zewnętrznego narzędzia: BaseLinker (rekomendowany), dedykowanego modułu Allegro dla OpenCart lub custom rozwiązania przez API Allegro REST.

FAQ — Integracja Shopify z polskimi systemami

Czy mogę zintegrować Shopify z Allegro bez BaseLinker?

Tak, alternatywami są Sellasist i Apilo. Możesz też napisać własną integrację przez Allegro REST API i Shopify Admin API, ale to wymaga developera i kilkudziesięciu godzin pracy. Przy budżecie poniżej 500 zł miesięcznie BaseLinker Freemium jest najprostszym rozwiązaniem.

Ile trwa wdrożenie integracji Shopify z Allegro?

Samo podłączenie techniczne to 1-2 godziny. Pełne wdrożenie z mapowaniem produktów, konfiguracją automatyzacji i testami zajmuje od 3 dni (mały sklep, 100 SKU) do 2-3 tygodni (duży sklep, 5000+ SKU z integracją ERP).

Czy integracja Shopify z InPost wymaga osobnej aplikacji?

Nie, jeśli używasz BaseLinker — InPost jest jednym z ponad 100 kurierów dostępnych w panelu. Jeśli nie chcesz BaseLinker, możesz użyć aplikacji Furgonetka z Shopify App Store, która obsługuje InPost, DPD, DHL i Pocztę Polską.

Jakie są prowizje Allegro dla sprzedawców z Shopify?

Prowizje Allegro nie zależą od platformy sklepu — są takie same dla wszystkich sprzedawców. Wynoszą od 5% do 12% wartości sprzedaży w zależności od kategorii produktu, plus stała opłata za wystawienie (od 0 zł do kilku złotych za ofertę).

Czy BaseLinker obsługuje Shopify Markets (sprzedaż międzynarodową)?

Tak, BaseLinker synchronizuje zamówienia z Shopify Markets, w tym warianty cenowe i walutowe. Jeśli sprzedajesz z Shopify na rynki zagraniczne i jednocześnie na Allegro w Polsce — BaseLinker agreguje wszystkie zamówienia w jednym widoku.

Czy mogę podłączyć Shopify do Subiekt GT?

Tak, ale nie bezpośrednio. Potrzebujesz middleware’u: SubSync, SellIntegro lub BaseLinker z modułem ERP (dodatkowe 49-99 zł/mies.). Synchronizacja obejmuje stany magazynowe, ceny, zamówienia i dokumenty sprzedaży.

Co się dzieje, gdy API Allegro zmieni się w trakcie działania integracji?

BaseLinker i Sellasist aktualizują swoje łączniki automatycznie — to ich odpowiedzialność. Przy dedykowanej integracji (custom code) musisz sam monitorować changelog Allegro REST API i aktualizować kod. Allegro wprowadza zmiany 2-4 razy w roku z 3-miesięcznym okresem przejściowym.

Czy warto integrować Shopify z Ceneo?

Ceneo to porównywarka cen, nie marketplace — integracja polega na generowaniu feedu produktowego (XML) i przesyłaniu go do panelu Ceneo. BaseLinker generuje taki feed automatycznie. Koszt Ceneo to prowizja za kliknięcie (CPC), zazwyczaj 0,20-1,50 zł. Warto, jeśli sprzedajesz produkty, które ludzie porównują cenowo (elektronika, AGD, kosmetyki).

Podsumowanie — od czego zacząć?

Integracja Shopify z polskimi systemami to nie jednorazowy projekt, a ciągły proces optymalizacji. Zaczynasz od BaseLinker + Allegro + InPost, a potem stopniowo dodajesz kolejne warstwy: ERP, hurtownie, dodatkowe marketplace’y.

Kluczowe wnioski:

• Zacznij od jednego kanału (najczęściej Allegro) i ustabilizuj integrację przed dodaniem kolejnych
• BaseLinker to standard rynkowy w Polsce — od 0 zł (Freemium) do 1 500+ zł dla dużych sklepów
• Budżet na wdrożenie: 0 zł (samodzielnie) do 15 000 zł (agencja, pełna automatyzacja z ERP)
• Nie ignoruj ukrytych kosztów: mapowanie produktów, prowizje Allegro, utrzymanie integracji

Jeśli potrzebujesz pomocy z integracją Shopify z polskimi systemami — skontaktuj się z nami. W HeyNeuron wdrażamy integracje e-commerce od lat i pomożemy Ci uniknąć najczęstszych błędów. Możesz też sprawdzić naszą ofertę integracji.

Integracja OpenCart z Allegro — 5 błędów, które kosztują cię zlecenia

Przez ostatnie dwa lata w HeyNeuron obsługiwałem kilkanaście projektów integracji OpenCart z Allegro. Za każdym razem te same pięć błędów pojawiały się u klientów, którzy próbowali to zrobić samodzielnie. Oto konkretna lista — żebyś nie powtarzał tych samych pomyłek.

Błąd 1: Nieaktualna wersja OpenCart. BaseLinker i moduły Allegro wymagają minimum OpenCart 3.0.3.x lub 4.0.x. OpenCart 2.x jest technicznie obsługiwany przez niektóre wtyczki, ale ich aktualizacje urywają się — a Allegro zmienia API kilka razy w roku. Sprawdź wersję w panelu administracyjnym OpenCart (Help → About) i jeśli widzisz 2.x, zaplanuj migrację zanim zaczniesz integrację.

Błąd 2: Pominięcie mapowania kategorii Allegro. Allegro ma własną, specyficzną taksonomię kategorii. Jeśli nie zmapujesz swoich kategorii OpenCart na kategorie Allegro, Twoje oferty lądują w „innych" — i kupujący ich nie znajdą. BaseLinker wymaga ręcznego mapowania przy pierwszej konfiguracji. Nie pomijaj tego kroku, nawet jeśli zajmuje 2-3 godziny przy dużym katalogu.

Błąd 3: Zdjęcia produktów o złym formacie. Allegro wymaga zdjęć minimum 400×400 px bez znaków wodnych. W OpenCart często zdjęcia mają logo sklepu lub rozmiary dostosowane pod thumbnail — po przesłaniu na Allegro zostają odrzucone. Sprawdź w BaseLinker zakładkę „Produkty → Błędy" po pierwszej synchronizacji.

Błąd 4: Synchronizacja jednostronna (tylko ceny, nie stany). Częsty błąd przy konfiguracji: sklep OpenCart synchronizuje ceny na Allegro, ale nie stany magazynowe. Efekt: sprzedajesz towar, którego nie masz. BaseLinker domyślnie synchronizuje oba — upewnij się, że masz włączone oba suwaki w ustawieniach integracji Allegro.

Błąd 5: Brak obsługi wariantów produktu. OpenCart i Allegro inaczej modelują warianty (atrybuty, opcje). BaseLinker tłumaczy je automatycznie, ale wymaga konfiguracji schematu mapowania. Jeśli sprzedajesz odzież lub produkty w rozmiarach — poświęć godzinę na konfigurację mapowania wariantów zanim wystawisz pierwsze oferty. Inaczej Allegro pokaże każdy wariant jako osobną ofertę bez powiązania.

Allegro API 2026 — co zmieniło się dla OpenCart i Shopify

Allegro przeprowadziło w 2026 roku dwie istotne zmiany w swoim REST API, które bezpośrednio wpływają na integracje ze sklepami internetowymi. Jeśli Twoja integracja OpenCart lub Shopify działa na starym module — sprawdź poniżej, czy wymaga aktualizacji.

Nowe wymogi kategoryzacji i ESG od Q2 2026

Od Q2 2026 Allegro wymaga dla wybranych kategorii (elektronika, AGD, tekstylia) uzupełnienia parametrów zgodności ESG: kraj produkcji, skład materiałowy, certyfikaty środowiskowe. Oznacza to, że mapowanie kategorii w BaseLinkerze lub bezpośrednia integracja OpenCart ↔ Allegro musi uwzględniać nowe pola. Brak uzupełnienia skutkuje odrzuceniem oferty przy publikacji lub obniżeniem widoczności w kategoriach ESG-mandatory.

Jak sprawdzić, czy Twoja integracja jest gotowa: W BaseLinkerze otwórz Allegro → Mapowanie pól → sprawdź czy masz zmapowane: productParameters.esg.originCountry, productParameters.esg.materialComposition. Dla OpenCart z bezpośrednią integracją: zaktualizuj moduł do wersji min. 1.9.x (kompatybilność z Allegro REST API Q2 2026 update).

InPost One API a zmiana w integracji z Allegro

Od marca 2026 InPost migruje wszystkich użytkowników API na InPost One API (ujednolicony endpoint, OAuth2). Jeśli Twoja integracja OpenCart lub Shopify generowała etykiety InPost przez stary endpoint https://api-shipx-pl.easypack24.net — ten endpoint zostaje wygaszony do końca Q3 2026. Nowy endpoint: https://api.inpost.pl/v1.

W BaseLinkerze integracja z InPost jest zarządzana po stronie BaseLinker (aktualizują automatycznie), więc jeśli korzystasz z BaseLinker jako pośrednika — nic nie musisz robić. Problem dotyczy bezpośrednich integracji: OpenCart plugin InPost lub Shopify App z InPost.

Sprawdź wersję modułu Allegro dla OpenCart 4.x

Najczęstszy błąd przy integracji OpenCart z Allegro w 2026: próba użycia modułu dla OpenCart 3.x na OpenCart 4.x (PHP 8.1+). Moduły nie są ze sobą kompatybilne — OpenCart 4.x zmienił architekturę na MVC-L z event systemem i moduły 3.x dosłownie się nie ładują. Upewnij się, że pobierasz moduł z dedykowaną etykietą "OC4" lub "OpenCart 4.x".

Czy muszę aktualizować moduł Allegro w OpenCart po zmianach API w 2026?

Tak, jeśli Twój moduł pochodzi sprzed 2025 roku. Allegro wprowadziło w Q2 2026 obowiązkowe parametry ESG (kraj produkcji, skład materiałowy) dla kategorii elektronika, AGD i tekstylia. Stare moduły nie mają zmapowanych tych pól — oferty w tych kategoriach będą odrzucane lub tracić widoczność. Aktualizuj moduł do wersji z etykietą "OC4" i kompatybilnością z Allegro API Q2 2026.

Czy stary endpoint InPost API przestał działać?

Stary endpoint InPost (api-shipx-pl.easypack24.net) jest wygaszany do końca Q3 2026. Jeśli generujesz etykiety InPost bezpośrednio (bez BaseLinker) — musisz przejść na InPost One API (api.inpost.pl/v1) z autentykacją OAuth2. Jeśli korzystasz z BaseLinker jako pośrednika, aktualizacja jest po stronie BaseLinker i nie wymaga Twojego działania.

BaseLinker + InPost One API — konfiguracja krok po kroku dla Shopify i OpenCart (2026)

Od Q3 2026 stary endpoint ShipX (api-shipx-pl.easypack24.net) jest w trybie deprecated — InPost wymaga migracji na One API. Jeśli korzystasz z BaseLinker jako pośrednika między Shopify lub OpenCart a InPostem, musisz zaktualizować dane uwierzytelnienia w panelu BaseLinker. Oto jak to zrobić poprawnie.

Krok 1 — Generowanie tokenu One API w panelu InPost

1. Zaloguj się na manager.paczkomaty.pl (lub bussiness.inpost.pl dla klientów B2B)
2. Przejdź do: Integracje > API > Generuj token
3. Wybierz zakres uprawnień: shipments.write, shipments.read, points.read
4. Zapisz Access Token (Bearer JWT) — widoczny tylko raz po wygenerowaniu

Krok 2 — Aktualizacja integracji InPost w BaseLinker

1. W BaseLinker: Integracje > Kurierzy > InPost
2. W polu "Metoda autoryzacji" zmień z ShipX Token na One API Bearer Token
3. Wklej wygenerowany Access Token
4. Kliknij Zapisz i przetestuj połączenie — powinien zwrócić listę dostępnych punktów Paczkomat

Uwaga dla Shopify: Jeśli używasz natywnej aplikacji InPost for Shopify równolegle z BaseLinkerem, upewnij się że tokeny są oddzielne — jedno konto API może mieć wiele tokenów. Nie używaj tego samego tokenu w dwóch aplikacjach jednocześnie.

Krok 3 — OpenCart 4.x a moduł InPost po migracji One API

Wiele modułów InPost dla OpenCart 3.x nie jest kompatybilnych z OC 4.x. Przy migracji sklepu z OC 3.x na 4.x pamiętaj:

• Moduły od dostawców: InPost.pl (oficjalny) i BaseLinker Connector — oba mają wersje dla OC 4.x z obsługą One API
• Moduły third-party z marketplace OpenCart mogą nadal używać ShipX API — sprawdź changelog przed instalacją
• Nowy endpoint One API: https://api-shipx-pl.easypack24.net/v1 → https://api.inpost.pl/v1 (różne base URL!)

BaseLinker a InPost Pay — czy integracja działa automatycznie?

InPost Pay to platforma płatności i dostaw w jednym kroku, uruchomiona w Polsce w 2025 roku. W kontekście BaseLinker:

• BaseLinker nie obsługuje natywnie InPost Pay jako metody płatności — to osobna aplikacja płatnicza
• Zamówienia złożone przez InPost Pay trafiają do sklepu jak zwykłe zamówienia (WooCommerce, Shopify, PrestaShop) i są stamtąd synchronizowane do BaseLinker
• Etykieta InPost dla zamówień InPost Pay jest generowana standardowo przez One API w BaseLinker

OpenCart z Allegro przez BaseLinker — konfiguracja krok po kroku 2026

OpenCart to platforma używana przez tysiące polskich sklepów — szczególnie tych migrowanych ze starych PrestaShop 1.6 lub własnych rozwiązań. Integracja OpenCart z Allegro ma swoje specyfiki, które pomijają ogólne poradniki. Oto co wiem z projektów:

Wersje OpenCart obsługiwane przez BaseLinker: oficjalny moduł działa z OpenCart 2.3.x, 3.0.x i 4.0.x. Dla OpenCart 1.5.x — brak wsparcia. Przy starszej wersji pierwszym krokiem jest upgrade do OC 3.x lub 4.x.

5 kroków konfiguracji OpenCart → BaseLinker → Allegro

1. Instalacja modułu BaseLinker w OpenCart: Pobierz moduł z panel.baselinker.com → Integracje → Sklepy → OpenCart. Zainstaluj przez Extensions → Installer w panelu OC admin. Wygeneruj API Token w ustawieniach modułu.
2. Podłączenie w BaseLinker: Panel BL → Sklepy → Dodaj sklep → OpenCart → wklej URL sklepu + API Token. Pierwsze połączenie synchronizuje kategorie i produkty (czas: 5–30 minut przy dużym katalogu).
3. Mapowanie kategorii OpenCart → Allegro: W BL → Allegro → Mapowanie kategorii — przypisz każdą kategorię OC do odpowiednika Allegro. Allegro od Q2 2026 wymaga parametrów ESG dla kategorii elektronika, AGD i tekstylia. Bez kompletnych parametrów oferty trafiają do "Oferty wstrzymane".
4. Synchronizacja stanów dwukierunkowa: BL → Magazyn → Reguły synchronizacji → ustaw co 15 min. Przy dużym katalogu (5 000+ SKU) rozważ synchronizację per kategoria zamiast wszystkich produktów naraz.
5. Zamówienia Allegro → OpenCart: BL → Zamówienia → Automatyzacja → Reguły: "Allegro nowe zamówienie → utwórz zamówienie w OpenCart". Mapowanie: imię, adres, produkt, wariant. SKU musi być identyczne między OC i BL (wielkość liter, myślniki, spacje).

Najczęstszy problem w projektach z OpenCart: niezgodność SKU. OpenCart używa "Product Code" jako SKU, BaseLinker musi mieć identyczne kody. Jeden z klientów stracił 3 dni debugując brak synchronizacji — przyczyną były spacje na końcu kodów produktów w OC. Zawsze przed wdrożeniem robimy eksport SKU z OC i porównujemy z BL.

Aktualizacja modułu OpenCart po zmianach Allegro API Q2 2026

Allegro w Q2 2026 wprowadziło obowiązkowe parametry ESG (Environmental, Social, Governance) dla kategorii elektronika, AGD i tekstylia. Stare moduły OpenCart-Allegro (sprzed 2025) nie mają tych pól — oferty są odrzucane lub tracą widoczność. Aktualizacja: w panelu BL → Integracje → OpenCart → sprawdź wersję modułu. Moduł z etykietą OC4 i kompatybilnością "Allegro API Q2 2026" zawiera obsługę parametrów ESG.

Nowe pytania — OpenCart i Allegro przez BaseLinker

Jak zaktualizować moduł OpenCart w BaseLinker po zmianach API Allegro Q2 2026?

W panelu BaseLinker przejdź do Integracje → Sklepy → OpenCart → sprawdź wersję modułu i pobierz aktualizację. Zainstaluj przez OpenCart Extensions → Installer. Po aktualizacji uzupełnij mapowanie kategorii o parametry ESG (wymagane dla elektronika, AGD, tekstylia od Q2 2026) — bez nich oferty trafiają do "Oferty wstrzymane" na Allegro.

Czy BaseLinker obsługuje produkty z wariantami (opcjami) w OpenCart?

Tak, BaseLinker obsługuje produkty z opcjami (wariantami) w OpenCart od wersji 2.3. Konfiguracja: BL → Sklep → Produkty → zaznacz "mapuj warianty" i wskaż "Product Code" jako SKU wariantu. Na Allegro warianty trafiają jako osobne oferty lub parametry jednej oferty — zależy od ustawień reguły wystawiania w BaseLinker.

Powiązany artykuł: Jeśli prowadzisz sklep stacjonarny i szukasz systemu POS — przeczytaj porównanie modeli i kosztów: System POS dla sklepu stacjonarnego — gotowy SaaS, integracja z WooCommerce czy dedykowany? [2026]