BaseLinker WooCommerce – jak podłączyć sklep WooCommerce do Base
Łukasz Palej
Łukasz Palej
Technical Implementation Expert
BaseLinker WooCommerce – jak podłączyć sklep WooCommerce do Base
BaseLinker WooCommerce to połączenie, którego szukają właściciele sklepów na WordPressie, gdy obok sklepu pojawia się Allegro, Amazon czy Empik. Sam WooCommerce świetnie sprzedaje, ale każdy kolejny kanał, kurier i program do faktur to zwykle osobna wtyczka, osobna licencja i kolejne ryzyko konfliktu po aktualizacji. Base (dawniej BaseLinker) przejmuje tę warstwę operacyjną: pobiera zamówienia ze sklepu, synchronizuje stany i ceny oraz pozwala wystawiać produkty WooCommerce na marketplace’ach z jednego panelu.
W tym poradniku przechodzimy przez całe wdrożenie: co przygotować przed podłączeniem, jak wygenerować klucze REST API, po co instalować wtyczkę Base, jak ustawić zamówienia i synchronizację oraz jak naprawić najczęstsze błędy połączenia. Opisy kroków opieramy na aktualnej pomocy Base i dokumentacji WooCommerce (stan na październik 2026 r.), a uwagi praktyczne – na wdrożeniach, które prowadzimy u klientów.
Co daje integracja BaseLinker z WooCommerce
Po podłączeniu sklep staje się w Base jednym z magazynów i jednym ze źródeł zamówień. Według pomocy Base integracja ze sklepem internetowym pozwala na kilka niezależnych rzeczy – możesz włączyć wszystkie albo tylko te, których potrzebujesz:
wystawianie produktów ze sklepu na marketplace’y – magazyn WooCommerce jest widoczny przy wystawianiu ofert, bez konieczności kopiowania produktów do Base,
pobieranie zamówień ze sklepu do Managera Zamówień, gdzie obsługujesz je razem z zamówieniami z Allegro czy Amazona,
przekazywanie zamówień z marketplace’ów do sklepu – jeśli wolisz zostać przy obsłudze w panelu WooCommerce,
synchronizację stanów i cen między sklepem, katalogiem Base i ofertami na marketplace’ach,
powiązanie statusów zamówień, płatności i numerów przesyłek, tak aby klient sklepu widział postęp realizacji,
eksport produktów z Base do WooCommerce przez API – przydatny, gdy katalog prowadzisz centralnie w Base.
Integracja jest dostępna w każdym planie, także w darmowym Freemium. Różnica dotyczy skali i tempa: według cennika Base plan Freemium obejmuje do 100 zamówień miesięcznie i do 1 000 produktów, a zamówienia, stany i ceny synchronizuje co godzinę. Plan Business synchronizuje dane w czasie rzeczywistym. Szczegóły progów i opłat opisaliśmy w tekście BaseLinker cennik 2026, a ogólne wprowadzenie do systemu znajdziesz w artykule czym jest Base – integracje i cena.
Funkcja | Kierunek danych | Na co uważać |
Pobieranie zamówień | WooCommerce → Base | Domyślnie co 10 minut, ręcznie w każdej chwili |
Przekazywanie zamówień | Base → WooCommerce | Tylko zamówienia potwierdzone, do jednego wybranego sklepu |
Statusy zamówień | Base → WooCommerce | Synchronizacja działa tylko w tę stronę |
Stany i ceny | W obie strony (do wyboru) | Jedno źródło prawdy, produkty muszą być powiązane |
Wystawianie na marketplace’y | WooCommerce → marketplace | Dane produktu pobierane „w locie” ze sklepu |
Eksport produktów | Base → WooCommerce | Przy wariantach zaznacz tylko produkt główny |
Zanim podłączysz WooCommerce do Base – przygotowanie sklepu
Samo połączenie zajmuje kilka minut. Dłużej trwa sprzątanie po źle przemyślanym starcie, dlatego zanim wkleisz pierwszy klucz, sprawdź kilka rzeczy po stronie sklepu i podejmij jedną ważną decyzję.
Konto administratora w WordPressie – klucze API i wszystkie ustawienia generujesz na profilu z uprawnieniami administratora. Tylko wtedy widzisz też ustawienia bezpośrednich odnośników.
Włączone bezpośrednie odnośniki (permalinki) – REST API WooCommerce działa najpewniej, gdy adresy mają strukturę z „wp-json”, a nie „rest_route”.
Uporządkowane SKU i EAN – to po nich najłatwiej powiązać produkty sklepu z katalogiem Base i ofertami. Zduplikowane SKU to częste źródło późniejszych błędów w stanach.
Lista wtyczek, które robią to samo – jeśli sklep ma już moduł pobierający zamówienia z Allegro do WooCommerce, po uruchomieniu Base trzeba go wyłączyć, inaczej zamówienia będą się dublować.
Kopia zapasowa bazy sklepu – zanim włączysz synchronizację stanów lub eksport produktów z Base do sklepu, zabezpiecz dane.
[#wazne] Najważniejsza decyzja przed startem: gdzie jest nadrzędny katalog produktów i stanów. Albo zarządzasz produktami w WooCommerce, a Base tylko z nich korzysta, albo prowadzisz katalog w Base i wysyłasz stany oraz ceny do sklepu. Mieszanie obu modeli dla tych samych produktów kończy się nadpisywaniem danych.
Jak podłączyć sklep WooCommerce do Base krok po kroku
Poniższe kroki odpowiadają instrukcji z pomocy Base dla integracji WooCommerce. Nazwy zakładek po stronie WordPressa mogą się nieznacznie różnić w zależności od wersji i języka panelu.
1. Dodaj integrację WooCommerce w panelu Base
W Base przejdź do zakładki Integracje → Dodaj integrację i wybierz WooCommerce. Uzupełnij nazwę wyświetlaną – dowolną, ale nie dłuższą niż 15 znaków (np. „Sklep WWW”). W polu adres sklepu wpisz samą domenę, bez „http://” ani „https://”. To częsta przyczyna nieudanych pierwszych połączeń.
2. Wygeneruj klucze REST API w WooCommerce
Zaloguj się do WordPressa i przejdź do WooCommerce → Ustawienia → Zaawansowane → REST API → Dodaj klucz. W opisie wpisz np. „Base”, jako użytkownika wybierz profil administratora, a w polu uprawnień ustaw Odczyt/Zapis. Po zapisaniu formularza WooCommerce wygeneruje parę kluczy: Consumer Key i Consumer Secret. Skopiuj je od razu – sekret jest pokazywany tylko raz.
3. Wklej klucze i zapisz połączenie w Base
Wróć do okna integracji w Base, wklej oba klucze i kliknij Zapisz. Jeśli połączenie się nie uda, nie twórz od razu nowej integracji – najpierw sprawdź adres sklepu, uprawnienia klucza i permalinki (opisujemy to niżej w sekcji o błędach).
4. Zainstaluj oficjalną wtyczkę Base w WordPressie
Base zaleca instalację swojej wtyczki, aby m.in. dane o zamówieniach były prawidłowo przekazywane do systemu. Wtyczka jest dostępna w oficjalnym katalogu WordPressa jako „Base (formerly BaseLinker)” – znajdziesz ją pod adresem wordpress.org/plugins/baselinker-woo. Instalujesz ją jak każdą inną wtyczkę: w sekcji Wtyczki wyszukaj „Base”, kliknij Zainstaluj, a potem Włącz.
Wykres – cztery kroki podłączenia WooCommerce do Base: integracja w panelu, klucze REST API, zapis połączenia i wtyczka Base. [#chart:b18c]
BaseLinker WooCommerce to połączenie, którego szukają właściciele sklepów na WordPressie, gdy obok sklepu pojawia się Allegro, Amazon czy Empik. Sam WooCommerce świetnie sprzedaje, ale każdy kolejny kanał, kurier i program do faktur to zwykle osobna wtyczka, osobna licencja i kolejne ryzyko konfliktu po aktualizacji. Base (dawniej BaseLinker) przejmuje tę warstwę operacyjną: pobiera zamówienia ze sklepu, synchronizuje stany i ceny oraz pozwala wystawiać produkty WooCommerce na marketplace’ach z jednego panelu.
W tym poradniku przechodzimy przez całe wdrożenie: co przygotować przed podłączeniem, jak wygenerować klucze REST API, po co instalować wtyczkę Base, jak ustawić zamówienia i synchronizację oraz jak naprawić najczęstsze błędy połączenia. Opisy kroków opieramy na aktualnej pomocy Base i dokumentacji WooCommerce (stan na październik 2026 r.), a uwagi praktyczne – na wdrożeniach, które prowadzimy u klientów.
Co daje integracja BaseLinker z WooCommerce
Po podłączeniu sklep staje się w Base jednym z magazynów i jednym ze źródeł zamówień. Według pomocy Base integracja ze sklepem internetowym pozwala na kilka niezależnych rzeczy – możesz włączyć wszystkie albo tylko te, których potrzebujesz:
wystawianie produktów ze sklepu na marketplace’y – magazyn WooCommerce jest widoczny przy wystawianiu ofert, bez konieczności kopiowania produktów do Base,
pobieranie zamówień ze sklepu do Managera Zamówień, gdzie obsługujesz je razem z zamówieniami z Allegro czy Amazona,
przekazywanie zamówień z marketplace’ów do sklepu – jeśli wolisz zostać przy obsłudze w panelu WooCommerce,
synchronizację stanów i cen między sklepem, katalogiem Base i ofertami na marketplace’ach,
powiązanie statusów zamówień, płatności i numerów przesyłek, tak aby klient sklepu widział postęp realizacji,
eksport produktów z Base do WooCommerce przez API – przydatny, gdy katalog prowadzisz centralnie w Base.
Integracja jest dostępna w każdym planie, także w darmowym Freemium. Różnica dotyczy skali i tempa: według cennika Base plan Freemium obejmuje do 100 zamówień miesięcznie i do 1 000 produktów, a zamówienia, stany i ceny synchronizuje co godzinę. Plan Business synchronizuje dane w czasie rzeczywistym. Szczegóły progów i opłat opisaliśmy w tekście BaseLinker cennik 2026, a ogólne wprowadzenie do systemu znajdziesz w artykule czym jest Base – integracje i cena.
Funkcja | Kierunek danych | Na co uważać |
Pobieranie zamówień | WooCommerce → Base | Domyślnie co 10 minut, ręcznie w każdej chwili |
Przekazywanie zamówień | Base → WooCommerce | Tylko zamówienia potwierdzone, do jednego wybranego sklepu |
Statusy zamówień | Base → WooCommerce | Synchronizacja działa tylko w tę stronę |
Stany i ceny | W obie strony (do wyboru) | Jedno źródło prawdy, produkty muszą być powiązane |
Wystawianie na marketplace’y | WooCommerce → marketplace | Dane produktu pobierane „w locie” ze sklepu |
Eksport produktów | Base → WooCommerce | Przy wariantach zaznacz tylko produkt główny |
Zanim podłączysz WooCommerce do Base – przygotowanie sklepu
Samo połączenie zajmuje kilka minut. Dłużej trwa sprzątanie po źle przemyślanym starcie, dlatego zanim wkleisz pierwszy klucz, sprawdź kilka rzeczy po stronie sklepu i podejmij jedną ważną decyzję.
Konto administratora w WordPressie – klucze API i wszystkie ustawienia generujesz na profilu z uprawnieniami administratora. Tylko wtedy widzisz też ustawienia bezpośrednich odnośników.
Włączone bezpośrednie odnośniki (permalinki) – REST API WooCommerce działa najpewniej, gdy adresy mają strukturę z „wp-json”, a nie „rest_route”.
Uporządkowane SKU i EAN – to po nich najłatwiej powiązać produkty sklepu z katalogiem Base i ofertami. Zduplikowane SKU to częste źródło późniejszych błędów w stanach.
Lista wtyczek, które robią to samo – jeśli sklep ma już moduł pobierający zamówienia z Allegro do WooCommerce, po uruchomieniu Base trzeba go wyłączyć, inaczej zamówienia będą się dublować.
Kopia zapasowa bazy sklepu – zanim włączysz synchronizację stanów lub eksport produktów z Base do sklepu, zabezpiecz dane.
[#wazne] Najważniejsza decyzja przed startem: gdzie jest nadrzędny katalog produktów i stanów. Albo zarządzasz produktami w WooCommerce, a Base tylko z nich korzysta, albo prowadzisz katalog w Base i wysyłasz stany oraz ceny do sklepu. Mieszanie obu modeli dla tych samych produktów kończy się nadpisywaniem danych.
Jak podłączyć sklep WooCommerce do Base krok po kroku
Poniższe kroki odpowiadają instrukcji z pomocy Base dla integracji WooCommerce. Nazwy zakładek po stronie WordPressa mogą się nieznacznie różnić w zależności od wersji i języka panelu.
1. Dodaj integrację WooCommerce w panelu Base
W Base przejdź do zakładki Integracje → Dodaj integrację i wybierz WooCommerce. Uzupełnij nazwę wyświetlaną – dowolną, ale nie dłuższą niż 15 znaków (np. „Sklep WWW”). W polu adres sklepu wpisz samą domenę, bez „http://” ani „https://”. To częsta przyczyna nieudanych pierwszych połączeń.
2. Wygeneruj klucze REST API w WooCommerce
Zaloguj się do WordPressa i przejdź do WooCommerce → Ustawienia → Zaawansowane → REST API → Dodaj klucz. W opisie wpisz np. „Base”, jako użytkownika wybierz profil administratora, a w polu uprawnień ustaw Odczyt/Zapis. Po zapisaniu formularza WooCommerce wygeneruje parę kluczy: Consumer Key i Consumer Secret. Skopiuj je od razu – sekret jest pokazywany tylko raz.
3. Wklej klucze i zapisz połączenie w Base
Wróć do okna integracji w Base, wklej oba klucze i kliknij Zapisz. Jeśli połączenie się nie uda, nie twórz od razu nowej integracji – najpierw sprawdź adres sklepu, uprawnienia klucza i permalinki (opisujemy to niżej w sekcji o błędach).
4. Zainstaluj oficjalną wtyczkę Base w WordPressie
Base zaleca instalację swojej wtyczki, aby m.in. dane o zamówieniach były prawidłowo przekazywane do systemu. Wtyczka jest dostępna w oficjalnym katalogu WordPressa jako „Base (formerly BaseLinker)” – znajdziesz ją pod adresem wordpress.org/plugins/baselinker-woo. Instalujesz ją jak każdą inną wtyczkę: w sekcji Wtyczki wyszukaj „Base”, kliknij Zainstaluj, a potem Włącz.
Wykres – cztery kroki podłączenia WooCommerce do Base: integracja w panelu, klucze REST API, zapis połączenia i wtyczka Base. [#chart:b18c]
- Analiza procesów, integracji i obiegu zamówień
- Plan automatyzacji: magazyn, wysyłki, faktury
- Do tego 30 dni darmowego testu Base
Wtyczka Base dla WooCommerce – co zmienia w działaniu integracji
Połączenie przez REST API działa bez wtyczki, ale to wtyczka uzupełnia je o dane, których standardowe API WooCommerce nie przekazuje albo przekazuje wolno. Według opisu w katalogu WordPressa wtyczka Base m.in.:
obsługuje numery zamówień inne niż standardowe ID wpisu (przydatne, gdy sklep ma własną numerację),
dołącza do zamówień metadane wysyłki i przekazuje do sklepu numer paczkomatu przy wtyczce Flexible Shipping,
importuje dodatkowe metody dostawy zdefiniowane we Flexible Shipping,
znacznie przyspiesza pobieranie listy produktów i drzewa kategorii,
dołącza dane wariantów do produktu nadrzędnego, co zmniejsza liczbę zapytań do API,
pozwala wyszukiwać produkty po nazwie i EAN oraz filtrować je po zakresie stanów,
jest zgodna z WPML, czyli z wielojęzycznymi sklepami.
Po każdej większej aktualizacji WooCommerce lub WordPressa zajrzyj, czy wtyczka Base też ma nową wersję. Większość „nagłych” problemów z pobieraniem danych o dostawie czy wariantach znika po aktualizacji wtyczki i ponownym pobraniu zamówień ręcznie.
Zamówienia z WooCommerce w Base – pobieranie i przekazywanie
Ustawienia zamówień znajdziesz w Integracje → WooCommerce → Ustawienia → Zamówienia. Masz tu dwie niezależne opcje: pobieranie zamówień ze sklepu do Base oraz dodawanie do sklepu zamówień z innych kanałów. Obie mogą działać jednocześnie – Base nie pobiera ponownie zamówień, które sam przekazał do sklepu, więc nie powstają duplikaty.
Przy włączaniu pobierania wybierasz status, do którego mają trafiać nowe zamówienia ze sklepu. Warto od razu przygotować osobny status, np. „Nowe – sklep”, i dopiero z niego przenosić zamówienia dalej akcjami automatycznymi. Jak zaprojektować taki proces, pokazujemy w artykule o statusach zamówień w BaseLinkerze.
Co się dzieje | Kiedy (wg pomocy Base) |
Pobieranie zamówień ze sklepu | Domyślnie co 10 minut, opcjonalnie co minutę |
Pierwsze pobranie po włączeniu | W ciągu godziny pojawiają się zamówienia z ostatnich 24 godzin |
Ręczne pobranie | W każdej chwili, sprawdza ostatnie 24 godziny |
Status zamówienia do sklepu | Co godzinę |
Status płatności do sklepu | Co 4 godziny |
Numer nadania do sklepu | Od razu po nadaniu paczki (lub kilka razy dziennie przy wariancie „po zmianie statusu”) |
Pamiętaj o dwóch ograniczeniach. Po pierwsze, statusy synchronizują się tylko w kierunku Base → sklep – zmiana statusu w WooCommerce nie wróci do Base. Po drugie, po przekazaniu zamówienia do sklepu synchronizowane są już tylko status, płatność i numer nadania. Jeśli w Base dodasz produkt do zamówienia, w sklepie trzeba to poprawić osobno.
Statusy łączysz w Ustawienia → Statusy → Powiązanie statusów: po lewej masz statusy Base, po prawej statusy pobrane z WooCommerce. W tej samej sekcji włączysz przekazywanie informacji o opłaceniu, a w zakładce Wysyłki – powiązanie metod dostawy i przekazywanie numerów przesyłek. Gdy chcesz od razu nadawać paczki z Base, zajrzyj do poradnika kurierzy w BaseLinkerze.
[#uwaga] Jeśli w WooCommerce działa wtyczka pobierająca zamówienia bezpośrednio z Allegro, wyłącz ją przed włączeniem integracji Allegro w Base. Inaczej każde zamówienie pojawi się dwa razy, a zamówienie, które przeszło przez sklep, Base potraktuje jak zamówienie ze sklepu – bez możliwości nadania przesyłki w ramach programu Allegro.
Synchronizacja stanów i cen – BaseLinker czy WooCommerce jako źródło prawdy
Kierunek i częstotliwość synchronizacji ustawiasz w Integracje → WooCommerce → Ceny/Stany. Base pozwala synchronizować dane w obie strony, ale dla danego produktu powinno być jedno miejsce, w którym zmieniasz stan i cenę. Warunek konieczny: produkty w katalogu Base muszą być powiązane z produktami w sklepie, inaczej synchronizacja nie ma czego aktualizować.
Wykres – kiedy wybrać WooCommerce, a kiedy Base jako nadrzędny katalog stanów i cen. [#chart:b18d]
Model | Jak działa | Dla kogo |
WooCommerce nadrzędny | Produkty i stany prowadzisz w sklepie, Base wystawia z magazynu sklepu i aktualizuje oferty marketplace | Jeden sklep, mały katalog, start z marketplace’ami |
Base nadrzędny | Katalog i stany w Base, sklep dostaje stany i ceny z Base jak każdy inny kanał | Kilka kanałów, magazyn, dostawy, WMS, hurtownie |
Model mieszany | Część danych ze sklepu, część z Base – tylko przy jasnym podziale pól | Raczej przejściowo, w trakcie migracji |
W modelu z Base jako katalogiem nadrzędnym produkty importujesz do katalogu przez Produkty → Import/Eksport → Import produktów z zewnętrznego magazynu. Przy imporcie wybierasz, czy ceny i stany pobrać jednorazowo, cyklicznie ze sklepu, czy odwrotnie – wysyłać je z Base do sklepu. Przed dużym importem pomoc Base zaleca wykonanie kopii katalogu (eksport do domyślnego XML).
[#przyklad] Sklep z odzieżą sprzedaje w WooCommerce i na Allegro. Ostatnia sztuka bluzy w rozmiarze M schodzi na Allegro. Gdy Base jest nadrzędny i stany idą z Base do sklepu, stan w WooCommerce spada do zera przy najbliższej synchronizacji. W planie Business dzieje się to w czasie rzeczywistym, w planie Freemium – w cyklu godzinowym, więc przy szybko rotującym towarze okno na podwójną sprzedaż jest wyraźnie dłuższe.
Szerzej o mechanizmie rezerwacji, progach i typowych pułapkach piszemy w artykule synchronizacja stanów w BaseLinkerze, a o łączeniu ofert z produktami – w tekście powiązanie ofert z produktami w BaseLinkerze.
Wystawianie produktów WooCommerce na Allegro i inne marketplace’y
Magazyn sklepu jest widoczny w module danego marketplace’u w zakładce Wystawianie. Base pobiera dane „w locie” z bazy sklepu: nazwę, opis, zdjęcia, cenę, stan, EAN, SKU i parametry. Nie musisz więc najpierw importować produktów do katalogu Base, żeby wystawić je na Allegro – to wygodny start dla sklepów, które dopiero testują marketplace.
Przed wystawieniem warto skorzystać z ustawień integracji sklepu: filtr nazwy pozwala globalnie dopisać do tytułów np. markę, a filtr opisu – usunąć lub zamienić fragmenty, których nie chcesz przenosić na marketplace. Ceny możesz przeliczać mnożnikiem w ustawieniach konta marketplace, np. aby uwzględnić prowizję. Opis sklepu rzadko da się odtworzyć jeden do jednego, bo Allegro nie przyjmuje dowolnego HTML-u – dlatego zwykle lepiej przygotować osobny szablon oferty.
Jak dobrać kategorie, parametry i szablony, pokazujemy w poradniku wystawianie ofert z BaseLinkera na Allegro. Jeśli zastanawiasz się, czy do połączenia sklepu z Allegro wystarczy wtyczka, porównanie rozwiązań znajdziesz w artykule integracja WooCommerce z Allegro.
Działa to też w drugą stronę. Jeśli katalog prowadzisz w Base, produkty dodasz do WooCommerce przez Operacje → Utwórz produkty w sklepie internetowym – WooCommerce należy do platform, dla których eksport odbywa się przez API. Przy produktach z wariantami zaznacz wyłącznie produkt główny; zaznaczenie wariantów utworzy w sklepie osobne produkty zamiast jednego z wariantami.
Najczęstsze błędy integracji BaseLinker WooCommerce i jak je naprawić
Większość problemów z połączeniem ma kilka powtarzalnych przyczyn. Zanim napiszesz do supportu, przejdź przez tę listę.
Objaw | Najczęstsza przyczyna | Co zrobić |
Błąd przy zapisie połączenia | Adres z „https://” lub klucz tylko do odczytu | Wpisz samą domenę, wygeneruj klucz z uprawnieniem Odczyt/Zapis |
API zwraca błąd, w źródle strony jest „rest_route” | Wyłączone bezpośrednie odnośniki | Ustawienia → Bezpośrednie odnośniki: wybierz strukturę inną niż prosta, zapisz |
Produkty ze sklepu nie wyświetlają się przy wystawianiu | Firewall lub Cloudflare blokuje serwery Base | Dodaj do białej listy adresy IP podane w pomocy Base, sprawdź tryb ochrony |
Zamówienia z Allegro pojawiają się podwójnie | Druga wtyczka pobiera Allegro do sklepu | Zostaw jedno źródło zamówień Allegro – Base |
Brak paczkomatu lub metody dostawy w zamówieniu | Brak wtyczki Base albo stara wersja | Zainstaluj lub zaktualizuj wtyczkę, pobierz zamówienia ponownie |
Stany w ofertach się nie zmieniają | Brak powiązania produktów albo wyłączona synchronizacja | Powiąż produkty, sprawdź kierunek i interwał w Ceny/Stany |
Pomoc Base wymienia konkretne adresy IP serwerów, które nie mogą być blokowane – aktualną listę sprawdź w artykule o integracji magazynu sklepu, bo może się zmieniać. Gdy połączenie działa, ale zamówienia nie spływają, skorzystaj z naszej listy kontrolnej, gdy BaseLinker nie pobiera zamówień.
[#checklista] Domena bez protokołu; klucz REST API z uprawnieniem Odczyt/Zapis na koncie administratora; permalinki inne niż „prosty”; aktualna wtyczka Base; wyłączone dublujące się wtyczki Allegro; ustalony nadrzędny katalog; powiązane produkty; status startowy dla zamówień ze sklepu; testowe zamówienie przeprowadzone od złożenia do wysyłki.
Po uruchomieniu integracji największe oszczędności czasu dają automatyzacje: zmiana statusu po opłaceniu, faktura, etykieta i wiadomość do klienta. Gotowe scenariusze znajdziesz w tekście akcje automatyczne w BaseLinkerze – 15 przykładów.
Najczęściej zadawane pytania
Czy integracja BaseLinker z WooCommerce jest płatna?
Integracja ze sklepem WooCommerce jest wliczona w abonament Base, także w darmowy plan Freemium. Płacisz za sam abonament, który zależy od liczby zamówień – aktualne stawki netto sprawdź w cenniku Base przed wdrożeniem.
Czy muszę instalować wtyczkę Base w WordPressie?
Połączenie zestawisz samymi kluczami REST API, ale Base zaleca instalację swojej wtyczki, aby dane o zamówieniach były przekazywane prawidłowo. Wtyczka dodaje m.in. obsługę numeracji zamówień, danych paczkomatów z Flexible Shipping i przyspiesza pobieranie produktów.
Jak często Base pobiera zamówienia z WooCommerce?
Domyślnie co 10 minut, a w ustawieniach można wybrać pobieranie co minutę. Zamówienia możesz też pobrać ręcznie w tabeli integracji. W planie Freemium synchronizacja zamówień, stanów i cen odbywa się według cennika co godzinę.
Czy mogę podłączyć kilka sklepów WooCommerce do jednego konta Base?
Tak, do Base możesz podłączyć dowolną liczbę sklepów internetowych. Pamiętaj tylko, że zamówienia z marketplace’ów da się przekazywać do jednego wybranego sklepu, a Base nie synchronizuje magazynów sklepów bezpośrednio między sobą – do tego potrzebny jest wspólny katalog w Base.
Czy zmiana statusu w WooCommerce zaktualizuje zamówienie w Base?
Nie. Synchronizacja statusów działa tylko w kierunku z Base do sklepu. Dlatego przy obsłudze zamówień w Base najlepiej zmieniać statusy wyłącznie tam, a w WooCommerce traktować je jako informację dla klienta.
Dlaczego po połączeniu nie widzę produktów ze sklepu?
Najczęściej serwer sklepu lub Cloudflare blokuje zapytania z serwerów Base albo REST API nie działa przez wyłączone permalinki. Sprawdź białą listę adresów IP z pomocy Base, tryb ochrony i to, czy adres API zawiera „wp-json”.
Podsumowanie
Połączenie BaseLinker WooCommerce to cztery kroki: integracja w panelu Base, klucze REST API z uprawnieniem zapisu, zapis połączenia i wtyczka Base w WordPressie. O tym, czy integracja będzie działać bez niespodzianek, decyduje jednak to, co dzieje się później: wybór nadrzędnego katalogu, powiązanie produktów, statusy i wyłączenie dublujących się wtyczek.
Jeśli chcesz przejść przez wdrożenie bez metody prób i błędów, pomożemy jako certyfikowany partner wdrożeń Base – od konfiguracji WooCommerce i marketplace’ów po automatyzacje i wysyłki. Sprawdź, jak wygląda wdrożenie Base z Vinson Agency.
Wtyczka Base dla WooCommerce – co zmienia w działaniu integracji
Połączenie przez REST API działa bez wtyczki, ale to wtyczka uzupełnia je o dane, których standardowe API WooCommerce nie przekazuje albo przekazuje wolno. Według opisu w katalogu WordPressa wtyczka Base m.in.:
obsługuje numery zamówień inne niż standardowe ID wpisu (przydatne, gdy sklep ma własną numerację),
dołącza do zamówień metadane wysyłki i przekazuje do sklepu numer paczkomatu przy wtyczce Flexible Shipping,
importuje dodatkowe metody dostawy zdefiniowane we Flexible Shipping,
znacznie przyspiesza pobieranie listy produktów i drzewa kategorii,
dołącza dane wariantów do produktu nadrzędnego, co zmniejsza liczbę zapytań do API,
pozwala wyszukiwać produkty po nazwie i EAN oraz filtrować je po zakresie stanów,
jest zgodna z WPML, czyli z wielojęzycznymi sklepami.
Po każdej większej aktualizacji WooCommerce lub WordPressa zajrzyj, czy wtyczka Base też ma nową wersję. Większość „nagłych” problemów z pobieraniem danych o dostawie czy wariantach znika po aktualizacji wtyczki i ponownym pobraniu zamówień ręcznie.
Zamówienia z WooCommerce w Base – pobieranie i przekazywanie
Ustawienia zamówień znajdziesz w Integracje → WooCommerce → Ustawienia → Zamówienia. Masz tu dwie niezależne opcje: pobieranie zamówień ze sklepu do Base oraz dodawanie do sklepu zamówień z innych kanałów. Obie mogą działać jednocześnie – Base nie pobiera ponownie zamówień, które sam przekazał do sklepu, więc nie powstają duplikaty.
Przy włączaniu pobierania wybierasz status, do którego mają trafiać nowe zamówienia ze sklepu. Warto od razu przygotować osobny status, np. „Nowe – sklep”, i dopiero z niego przenosić zamówienia dalej akcjami automatycznymi. Jak zaprojektować taki proces, pokazujemy w artykule o statusach zamówień w BaseLinkerze.
Co się dzieje | Kiedy (wg pomocy Base) |
Pobieranie zamówień ze sklepu | Domyślnie co 10 minut, opcjonalnie co minutę |
Pierwsze pobranie po włączeniu | W ciągu godziny pojawiają się zamówienia z ostatnich 24 godzin |
Ręczne pobranie | W każdej chwili, sprawdza ostatnie 24 godziny |
Status zamówienia do sklepu | Co godzinę |
Status płatności do sklepu | Co 4 godziny |
Numer nadania do sklepu | Od razu po nadaniu paczki (lub kilka razy dziennie przy wariancie „po zmianie statusu”) |
Pamiętaj o dwóch ograniczeniach. Po pierwsze, statusy synchronizują się tylko w kierunku Base → sklep – zmiana statusu w WooCommerce nie wróci do Base. Po drugie, po przekazaniu zamówienia do sklepu synchronizowane są już tylko status, płatność i numer nadania. Jeśli w Base dodasz produkt do zamówienia, w sklepie trzeba to poprawić osobno.
Statusy łączysz w Ustawienia → Statusy → Powiązanie statusów: po lewej masz statusy Base, po prawej statusy pobrane z WooCommerce. W tej samej sekcji włączysz przekazywanie informacji o opłaceniu, a w zakładce Wysyłki – powiązanie metod dostawy i przekazywanie numerów przesyłek. Gdy chcesz od razu nadawać paczki z Base, zajrzyj do poradnika kurierzy w BaseLinkerze.
[#uwaga] Jeśli w WooCommerce działa wtyczka pobierająca zamówienia bezpośrednio z Allegro, wyłącz ją przed włączeniem integracji Allegro w Base. Inaczej każde zamówienie pojawi się dwa razy, a zamówienie, które przeszło przez sklep, Base potraktuje jak zamówienie ze sklepu – bez możliwości nadania przesyłki w ramach programu Allegro.
Synchronizacja stanów i cen – BaseLinker czy WooCommerce jako źródło prawdy
Kierunek i częstotliwość synchronizacji ustawiasz w Integracje → WooCommerce → Ceny/Stany. Base pozwala synchronizować dane w obie strony, ale dla danego produktu powinno być jedno miejsce, w którym zmieniasz stan i cenę. Warunek konieczny: produkty w katalogu Base muszą być powiązane z produktami w sklepie, inaczej synchronizacja nie ma czego aktualizować.
Wykres – kiedy wybrać WooCommerce, a kiedy Base jako nadrzędny katalog stanów i cen. [#chart:b18d]
Model | Jak działa | Dla kogo |
WooCommerce nadrzędny | Produkty i stany prowadzisz w sklepie, Base wystawia z magazynu sklepu i aktualizuje oferty marketplace | Jeden sklep, mały katalog, start z marketplace’ami |
Base nadrzędny | Katalog i stany w Base, sklep dostaje stany i ceny z Base jak każdy inny kanał | Kilka kanałów, magazyn, dostawy, WMS, hurtownie |
Model mieszany | Część danych ze sklepu, część z Base – tylko przy jasnym podziale pól | Raczej przejściowo, w trakcie migracji |
W modelu z Base jako katalogiem nadrzędnym produkty importujesz do katalogu przez Produkty → Import/Eksport → Import produktów z zewnętrznego magazynu. Przy imporcie wybierasz, czy ceny i stany pobrać jednorazowo, cyklicznie ze sklepu, czy odwrotnie – wysyłać je z Base do sklepu. Przed dużym importem pomoc Base zaleca wykonanie kopii katalogu (eksport do domyślnego XML).
[#przyklad] Sklep z odzieżą sprzedaje w WooCommerce i na Allegro. Ostatnia sztuka bluzy w rozmiarze M schodzi na Allegro. Gdy Base jest nadrzędny i stany idą z Base do sklepu, stan w WooCommerce spada do zera przy najbliższej synchronizacji. W planie Business dzieje się to w czasie rzeczywistym, w planie Freemium – w cyklu godzinowym, więc przy szybko rotującym towarze okno na podwójną sprzedaż jest wyraźnie dłuższe.
Szerzej o mechanizmie rezerwacji, progach i typowych pułapkach piszemy w artykule synchronizacja stanów w BaseLinkerze, a o łączeniu ofert z produktami – w tekście powiązanie ofert z produktami w BaseLinkerze.
Wystawianie produktów WooCommerce na Allegro i inne marketplace’y
Magazyn sklepu jest widoczny w module danego marketplace’u w zakładce Wystawianie. Base pobiera dane „w locie” z bazy sklepu: nazwę, opis, zdjęcia, cenę, stan, EAN, SKU i parametry. Nie musisz więc najpierw importować produktów do katalogu Base, żeby wystawić je na Allegro – to wygodny start dla sklepów, które dopiero testują marketplace.
Przed wystawieniem warto skorzystać z ustawień integracji sklepu: filtr nazwy pozwala globalnie dopisać do tytułów np. markę, a filtr opisu – usunąć lub zamienić fragmenty, których nie chcesz przenosić na marketplace. Ceny możesz przeliczać mnożnikiem w ustawieniach konta marketplace, np. aby uwzględnić prowizję. Opis sklepu rzadko da się odtworzyć jeden do jednego, bo Allegro nie przyjmuje dowolnego HTML-u – dlatego zwykle lepiej przygotować osobny szablon oferty.
Jak dobrać kategorie, parametry i szablony, pokazujemy w poradniku wystawianie ofert z BaseLinkera na Allegro. Jeśli zastanawiasz się, czy do połączenia sklepu z Allegro wystarczy wtyczka, porównanie rozwiązań znajdziesz w artykule integracja WooCommerce z Allegro.
Działa to też w drugą stronę. Jeśli katalog prowadzisz w Base, produkty dodasz do WooCommerce przez Operacje → Utwórz produkty w sklepie internetowym – WooCommerce należy do platform, dla których eksport odbywa się przez API. Przy produktach z wariantami zaznacz wyłącznie produkt główny; zaznaczenie wariantów utworzy w sklepie osobne produkty zamiast jednego z wariantami.
Najczęstsze błędy integracji BaseLinker WooCommerce i jak je naprawić
Większość problemów z połączeniem ma kilka powtarzalnych przyczyn. Zanim napiszesz do supportu, przejdź przez tę listę.
Objaw | Najczęstsza przyczyna | Co zrobić |
Błąd przy zapisie połączenia | Adres z „https://” lub klucz tylko do odczytu | Wpisz samą domenę, wygeneruj klucz z uprawnieniem Odczyt/Zapis |
API zwraca błąd, w źródle strony jest „rest_route” | Wyłączone bezpośrednie odnośniki | Ustawienia → Bezpośrednie odnośniki: wybierz strukturę inną niż prosta, zapisz |
Produkty ze sklepu nie wyświetlają się przy wystawianiu | Firewall lub Cloudflare blokuje serwery Base | Dodaj do białej listy adresy IP podane w pomocy Base, sprawdź tryb ochrony |
Zamówienia z Allegro pojawiają się podwójnie | Druga wtyczka pobiera Allegro do sklepu | Zostaw jedno źródło zamówień Allegro – Base |
Brak paczkomatu lub metody dostawy w zamówieniu | Brak wtyczki Base albo stara wersja | Zainstaluj lub zaktualizuj wtyczkę, pobierz zamówienia ponownie |
Stany w ofertach się nie zmieniają | Brak powiązania produktów albo wyłączona synchronizacja | Powiąż produkty, sprawdź kierunek i interwał w Ceny/Stany |
Pomoc Base wymienia konkretne adresy IP serwerów, które nie mogą być blokowane – aktualną listę sprawdź w artykule o integracji magazynu sklepu, bo może się zmieniać. Gdy połączenie działa, ale zamówienia nie spływają, skorzystaj z naszej listy kontrolnej, gdy BaseLinker nie pobiera zamówień.
[#checklista] Domena bez protokołu; klucz REST API z uprawnieniem Odczyt/Zapis na koncie administratora; permalinki inne niż „prosty”; aktualna wtyczka Base; wyłączone dublujące się wtyczki Allegro; ustalony nadrzędny katalog; powiązane produkty; status startowy dla zamówień ze sklepu; testowe zamówienie przeprowadzone od złożenia do wysyłki.
Po uruchomieniu integracji największe oszczędności czasu dają automatyzacje: zmiana statusu po opłaceniu, faktura, etykieta i wiadomość do klienta. Gotowe scenariusze znajdziesz w tekście akcje automatyczne w BaseLinkerze – 15 przykładów.
Najczęściej zadawane pytania
Czy integracja BaseLinker z WooCommerce jest płatna?
Integracja ze sklepem WooCommerce jest wliczona w abonament Base, także w darmowy plan Freemium. Płacisz za sam abonament, który zależy od liczby zamówień – aktualne stawki netto sprawdź w cenniku Base przed wdrożeniem.
Czy muszę instalować wtyczkę Base w WordPressie?
Połączenie zestawisz samymi kluczami REST API, ale Base zaleca instalację swojej wtyczki, aby dane o zamówieniach były przekazywane prawidłowo. Wtyczka dodaje m.in. obsługę numeracji zamówień, danych paczkomatów z Flexible Shipping i przyspiesza pobieranie produktów.
Jak często Base pobiera zamówienia z WooCommerce?
Domyślnie co 10 minut, a w ustawieniach można wybrać pobieranie co minutę. Zamówienia możesz też pobrać ręcznie w tabeli integracji. W planie Freemium synchronizacja zamówień, stanów i cen odbywa się według cennika co godzinę.
Czy mogę podłączyć kilka sklepów WooCommerce do jednego konta Base?
Tak, do Base możesz podłączyć dowolną liczbę sklepów internetowych. Pamiętaj tylko, że zamówienia z marketplace’ów da się przekazywać do jednego wybranego sklepu, a Base nie synchronizuje magazynów sklepów bezpośrednio między sobą – do tego potrzebny jest wspólny katalog w Base.
Czy zmiana statusu w WooCommerce zaktualizuje zamówienie w Base?
Nie. Synchronizacja statusów działa tylko w kierunku z Base do sklepu. Dlatego przy obsłudze zamówień w Base najlepiej zmieniać statusy wyłącznie tam, a w WooCommerce traktować je jako informację dla klienta.
Dlaczego po połączeniu nie widzę produktów ze sklepu?
Najczęściej serwer sklepu lub Cloudflare blokuje zapytania z serwerów Base albo REST API nie działa przez wyłączone permalinki. Sprawdź białą listę adresów IP z pomocy Base, tryb ochrony i to, czy adres API zawiera „wp-json”.
Podsumowanie
Połączenie BaseLinker WooCommerce to cztery kroki: integracja w panelu Base, klucze REST API z uprawnieniem zapisu, zapis połączenia i wtyczka Base w WordPressie. O tym, czy integracja będzie działać bez niespodzianek, decyduje jednak to, co dzieje się później: wybór nadrzędnego katalogu, powiązanie produktów, statusy i wyłączenie dublujących się wtyczek.
Jeśli chcesz przejść przez wdrożenie bez metody prób i błędów, pomożemy jako certyfikowany partner wdrożeń Base – od konfiguracji WooCommerce i marketplace’ów po automatyzacje i wysyłki. Sprawdź, jak wygląda wdrożenie Base z Vinson Agency.
Łukasz Palej
Technical Implementation Expert
Wdraża integracje i rozwiązania IT dla e-commerce: sklepy, feedy produktowe, przepływ danych między systemami.
Wdraża integracje i rozwiązania IT dla e-commerce: sklepy, feedy produktowe, przepływ danych między systemami.
Wdrożenie Base
Łukasz i nasz zespół pomogą Ci wdrożyć to na Twoim koncie – bez zobowiązań.
- Analiza Twojego konta i obecnych działań
- Konkretny plan poprawek do wdrożenia
- Bezpłatna konsultacja – bez zobowiązań
Przeczytaj także
Więcej porad z naszej bazy wiedzy – przesuń, aby zobaczyć kolejne artykuły.
Masz pytania? Chętnie porozmawiamy!
Masz pytania? Chętnie porozmawiamy!
Masz pytania? Chętnie porozmawiamy!
Bartłomiej Stokłosa
CEO & Founder
"Jeżeli czegoś nie da się zrobić, potrzebny jest ktoś, kto o tym nie wie – przyjdzie i to zrobi."
Bartłomiej Stokłosa
CEO & Founder
"Jeżeli czegoś nie da się zrobić, potrzebny jest ktoś, kto o tym nie wie – przyjdzie i to zrobi."