BaseLinker i WooCommerce - kompletny poradnik integracji 2026

Zanim przejdziesz do konfiguracji, upewnij się ze spelnias kilka warunków technicznych. Bez nich integracja albo nie zadziała w ogóle, albo będzie generować błędy, które trudno potem zlokalizować.

Wymagania techniczne

Do połączenia BaseLinker z WooCommerce potrzebujesz: aktywnego certyfikatu SSL (HTTPS) – REST API WooCommerce nie działa bez niego, permalinków ustawionych na dowolna opcje POZA Zwykły (Post name to bezpieczny wybór), wersji WooCommerce 3.5 lub nowszej oraz WordPressa 5.0+. Brzmi banalnie, ale zle ustawione permalinki to jeden z najczęstszych powodów błędów przy integracji. Warto też wyłączać wtyczki cache'ujace na czas konfiguracji – potrafią blokować zapytania API.

Wybór planu BaseLinker

Base, dawniej BaseLinker, oferuje plan Freemium do stu zamówień miesięcznie za darmo oraz plan Business za 279 zł miesięcznie plus 0,99 zł za każde zamówienie. Ceny sprawdzone u dostawców 28 sierpnia 2026. Jeśli dopiero zaczynasz sprzedaż wielokanalowa i obsluguesz mniej niż 100 zamówień, plan Freemium wystarczy do przetestowania integracji. Przy większej skali plan Business daje pełny dostęp do automatyzacji i zaawansowanych funkcji synchronizacji.

To oficjalnie rekomendowana metoda połączenia WooCommerce z BaseLinker. Działa bezpośrednio przez API WooCommerce, nie wymaga instalacji dodatkowych wtyczek i daje pelna kontrolę nad przesylanymi danymi.

Generowanie kluczy API w WooCommerce

W panelu WordPress przejdź do WooCommerce, następnie Ustawienia, potem zakladka Zaawansowane i kliknij REST API. Kliknij Dodaj klucz. Uzupełnij opis (np. BaseLinker), wybierz użytkownika z uprawnieniami administratora i ustaw Uprawnienia na Zapis/Odczyt (Read/Write). To kluczowe – klucz z uprawnieniami tylko do odczytu uniemożliwi BaseLinkerowi aktualizowanie stanów magazynowych i statusów zamówień. Po wygenerowaniu skopiuj od razu Klucz klienta (Consumer Key) i Tajny klucz (Consumer Secret) – wyświetlają się tylko raz.

Tworzenie integracji w panelu BaseLinker

Zaloguj się do BaseLinker, przejdź do sekcji Integracje i kliknij Dodaj sklep. Wybierz WooCommerce z listy platform. Wpisz adres URL swojego sklepu (z HTTPS), a następnie wklej wygenerowane klucze API. Kliknij Zapisz i od razu użyj opcji Przetestuj połączenie – system zweryfikuje, czy klucze działają poprawnie i czy komunikacja między platformami jest aktywna.

Testowanie połączenia

Po udanym teście połączenia sprawdź, czy BaseLinker widzi Twoje produkty i zamówienia. Przejdź do zakładki Produkty i zainicjuj pierwsza synchronizacje. Zrób też testowe zamówienie w sklepie i zweryfikuj, czy pojawia się w panelu BaseLinker w ciągu kilku minut. Ten krok pozwala wychwycić ewentualne problemy zanim zaczniesz obsługi realnych zamówień.

Alternatywa dla integracji API – wtyczka BaseLinker Connect instalowaną bezpośrednio w WordPress. Upraszcza proces połączenia i oferuje kilka dodatkowych funkcji.

Instalacja i konfiguracja wtyczki

W panelu WordPress przejdź do Wtyczki, Dodaj nowa i wyszukaj BaseLinker Connect. Zainstaluj i aktywuj wtyczkę. Po aktywacji w menu pojawi się nowa zakladka – wpisz tam klucz API BaseLinker (znajdziesz go w BaseLinker: Moje konto, API). Wtyczka automatycznie nawiaze połączenie ze sklepem i rozpocznie synchronizacje danych.

Kiedy wybrac Connect zamiast REST API

BaseLinker Connect sprawdza się lepiej, gdy masz problemy z konfiguracjia REST API (np. serwer blokuje zapytania), potrzebujesz szybszej synchronizacji (wtyczka działa na webhookach – zmiana w sklepie jest przesylana natychmiast) lub chcesz prostsza konfiguracje bez generowania kluczy. Wada jest dodatkowa wtyczka w WordPress, która może kolidować z innymi pluginami i wymaga regularnych aktualizacji.

