Integracja BaseLinker z WooCommerce

Jak działa integracja WooCommerce z BaseLinkerem?

Base.com to obecna nazwa platformy znanej wcześniej jako BaseLinker. Właściciele sklepów nadal używają obu określeń. Nazwa BaseLinker występuje też w nazwie oficjalnej wtyczki WooCommerce.

BaseLinker to system do zarządzania sprzedażą online. Standardowa integracja łączy sklep z panelem Base. Pozwala pobierać zamówienia oraz obsługiwać wybrane operacje dotyczące katalogu, cen, stanów i realizacji sprzedaży. Zakres zależy od wybranego modelu magazynu, ustawień konektora oraz używanych modułów. Nie jest to automatyczna kopia całego sklepu w obie strony.

Jeżeli chcesz sprzedawać w kilku kanałach jednocześnie, np. w sklepie internetowym oraz na Allegro, Amazon i eBay, wspólny proces pomaga porządkować zamówienia z różnych platform. To odrębne integracje marketplace, które podłącza się do Base. Połączenie samego WooCommerce nie uruchamia ich za Ciebie. Przy współpracy z systemami ERP ustal również, gdzie powstaje oferta i kto aktualizuje dostępność.

Przed konfiguracją odpowiedz na trzy pytania: gdzie prowadzisz katalog produktów, który system wylicza dostępny stan oraz gdzie zespół obsługuje zamówienia. Te decyzje określają kierunki synchronizacji.

Połączenie jest szczególnie pomocne przy sprzedaży w kilku kanałach, wspólnym magazynie i powtarzalnej obsłudze przesyłek. Przy małym sklepie z jednym kanałem i prostą logistyką warto najpierw sprawdzić, czy dodatkowy system jest potrzebny.

Opis funkcji opieramy na oficjalnej dokumentacji sprawdzonej 7 października 2026 r. Przykłady konfiguracji i testów są modelowe, nie przedstawiają danych operacyjnych klientów.

Jak połączyć WooCommerce z BaseLinkerem?

WooCommerce działa jako wtyczka WordPress. Aby zintegrować WooCommerce z BaseLinkerem, potrzebujesz dostępu do panelu WordPress oraz do konta Base. Nie musisz przenosić sklepu na inną platformę e-commerce.

Przed rozpoczęciem przygotuj:

• konto Base i dostęp administratora do WooCommerce;
• informacje o wersjach WooCommerce i wtyczek oraz miejsce do sprawdzenia konfiguracji bez uruchamiania całego procesu produkcyjnego;
• uporządkowane SKU i listę wariantów, na których wykonasz pierwszy test;
• decyzję, gdzie prowadzisz katalog oraz który system jest właścicielem cen, stanów i statusów realizacji.

Oficjalna instrukcja Base dla WooCommerce obejmuje konto administratora, klucz REST API z uprawnieniami odczytu i zapisu oraz wtyczkę BaseLinker. Ogólna możliwość utworzenia klucza tylko do odczytu w WooCommerce nie oznacza, że obsługuje go ten konektor.

1. W panelu Base dodaj integrację WooCommerce. W polu adresu sklepu wpisz domenę zgodnie z instrukcją dostawcy, bez protokołu. Sklep nadal powinien korzystać z HTTPS.
2. W ustawieniach WooCommerce przejdź do sekcji zaawansowanej i REST API. Utwórz klucz dla wskazanego użytkownika administratora, z uprawnieniami odczytu i zapisu.
3. Przenieś Consumer Key i Consumer Secret do właściwych pól konfiguracji Base. Traktuj je jak dane dostępowe. Nie umieszczaj ich w publicznych instrukcjach, repozytorium ani zrzutach ekranu.
4. Zainstaluj i aktywuj oficjalną wtyczkę BaseLinker. Sprawdź wymagania wersji oraz dostępność połączenia.
5. Wybierz zakres pobierania zamówień i sposób korzystania z magazynu. Powiąż niewielką próbkę produktów, a następnie sprawdź ceny, stany i warianty.
6. Ustaw przekazywanie statusów i wybrane automatyzacje. Pełny katalog oraz operacje produkcyjne uruchom dopiero po testach.

