Lead: Jeśli WooCommerce działa, BaseLinker jest podłączony, a mimo to zamówienia nie pojawiają się po stronie integratora, problem zwykle nie leży w jednym miejscu. W praktyce najczęściej winna jest błędna autoryzacja API, źle ustawione filtry pobierania, brak webhooków, niekompatybilna wtyczka, ograniczenia hostingu albo po prostu zamówienia trafiają do statusu, którego BaseLinker nie ma pobierać. Dobra wiadomość jest taka, że w większości przypadków da się to naprawić bez przepisywania sklepu i bez rewolucji w konfiguracji. Trzeba jednak podejść do tematu metodycznie, bo „na oko” taki problem często wygląda podobnie, a przyczyny bywają bardzo różne.
Szybka odpowiedź
Jeśli BaseLinker nie pobiera zamówień z WooCommerce, zacznij od czterech rzeczy: sprawdź, czy integracja API jest aktywna i poprawnie autoryzowana, czy zamówienia mają status pobierany przez BaseLinker, czy webhooki lub synchronizacja zwrotna nie są zablokowane przez cache/firewall oraz czy żadna inna wtyczka nie przechwytuje żądań REST API. W praktyce w wielu sklepach problem rozwiązuje się po ponownym wygenerowaniu kluczy API, odświeżeniu połączenia, wyczyszczeniu cache i zmianie ustawień pobierania statusów. Jeśli integracja działała wcześniej, a przestała po aktualizacji WordPressa, WooCommerce lub motywu, bardzo możliwy jest konflikt po aktualizacji albo zmiana reguł bezpieczeństwa na hostingu.
Diagnoza problemu
Warto najpierw ustalić, co dokładnie oznacza „BaseLinker nie pobiera zamówień”. Ten objaw może mieć kilka wariantów:
- nowe zamówienia w ogóle nie pojawiają się w BaseLinkerze,
- pojawiają się tylko niektóre zamówienia,
- zamówienia wchodzą z opóźnieniem,
- przychodzą tylko zamówienia ze specyficznym statusem,
- BaseLinker widzi sklep, ale nie widzi nowych pozycji,
- import działał wcześniej i nagle przestał działać po zmianach w sklepie.
Te różnice są kluczowe, bo wskazują, gdzie szukać przyczyny. Jeżeli nie wpadają żadne zamówienia, najpierw patrzymy na połączenie API, uprawnienia, adres endpointu i blokady serwera. Jeśli wpadają tylko część zamówień, przyczyną często jest filtr statusu, waluta, metoda płatności, kraj dostawy albo reguła automatyzacji w BaseLinkerze. Jeśli zamówienia pojawiają się z opóźnieniem, problemem bywa cron, cache, kolejka po stronie hostingu lub chwilowa niedostępność WordPress REST API.
W praktyce najczęstszy błąd polega na założeniu, że skoro integracja „jest podłączona”, to musi działać poprawnie. Tymczasem w WooCommerce i BaseLinkerze połączenie może istnieć, ale dane nie będą przepływać z powodu jednego małego ograniczenia: zablokowanego endpointu, wygasłego tokena, źle ustawionych statusów lub nieobsługiwanego sposobu autoryzacji po aktualizacji.
Możliwe przyczyny
Poniżej znajdziesz najczęstsze powody, dla których WooCommerce BaseLinker nie pobiera zamówień. Warto sprawdzać je po kolei, bo część z nich nakłada się na siebie.
1. Błędna lub wygasła autoryzacja API
Połączenie między WooCommerce a BaseLinkerem opiera się zwykle na kluczu API, tokenie lub dedykowanej integracji. Jeżeli dane zostały wygenerowane ponownie, zmieniono hasło administratora, wyczyszczono ustawienia wtyczki albo migracja przeniosła sklep na inny adres, integracja może wyglądać na aktywną, ale faktycznie nie mieć dostępu do zamówień.
2. Złe statusy zamówień w filtrach pobierania
BaseLinker bardzo często pobiera tylko zamówienia o określonym statusie, na przykład „oczekuje na płatność”, „w trakcie realizacji” albo statusy skonfigurowane ręcznie. Jeżeli nowe zamówienia wpadają do statusu, którego integrator nie śledzi, będą w sklepie widoczne, ale nie trafią do BaseLinkera.
3. REST API lub webhooki zablokowane przez wtyczkę bezpieczeństwa
Wiele sklepów ma zainstalowane wtyczki typu security, firewall, anti-spam lub anty-bot. Część z nich potrafi blokować żądania do REST API, chronić endpointy albo uznawać ruch BaseLinkera za podejrzany. Efekt jest taki, że połączenie teoretycznie działa, ale żądania pobierania zamówień są odrzucane lub przycinane.
4. Konflikt z cache, optymalizacją lub CDN
Cache strony, cache obiektowy, narzędzia do optymalizacji JS/CSS, a nawet CDN mogą powodować, że integracja nie widzi świeżych danych. Szczególnie wrażliwe są wdrożenia, gdzie REST API jest objęte regułami cache lub gdzie serwer zwraca nieaktualne odpowiedzi przez warstwę pośrednią.
5. Zmiany po aktualizacji WooCommerce, WordPressa lub wtyczki BaseLinker
Po aktualizacji mogły zmienić się nazwy endpointów, sposób autoryzacji lub kompatybilność z konkretną wersją PHP. Czasem wystarczy, że wtyczka integracyjna nie była aktualizowana równolegle i pojawia się problem z pobieraniem danych.
6. Limity serwera lub zbyt wolne odpowiedzi
Jeśli hosting ma ograniczenia CPU, pamięci, timeoutów lub agresywnie kończy długie połączenia, integracja może nie dokończyć pobierania zamówień. Dotyczy to zwłaszcza sklepów z dużym ruchem, wielu wtyczek i ciężkimi motywami.
7. Niepoprawna konfiguracja BaseLinkera
BaseLinker może mieć ustawione filtry pobierania, reguły mapowania statusów, ograniczenia według sklepu, magazynu, kanału sprzedaży albo harmonogram synchronizacji. Jeżeli jedna z tych opcji jest ustawiona nieintuicyjnie, system będzie działał „po swojemu”, a nie tak, jak oczekuje właściciel sklepu.
8. Problem z zamówieniami testowymi lub nietypowym checkoutem
Zamówienia tworzone przez testowe bramki płatności, szybkie płatności, niestandardowy checkout lub checkout blocks mogą być obsługiwane inaczej niż klasyczne zamówienia. Jeżeli integracja była budowana pod starszy układ WooCommerce, może nie rozpoznawać nowych mechanizmów lub pól.
9. Błędy w samej bazie danych lub kolejce zadań
Uszkodzone wpisy w bazie, niedokończone zadania cron, błędy kolejki Action Scheduler albo duża liczba zaległych operacji potrafią „zagłuszyć” synchronizację. Wtedy zamówienia są w sklepie, ale integracja nie ma kiedy ich przetworzyć lub nie kończy procesu importu.
Rozwiązanie krok po kroku
Poniższy plan jest ułożony tak, abyś mógł przejść od najprostszych testów do bardziej zaawansowanych. Warto wykonywać kolejne kroki po kolei i po każdym sprawdzać, czy nowe zamówienia pojawiają się w BaseLinkerze.
Krok 1: Potwierdź, że problem dotyczy nowych zamówień, a nie tylko starszych
Zrób nowe testowe zamówienie i sprawdź, czy po jego złożeniu pojawia się w BaseLinkerze. Nie opieraj się wyłącznie na starych zamówieniach, bo część integracji synchronizuje tylko nowe dane od momentu aktywacji albo od ostatniej poprawnej synchronizacji.
Krok 2: Sprawdź status zamówienia w WooCommerce
Wejdź w ustawienia integracji i zobacz, które statusy są pobierane. Następnie sprawdź, jaki status ma konkretne zamówienie w sklepie. Jeśli status nie jest objęty pobieraniem, zmień ustawienie lub przetestuj zamówienie w statusie, który na pewno powinien zostać pobrany. To jeden z najczęstszych i najbardziej niedocenianych błędów.
Krok 3: Zweryfikuj połączenie API
Jeśli korzystasz z dedykowanego klucza API WooCommerce, sprawdź, czy jest aktywny, poprawny i ma wystarczające uprawnienia do odczytu zamówień. W razie wątpliwości wygeneruj nowe dane dostępu i podłącz integrację od nowa. Uwaga: przed tym krokiem zrób kopię zapasową konfiguracji oraz zanotuj bieżące ustawienia, aby nie utracić mapowania.
Krok 4: Sprawdź logi błędów i komunikaty integracji
W WooCommerce, w wtyczce BaseLinker i na hostingu szukaj komunikatów o błędach 401, 403, 404, 500, timeoutach, braku uprawnień lub nieudanym połączeniu z REST API. Kody 401 i 403 zwykle oznaczają problem z autoryzacją lub blokadą. Kody 404 mogą wskazywać na zły adres endpointu albo zmianę struktury URL. Błędy 500 i timeouty sugerują problem po stronie serwera lub konflikt wtyczek.
Krok 5: Wyłącz na próbę wtyczki bezpieczeństwa i cache
Jeśli masz Wordfence, iThemes Security, LiteSpeed Cache, WP Rocket, Cloudflare lub podobne narzędzia, wyłącz je tymczasowo albo zrób wyjątki dla endpointów API. Po każdej zmianie odśwież testowy checkout. Wiele problemów z integracją znika po wyłączeniu optymalizacji dla REST API i wykluczeniu sklepu z agresywnego cache.
Krok 6: Sprawdź, czy REST API działa poprawnie
Upewnij się, że WordPress REST API nie jest blokowane przez serwer, wtyczkę lub reguły .htaccess. Jeżeli panel lub integracja pokazuje błędy przy odpytywaniu zamówień, spróbuj wykonać prosty test endpointu. Jeśli odpowiedź jest blokowana, to nawet poprawny BaseLinker nie pobierze zamówień.
Krok 7: Oceń działanie cronów i kolejki zadań
Jeśli synchronizacja działa cyklicznie, sprawdź, czy WP-Cron nie jest wyłączony albo czy nie został zastąpiony źle skonfigurowanym cronem systemowym. W sklepach o dużym ruchu zalegające zadania mogą opóźniać pobieranie zamówień lub zatrzymywać je całkowicie. Warto przejrzeć także Action Scheduler, bo to on często obsługuje zadania WooCommerce w tle.
Krok 8: Przetestuj bez konfliktowych wtyczek
Najbardziej czasochłonny, ale skuteczny test to uruchomienie środowiska z minimalnym zestawem wtyczek. Jeśli w trybie testowym BaseLinker zaczyna pobierać zamówienia, znaczy to, że winny jest konflikt z jedną z aktywnych wtyczek. Wtedy aktywuj je po kolei i sprawdzaj, w którym momencie synchronizacja przestaje działać.
Krok 9: Sprawdź mapowanie i reguły w BaseLinkerze
Jeśli zamówienia trafiają tylko częściowo, zweryfikuj filtry w samym BaseLinkerze. Upewnij się, że sklep jest właściwie przypisany, synchronizacja jest aktywna, nie ma ukrytych ograniczeń według kraju, statusu lub kanału sprzedaży, a mapowanie pól nie odrzuca części rekordów. Czasem problem nie polega na pobieraniu, tylko na tym, że zamówienie trafia, ale nie jest widoczne w oczekiwanym miejscu.
Krok 10: Wyczyść cache i wymuś ponowną synchronizację
Po zmianach koniecznie wyczyść cache strony, cache serwera, cache wtyczki i, jeśli używasz CDN, również jego pamięć podręczną. Następnie wykonaj ponowny test zamówienia. Bez tego możesz sprawdzać stare dane i dojść do fałszywego wniosku, że problem nadal występuje.
Krok 11: Zaktualizuj komponenty, ale ostrożnie
Jeżeli masz stare wersje WooCommerce, WordPressa, PHP albo samej wtyczki integracyjnej, zaktualizuj je do wersji wspieranych przez producenta. Aktualizacje wykonuj jednak po backupie i najlepiej najpierw na kopii stagingowej. Bezpieczniej jest zaktualizować jeden komponent naraz niż wszystko jednocześnie.
Krok 12: Jeśli to konieczne, odtwórz integrację od nowa
Gdy wszystkie wcześniejsze kroki nie pomogły, czasem najprostsze rozwiązanie to pełne usunięcie starego połączenia i skonfigurowanie go od nowa. Dotyczy to zwłaszcza sytuacji po migracji sklepu, zmianie domeny, przeniesieniu certyfikatu SSL lub większej przebudowie WordPressa. Przed odpięciem integracji upewnij się jednak, że nie utracisz historii synchronizacji lub ustawień mapowania.
Ważne ostrzeżenie bezpieczeństwa: nie usuwaj hurtowo ustawień, wpisów integracji ani rekordów z bazy danych bez kopii zapasowej. W przypadku błędu możesz nie tylko utracić połączenie z BaseLinkerem, ale również nadpisać mapowanie zamówień i produktów. Przy sklepach produkcyjnych zawsze warto mieć backup oraz możliwość cofnięcia zmian.
Najczęstsze błędy
- sprawdzanie tylko starego zamówienia zamiast wykonania nowego testu,
- założenie, że problem leży po stronie BaseLinkera, bez weryfikacji WooCommerce i hostingu,
- ignorowanie statusów zamówień i filtrów pobierania,
- wyłączenie wtyczek bezpieczeństwa bez ponownego sprawdzenia, czy nie blokują REST API,
- czyszczenie cache bez sprawdzenia, czy problem nie wynika z autoryzacji,
- masowe aktualizacje wszystkiego naraz bez kopii zapasowej,
- ręczne grzebanie w bazie danych bez wiedzy o zależnościach WooCommerce,
- pomijanie logów błędów, które często wskazują problem wprost,
- testowanie na produkcji w godzinach największej sprzedaży,
- zmienianie kilku ustawień jednocześnie, przez co trudno ustalić, co faktycznie zadziałało.
Kiedy nie robić tego samodzielnie
Nie warto działać samodzielnie, jeśli sklep generuje wysoką sprzedaż, integracja obsługuje zamówienia w trybie ciągłym, a każda minuta opóźnienia oznacza realną stratę. Samodzielne eksperymenty są też ryzykowne, gdy problem pojawił się po migracji, aktualizacji lub zmianie hostingu, bo wtedy łatwo pogłębić usterkę.
Ostrożność jest szczególnie wskazana, jeśli:
- nie masz kopii zapasowej przed zmianami,
- nie wiesz, która wtyczka odpowiada za integrację,
- na sklepie działają równolegle rozbudowane reguły bezpieczeństwa i cache,
- pojawiają się błędy 500, 403 lub fatal errors,
- zamówienia są krytyczne biznesowo, na przykład w modelu B2B lub z automatycznym fulfillmentem,
- integracja obsługuje wiele źródeł sprzedaży i jeden błąd może zablokować cały przepływ danych.
W takiej sytuacji zbyt agresywne próby naprawy mogą spowodować utratę danych, duplikację zamówień albo rozjazd statusów między systemami.
Kiedy zgłosić się do specjalisty
Do specjalisty warto zgłosić się wtedy, gdy podstawowe testy nie przynoszą efektu albo gdy problem wykracza poza prostą konfigurację. Pomoc eksperta jest rozsądna zwłaszcza wtedy, gdy integracja przestała działać po aktualizacji systemu, po migracji serwera, po wdrożeniu nowej wtyczki bezpieczeństwa lub gdy sklep ma nietypową architekturę.
Specjalista będzie potrzebny, jeśli:
- potrzebujesz szybkiej diagnozy bez ryzyka przestoju w sprzedaży,
- masz wiele sklepów lub wiele źródeł synchronizacji,
- logi wskazują na problem z serwerem, timeoutami albo konfliktem na poziomie PHP,
- wtyczka integracyjna nie ma jasnego wsparcia dla Twojej wersji WooCommerce,
- potrzebna jest analiza REST API, cronów, bezpieczeństwa i cache jednocześnie,
- chcesz naprawić problem bez ruszania innych działających procesów w sklepie.
W praktyce dobrze przeprowadzona diagnoza oszczędza czas, ogranicza ryzyko i często ujawnia problem, którego nie widać w panelu administracyjnym. W integracjach WooCommerce–BaseLinker bardzo często winny jest jeden szczegół techniczny, ale znalezienie go bez doświadczenia bywa czasochłonne.
Podsumowanie i CTA do kontaktu
Jeśli WooCommerce BaseLinker nie pobiera zamówień, nie zakładaj od razu, że trzeba wymieniać wtyczkę albo przebudowywać sklep. Najczęściej problem da się zlokalizować w jednym z kilku obszarów: autoryzacji, statusach zamówień, blokadach API, cache, konfliktach wtyczek, cronach lub limicie serwera. Najważniejsze jest spokojne przejście przez diagnostykę: nowy test zamówienia, sprawdzenie logów, weryfikacja statusów, test bez cache i bezpieczeństwa oraz ocena działania REST API.
Jeżeli chcesz uniknąć przestoju w sprzedaży, nie ryzykować utraty danych i szybko wrócić do poprawnej synchronizacji, skontaktuj się ze specjalistą. Dobrze przeprowadzona analiza pozwala naprawić problem bez zgadywania i bez niepotrzebnych zmian w sklepie. Jeśli BaseLinker nie pobiera zamówień z WooCommerce, pomoc techniczna może skrócić diagnozę z godzin do minut i przywrócić poprawny przepływ zamówień zanim wpłynie to na klientów.
FAQ
- Czy BaseLinker może nie pobierać tylko części zamówień?
- Tak. Najczęściej odpowiadają za to filtry statusów, warunki w BaseLinkerze, reguły płatności, kraj dostawy albo konflikt z automatyzacją.
- Czy problem może być po stronie WooCommerce, nawet jeśli BaseLinker działa poprawnie?
- Tak. WooCommerce może blokować REST API, generować błędne statusy lub nie kończyć zadań cron, przez co dane nie są przekazywane dalej.
- Czy wyczyszczenie cache może pomóc?
- Tak, ale tylko wtedy, gdy cache rzeczywiście blokuje świeże dane lub endpointy API. Nie rozwiąże to problemu autoryzacji ani błędnych filtrów.
- Czy po aktualizacji WooCommerce integracja może przestać działać?
- Tak. Aktualizacja może zmienić kompatybilność, sposób działania endpointów lub wywołać konflikt z inną wtyczką.
- Czy warto od razu przeinstalować wtyczkę?
- Nie od razu. Najpierw sprawdź statusy, API, logi, cache i konflikty. Reinstalacja bez diagnozy może nie rozwiązać przyczyny i utrudnić analizę.