Podstawowe połączenie to dopiero początek. BaseLinker daje najwięcej po skonfigurowaniu synchronizacji i mapowania danych między platformami.

Synchronizacja stanów magazynowych

W ustawieniach integracji włącz synchronizacje stanów magazynowych i ustaw interwał odpowiedni do skali sprzedaży – 15 minut dla mniejszych sklepów, 5 minut lub mniej dla sklepów z dużym ruchem. BaseLinker może synchronizować stany w obu kierunkach: ze sklepu do BaseLinker i z BaseLinker do sklepu. Przy sprzedaży wielokanałowej (np. Allegro + WooCommerce) ustaw BaseLinker jako jedyne źródło prawdy dla stanów magazynowych – unikniesz w ten sposób konfliktu danych i ryzyka podwójnej sprzedaży tego samego produktu.

Mapowanie statusów zamówień

Domyślne statusy zamówień w WooCommerce (W trakcie realizacji, Zrealizowane, Anulowane) nie zawsze odpowiadają procesom w BaseLinker. W sekcji Mapowanie statusów możesz określać, który status WooCommerce odpowiada któremu statusowi w BaseLinker. To kluczowe dla poprawnego działania automatycznych akcji – np. automatycznej wysyłki e-maila po zmianie statusu na Wysłane.

Nawet przy starannej konfiguracji mogą wystąpić błędy. Oto trzy najczęściej spotykane sytuacje i sprawdzone sposoby ich rozwiązania.

Błąd połączenia – nieprawidłowy klucz API

Jeśli po wpisaniu kluczy API widzisz błąd połączenia, sprawdź trzy rzeczy: czy skopiowałeś obie wartości (Consumer Key i Consumer Secret) bez dodatkowych spacji, czy uprawnienia ustawione sa na Zapis/Odczyt (nie tylko Odczyt) i czy adres sklepu w BaseLinker zgadza się z faktycznym adresem URL (z www lub bez www – to robi roznice). Więcej o rozwiązywaniu problemów z BaseLinker znajdziesz w dedykowanym poradniku.

Zamówienia nie przychodzą do BaseLinker

Przejdź do Integracje, wybierz swój sklep WooCommerce i kliknij Przetestuj połączenie. Jeśli test przechodzi pomyslnie, problem może leżeć w filtrach zamówień – BaseLinker domyślnie pobiera zamówienia od momentu utworzenia integracji, nie wstecz. Sprawdź też, czy wtyczka bezpieczeństwa (Wordfence, Sucuri) nie blokuje zapytań przychodzących z IP serwerów BaseLinker.

Samodzielna konfiguracja jest bezpłatna - płacisz jedynie za abonament: 0 zł w planie Freemium do stu zamówień, a wyżej 279 zł plus 0,99 zł od zamówienia w planie Business. Profesjonalne wdrożenie przez agencje e-commerce, włącznie z mapowaniem statusów, konfiguracjia automatyzacji i testami na żywo, kosztuje od 500 do 2000 zł w zależności od złożoności i liczby kanałów sprzedaży. Czas podstawowej konfiguracji to 15--30 minut przy samodzielnej pracy. Zaawansowane wdrożenie z wieloma marketplace'ami i kurierami może zająć cały dzień roboczy. Jeśli wolisz powierzyć integracje doświadczonym specjalistom, napisz do nas – przeprowadzimy cały proces od konfiguracji kluczy API po testy zamówień na żywo.

Skala różnic między dostawcami bywa większa niż między funkcjami. Według cennika Base plan Business to 279 zł opłaty stałej plus 0,99 zł od każdego zamówienia. Dane z cennika Sellasista dają za próg pięciuset zamówień 189 zł, a według cennika Apilo jest to 199 zł netto. Ceny sprawdzone u dostawców 28 sierpnia 2026.

Wdrazylem Baselinker w kilkudziesięciu sklepach WooCommerce i widzę powtarzający się błąd – ludzie zaczynają od synchronizacji zamówień, zamiast od poprawnego mapowania statusów. To potem generuje chaos w magazynie i na allegro. Zacznij od mapy statusów, przetestuj na 10 zamówieniach, dopiero potem włączaj pelna synchronizację. Jeśli potrzebujesz pomocy – napisz do nas.

Taką integrację możemy wdrożyć za Ciebie od A do Z – cennik wdrożenia BaseLinker + WooCommerce zaczyna się od 2 999 zł, razem z testami synchronizacji.