Dokładne pola i wymagania opisuje instrukcja integracji WooCommerce w Base. Dokumentacja REST API WooCommerce wyjaśnia tworzenie kluczy i konfigurację sklepu. Etykiety ustawień mogą się zmieniać, dlatego instrukcję porównaj z wersją używaną w swoim sklepie.

Własny konektor korzystający z API Base jest osobnym projektem. Wymaga zaplanowania autoryzacji, ponowień, limitów i ochrony przed duplikatami. Nie trzeba budować go tylko po to, aby zastąpić standardowe połączenie.

Co synchronizować i w którym kierunku?

Ustal kierunek dla każdej grupy danych. Pobieranie zamówień, aktualizacja stanów, przekazywanie statusów i import katalogu to oddzielne operacje.

Base rozróżnia bezpośredni magazyn sklepu i katalog Base. Wybór modelu wpływa na to, gdzie zespół edytuje ofertę. Nie włączaj równoległych aktualizacji tych samych pól w WooCommerce, Base i ERP bez uzgodnienia ich odpowiedzialności.

Jeżeli Base przekazuje stan do sklepu, nie wyłączaj na tej podstawie wszystkich lokalnych mechanizmów magazynowych WooCommerce. Najpierw sprawdź, jak współpracują przy zamówieniu, przerwanej płatności i anulowaniu.

Produkty i stany magazynowe

SKU oraz EAN mogą pomagać w dopasowaniu produktów między systemami. Po dopasowaniu ważne są także zapisane powiązania identyfikatorów produktów i wariantów. Sama zgodność nazwy albo produktu nadrzędnego nie wystarcza.

Przed importem wykonaj kopię danych. Sprawdź produkt prosty oraz produkt z kilkoma wariantami. Każdy wariant powinien otrzymać prawidłowe powiązanie, cenę i stan. Szczególnie istotne są pozycje z innym SKU, ceną promocyjną lub zerową dostępnością.

Nie zakładaj, że opis, galerie, kategorie, atrybuty i dodatkowe pola wtyczek będą aktualizowane identycznie w obu systemach. Zakres importu oraz późniejszej aktualizacji sprawdź osobno. Szczegóły kojarzenia opisują powiązania magazynów w Base.

Przy stanach ustal, czy kanał otrzymuje stan fizyczny, dostępny po rezerwacjach czy wynik uzgodnionej reguły. Podwójne pomniejszenie jest ryzykiem nakładających się konfiguracji, a nie konieczną właściwością integracji.

Test obejmuje równoczesny zakup w dwóch kanałach, brak towaru, anulowanie i zwrot na magazyn. Porównuj wynik po zakończeniu synchronizacji, zamiast oczekiwać identycznych wartości w każdej sekundzie. Rezerwacje w Base mają własne reguły, które trzeba uzgodnić z działaniem sklepu.

Automatyzacja zamówień i wysyłka

Import zamówień przenosi zamówienia ze sklepu do panelu operacyjnego. Pobranie zamówienia do Base nie jest potwierdzeniem płatności ani nadania paczki. Zamówienie, stan płatności, status realizacji i status przewoźnika opisują różne etapy.

Zgodnie z dokumentacją Base późniejsze statusy mogą być przekazywane z Base do sklepu. Późniejsza zmiana statusu w WooCommerce nie zmienia automatycznie statusu Base. Dokumentacja statusów pomaga zaplanować mapowanie.

Checkout Blocks może tworzyć zamówienia robocze checkout-draft. Nie powinny uruchamiać faktury, etykiety ani realizacji w Base. Nie oznacza to jednak, że WooCommerce nie rezerwuje dla nich stanu. Mechanizmy rezerwacji i Hold Stock sprawdź osobno w dokumentacji statusów WooCommerce.

Automatyzacja zamówień zaczyna się od warunku, który zezwala na kolejną czynność. Przykładowo po potwierdzeniu płatności i dostępności towaru można skierować zamówienie do przygotowania. Jeżeli chcesz zautomatyzować tworzenie etykiety lub dokumentu, sprawdź warunek uruchomienia oraz zachowanie przy ponowieniu. Ten sam dokument nie powinien powstać drugi raz. Mapowanie statusów zamówień i powiadomienie klienta wymagają osobnej konfiguracji. Oszczędność czasu zależy od tego, ile ręcznych czynności zastąpi dobrze sprawdzona reguła.

Przy wysyłce ustal kolejno: metodę dostawy i punkt odbioru w zamówieniu, system tworzący przesyłkę, pobranie etykiety, tracking i komunikację statusu. Utworzenie etykiety nie dowodzi fizycznego nadania paczki.

Wybierz jedną ścieżkę, w której zespół będzie nadawać paczki i generować etykiety kurierskie. Sprawdź dane dostawy, punkt odbioru oraz wymagania usługi przewoźnika przed uruchomieniem automatyzacji.

Furgonetkę można uwzględnić w procesie bezpośrednim ze sklepu albo przez Base. Nie uruchamiaj dwóch pokrywających się ścieżek tworzenia przesyłek. Sprawdź integrację Furgonetki z Base oraz nasz poradnik Furgonetka i WooCommerce. Wybór metod w checkout opisujemy w artykule o metodach wysyłki WooCommerce.

Zwroty i dokumenty sprzedaży

Moduł RMA Base pomaga obsługiwać zwroty, reklamacje i wymiany. Zwrot produktu, aktualizacja stanu, korekta dokumentu i refundacja u operatora płatności są jednak odrębnymi czynnościami.

Przed uruchomieniem sprawdź zwrot całego zamówienia i jednej pozycji, koszt dostawy, korektę faktury oraz faktyczny zwrot pieniędzy. Ustal, kto wykonuje każdą operację i gdzie zespół potwierdza jej wynik. Dokumentacja zwrotów Base oraz refundacji WooCommerce opisuje zakres obu systemów.

W dokumentach sprzedaży uzgodnij numerację, dane podatkowe, moment wystawienia, korekty i przekazanie do używanego systemu księgowego. Samo utworzenie dokumentu w Base nie oznacza pełnej obsługi księgowości firmy. Przeczytaj dokumentację dokumentów sprzedaży.

Ile kosztuje integracja i utrzymanie?

Budżet obejmuje trzy osobne części: plan Base, konfigurację lub wdrożenie oraz późniejsze utrzymanie procesu. Do tego mogą dojść opłaty marketplace’ów, przewoźników, operatorów płatności i innych używanych systemów.

Publiczny cennik Base obejmuje darmowy plan Freemium z ograniczeniami oraz płatne warianty Business i Enterprise. W Business opłata stała i część zależna od zamówień wymagają wspólnej kalkulacji. Sprawdź aktualne progi, limity i kwoty netto w cenniku oraz kalkulatorze Base, zamiast oceniać koszt po jednej stawce.

Częstotliwość synchronizacji także zależy od planu i rodzaju operacji. Określenie „real-time” nie jest gwarancją identycznego opóźnienia wszystkich pól. Osobno sprawdź pobieranie zamówień, stany i ceny w używanym połączeniu.

Cena wdrożenia Sitefy zależy od zakresu: liczby kanałów, modelu katalogu i magazynu, jakości danych, dodatkowych integracji oraz scenariuszy testowych. Nie przedstawiamy jednej stawki obejmującej każdą konfigurację. Do wyceny potrzebny jest opis obecnego procesu i oczekiwanego rezultatu. Zakres prac nad sklepem znajdziesz w ofercie sklepów internetowych.

Co sprawdzić przed uruchomieniem?

W Sitefy zaczynamy od mapy danych, a następnie konfigurujemy wybrany zakres na środowisku testowym. To sposób prowadzenia wdrożenia, nie funkcja gwarantowana przez sam konektor.

Minimalny odbiór powinien obejmować produkt prosty i wariantowy, płatność zakończoną i przerwaną, równoczesną sprzedaż, wysyłkę kurierem i do punktu, anulowanie oraz zwrot części zamówienia. Sprawdź też zachowanie po chwilowej niedostępności systemu i ponowieniu operacji.

Przy HPOS, Checkout Blocks i dodatkowych wtyczkach testuj dokładnie wersje używane w sklepie. Nie przenoś wyniku testu czystej instalacji na inną konfigurację. Pomocna jest dokumentacja HPOS WooCommerce.

Po uruchomieniu ustal odpowiedzialność za monitoring, korekty i kontakt z dostawcami. Dla niestandardowego konektora trzeba dodatkowo zaplanować ochronę przed duplikatami, ponowienia i limity opisane w API Base.

Przykład integracji w sklepie MixImport

Dla MixImport wdrożyliśmy własny sklep WooCommerce połączony z BaseLinkerem. BaseLinker stanowi centralny element systemu sprzedaży, a sklep jest własnym kanałem działającym obok marketplace’ów.

Ten projekt pokazuje model, w którym wspólna oferta trafia do kilku kanałów. Nie oznacza to, że taki sam kierunek danych będzie właściwy dla każdego sklepu. Szczegóły zatwierdzone do publikacji znajdziesz w case study MixImport.

Jeżeli planujesz integrację, opisz kanały sprzedaży, miejsce prowadzenia katalogu, magazyn oraz obecny sposób obsługi zamówienia. Na tej podstawie można ustalić konfigurację, zakres automatyzacji i testy potrzebne przed startem.

Najczęściej zadawane pytania

Czy BaseLinker i Base.com to ten sam system?

Tak. Base.com to obecna nazwa platformy znanej wcześniej jako BaseLinker. Starsza nazwa nadal występuje w zapytaniach i nazwie oficjalnej wtyczki WooCommerce.

Czy potrzebuję wtyczki do integracji WooCommerce z Base?

Oficjalna instrukcja standardowego konektora obejmuje wtyczkę BaseLinker, klucz REST API z odczytem i zapisem oraz użytkownika administratora. Własne połączenie przez API jest odrębnym zakresem.

Czy Base synchronizuje wszystkie dane w obie strony?

Nie należy tego zakładać. Import katalogu, pobieranie zamówień oraz aktualizacje cen, stanów i statusów mają własne kierunki i ustawienia. Zakres należy potwierdzić dla używanego modelu magazynu i konektora.

Czy zmiana statusu w WooCommerce zmienia status w Base?

Nie automatycznie. Dokumentacja standardowego połączenia opisuje przekazywanie późniejszych statusów z Base do sklepu. Kierunek i mapowanie trzeba sprawdzić przed uruchomieniem procesu.

Jak często odbywa się synchronizacja?

Zależy to od planu, operacji i ustawień integracji. Osobno sprawdź harmonogram pobierania zamówień oraz aktualizacji stanów i cen. Określenie real-time nie jest wspólnym SLA wszystkich pól.

Czy oznaczenie zwrotu automatycznie zwraca pieniądze?

Nie. Obsługa zwrotu produktu, refundacja, korekta dokumentu i przyjęcie na magazyn są odrębnymi operacjami. Przepływ zależy od używanego operatora płatności i konfiguracji systemów.

Ile kosztuje wdrożenie BaseLinkera z WooCommerce?

Abonament dostawcy należy sprawdzić w aktualnym cenniku Base. Konfigurację i wdrożenie wycenia się osobno według kanałów sprzedaży, katalogu, magazynu, dodatkowych integracji i wymaganych testów.

Co sprawdzić przed uruchomieniem integracji?

Powiązania produktów i wariantów, źródła cen i stanów, rezerwacje, płatności, statusy, dane dostawy, zwroty oraz zachowanie po błędzie. Test powinien obejmować wersje WooCommerce i wtyczek używane w sklepie.