Sklepy internetowe Problem i rozwiązanie
BaseLinker nie pobiera zamówień z WooCommerce - przyczyny i naprawa krok po kroku
W skrócie
- Objaw: nowe zamówienia są w WooCommerce, ale nie pojawiają się w BaseLinkerze (dziś Base) albo pojawiają się z dużym opóźnieniem, przez co magazyn nie pakuje paczek, a stany w innych kanałach się nie zmieniają.
- Przyczyna: najczęściej Base nie może połączyć się z REST API sklepu: klucze usunięte lub tylko do odczytu, blokada przez wtyczkę bezpieczeństwa, zaporę lub CDN, zwykłe bezpośrednie odnośniki albo nieaktualna wtyczka integracyjna.
- Rozwiązanie: sprawdź połączenie w ustawieniach integracji, klucze REST API z uprawnieniami do odczytu i zapisu, wtyczkę Base, odnośniki i reguły zapory, a po naprawie dociągnij zamówienia z okresu przerwy i ustaw powiadomienie o błędach.
Nie masz czasu? Zrobimy to za Ciebie - Sklepy internetowe od 3 500 zł netto
BaseLinker (dziś Base) najczęściej nie pobiera zamówień z WooCommerce, bo nie może połączyć się z REST API sklepu: klucze API zostały usunięte albo mają tylko uprawnienie do odczytu, wtyczka bezpieczeństwa, zapora lub CDN blokują zapytania, bezpośrednie odnośniki są ustawione na zwykłe albo wtyczka integracyjna jest nieaktualna. Rzadziej pobieranie zamówień jest po prostu wyłączone w ustawieniach integracji albo przerwa trwała na tyle długo, że część zamówień nie dociągnęła się sama.
Jak wygląda problem?
Zamówienie jest w panelu WooCommerce, klient dostał potwierdzenie, a w Base go nie ma. Magazyn pracuje na liście z Base, więc paczka czeka, aż ktoś zauważy różnicę.
- w Base nie ma zamówień od określonej godziny albo dnia,
- zamówienia pojawiają się w Base z opóźnieniem dłuższym niż zwykle,
- w ustawieniach integracji widać błąd połączenia albo autoryzacji,
- statusy i numery przesyłek z Base nie wracają do sklepu,
- problem zaczął się po aktualizacji, zmianie hostingu, domeny albo instalacji wtyczki bezpieczeństwa.
Jak działa pobieranie zamówień z WooCommerce do Base?
Base łączy się ze sklepem przez REST API WooCommerce, korzystając z kluczy wygenerowanych w ustawieniach sklepu, a dodatkowo wymaga oficjalnej wtyczki Base z katalogu WordPress.org, która według pomocy Base odpowiada za prawidłowe przekazywanie danych o zamówieniach. Klucze muszą być przypisane do konta administratora i mieć uprawnienia do odczytu i zapisu.
Zamówienia ze sklepu są domyślnie pobierane co 10 minut, a w ustawieniach integracji (Pobierane dane) można pobrać je ręcznie w każdej chwili. Według pomocy Base po włączeniu pobierania do systemu trafiają zamówienia z ostatnich 24 godzin. To ważne po dłuższej przerwie: starsze zamówienia mogą nie pojawić się same i trzeba je sprawdzić ręcznie.
Dlaczego BaseLinker nie pobiera zamówień?
Prawie zawsze dlatego, że zapytanie z Base nie dociera do sklepu albo sklep odrzuca je jako nieautoryzowane. Każdą z przyczyn da się sprawdzić w kilka minut.
Klucze REST API usunięte albo z niewłaściwymi uprawnieniami
Klucze generuje się w WooCommerce, Ustawienia, Zaawansowane, REST API. Jeśli ktoś usunął klucz przy porządkach, zmienił uprawnienie na tylko odczyt albo konto, do którego klucz był przypisany, straciło rolę administratora, połączenie przestaje działać. Na liście kluczy widać datę ostatniego dostępu, która pokazuje, kiedy Base ostatni raz się połączył.
Wtyczka bezpieczeństwa, zapora lub CDN blokuje zapytania
Wtyczki bezpieczeństwa potrafią wyłączać REST API dla zapytań z zewnątrz albo blokować adresy, które wykonują wiele zapytań. To samo robią reguły zapory na serwerze i ochrona przed botami w CDN. Base łączy się ze sklepem automatycznie, więc dla takich reguł wygląda jak bot. Sprawdź logi zapory i wtyczki bezpieczeństwa z czasu, w którym zamówienia przestały spływać.
Serwer obcina nagłówek autoryzacji
Dokumentacja REST API WooCommerce opisuje sytuację, w której serwer nie przekazuje poprawnie nagłówka Authorization. Objawem jest błąd o brakującym kluczu (Consumer key is missing) mimo poprawnych kluczy. Najczęściej pojawia się po zmianie serwera lub konfiguracji PHP i wymaga poprawki po stronie hostingu.
Zwykłe bezpośrednie odnośniki
REST API WooCommerce wymaga bezpośrednich odnośników innych niż zwykłe (Ustawienia, Bezpośrednie odnośniki). Pomoc Base podpowiada prosty test: jeśli w źródle strony zamiast adresu z wp-json widzisz parametr rest_route, API trzeba włączyć zgodnie z dokumentacją WooCommerce.
Nieaktualna lub wyłączona wtyczka Base
Po aktualizacji WooCommerce albo przy porządkach we wtyczkach wtyczka Base bywa wyłączona lub zostaje w starej wersji. Sprawdź, czy jest aktywna i aktualna, i czy po aktualizacji sklepu nie pojawiły się błędy w logach PHP.
Zmiana domeny, protokołu albo przeniesienie sklepu
Po migracji, przejściu na https albo zmianie domeny integracja nadal łączy się ze starym adresem. Adres sklepu wpisuje się w Base bez protokołu, a po przenosinach trzeba go zaktualizować i sprawdzić, czy przekierowania nie przerywają zapytań API. Przy migracji uważaj też na zdublowane integracje, które pobierają zamówienia jednocześnie ze starego i nowego sklepu.
| Objaw | Najczęstsza przyczyna | Gdzie sprawdzić |
|---|---|---|
| Błąd autoryzacji w Base | Klucz usunięty, tylko do odczytu albo przypisany do konta bez roli administratora | WooCommerce, Ustawienia, Zaawansowane, REST API |
| Błąd o brakującym kluczu mimo poprawnych danych | Serwer obcina nagłówek Authorization | Konfiguracja serwera, pomoc techniczna hostingu |
| Błąd połączenia lub kod 403 | Wtyczka bezpieczeństwa, zapora, ochrona przed botami w CDN | Logi zapory i wtyczki bezpieczeństwa |
| Błąd 404 dla adresów API | Zwykłe bezpośrednie odnośniki albo zła domena w integracji | Ustawienia, Bezpośrednie odnośniki, ustawienia integracji w Base |
| Brak zamówień po dłuższej przerwie | Pobieranie wyłączone lub zamówienia starsze niż okno pobierania | Ustawienia integracji w Base, ręczne pobranie |
Po naprawie połączenia porównaj listę zamówień w WooCommerce i w Base z całego okresu przerwy. Zamówienia, które nie dociągnęły się automatycznie, to zwykle te, które najdłużej czekają na wysyłkę, a klient już o nie pyta.
Jak nie dopuścić do tego ponownie?
Ustaw monitoring, który porównuje liczbę zamówień w sklepie i w Base, i wysyła powiadomienie, gdy różnica utrzymuje się dłużej niż godzinę. Opisz w dokumentacji sklepu, do czego służy klucz API Base, żeby nie zniknął przy porządkach, a reguły zapory testuj po każdej zmianie hostingu lub CDN. Jeśli problemem są stany magazynowe, a nie samo pobieranie zamówień, zobacz wpis o tym, dlaczego stany w sklepie i na Allegro się nie zgadzają.
Konfigurację i monitoring połączeń WooCommerce z Base, Allegro, kurierami i programami księgowymi robimy w ramach integracji sklepu internetowego. Ten problem jest jednym z naszej listy 30 problemów z integracjami sklepu internetowego.
Darmowy skan sklepu
Sprawdź swój sklep za darmo
Wpisz adres, a przeniesiemy Cię do bezpłatnego skanu na stronie CodeScriptum.
Jak to rozwiązać krok po kroku
BaseLinker nie pobiera zamówień z WooCommerce - przyczyny i naprawa krok po kroku - https://codescriptum.pl/blog/baselinker-nie-pobiera-zamowien-z-woocommerce/
- W Base otwórz ustawienia integracji WooCommerce i sprawdź komunikat błędu, adres sklepu (bez protokołu) i to, czy pobieranie zamówień jest włączone.
- W WooCommerce, Ustawienia, Zaawansowane, REST API sprawdź klucz Base: czy istnieje, ma uprawnienia do odczytu i zapisu, jest przypisany do administratora i kiedy był ostatnio użyty.
- Sprawdź, czy wtyczka Base jest aktywna i aktualna, a bezpośrednie odnośniki nie są ustawione na zwykłe.
- Przejrzyj logi wtyczki bezpieczeństwa, zapory i CDN z czasu, gdy zamówienia przestały spływać, i dodaj wyjątek dla zapytań integracji zamiast wyłączać ochronę całego sklepu.
- Jeśli Base zgłasza brak klucza mimo poprawnych danych, poproś hosting o sprawdzenie przekazywania nagłówka Authorization.
- Po naprawie pobierz zamówienia ręcznie, porównaj listy z okresu przerwy w obu systemach i ustaw powiadomienie o różnicy w liczbie zamówień.
Jak sprawdzić, że zadziałało
Złóż zamówienie testowe w sklepie i sprawdź, czy pojawi się w Base w czasie zgodnym z ustawioną częstotliwością pobierania. Zmień w Base jego status i dodaj numer przesyłki, a potem sprawdź, czy wróciły do zamówienia w WooCommerce. Lista zamówień z okresu przerwy jest w obu systemach taka sama.
Usługa CodeScriptum
Sklepy internetowe
od 3 500 zł netto
- WooCommerce, Shopify, PrestaShop, Shoper i sklepy dedykowane
- Migracja bez utraty pozycji w Google
- Integracje: płatności, InPost, BaseLinker, KSeF
Najczęściej zadawane pytania
Jak często BaseLinker pobiera zamówienia z WooCommerce?
Według pomocy Base zamówienia ze sklepu są domyślnie pobierane co 10 minut. W ustawieniach integracji możesz też pobrać je ręcznie w dowolnym momencie.
Czy po naprawie połączenia BaseLinker dociągnie wszystkie zaległe zamówienia?
Nie zawsze. Pomoc Base podaje, że po włączeniu pobierania trafiają do systemu zamówienia z ostatnich 24 godzin, dlatego po dłuższej przerwie porównaj listy zamówień w obu systemach.
Czy wtyczka Base jest potrzebna, skoro są klucze REST API?
Tak. Pomoc Base zaleca zainstalowanie oficjalnej wtyczki z katalogu WordPress.org, bo odpowiada ona za prawidłowe przekazywanie danych o zamówieniach.
Czy mogę wyłączyć wtyczkę bezpieczeństwa, żeby integracja działała?
Lepiej nie. Znajdź regułę, która blokuje zapytania integracji, i dodaj dla niej wyjątek. Wyłączenie ochrony całego sklepu otwiera go na ataki, np. na testowanie kart w formularzu zamówienia.
Pojęcia w tym artykule
Źródła
- Base.com: integracja z WooCommerce (pomoc) (otwiera się w nowej karcie) base.com
- Base.com: pobieranie zamówień (pomoc) (otwiera się w nowej karcie) base.com
- Dokumentacja REST API WooCommerce (uwierzytelnianie, wymagania) (otwiera się w nowej karcie) woocommerce.github.io
- WooCommerce: webhooki (otwiera się w nowej karcie) woocommerce.com
Podobne problemy
Sklepy internetowe
Problemy z integracjami sklepu internetowego: 30 błędów z BaseLinkerem, Allegro, ERP, KSeF i kurierami (2026)
Przy każdym z 30 problemów podajemy przyczynę i rozwiązanie, a przy najczęstszych link do szczegółowej naprawy; jeśli wolisz oddać połączenie sklepu z innymi systemami zespołowi…
Sklepy internetowe
Stany magazynowe w sklepie i na Allegro się nie zgadzają - przyczyny i naprawa
Rozwiązanie Jeden system jako źródło stanów, połączenie kanałów przez system wielokanałowy lub własną integrację opartą na zdarzeniach, rezerwa dla szybko rotujących produktów i…
Sklepy internetowe
Integracja WooCommerce z programem księgowym - Subiekt, Optima, enova, wFirma, Fakturownia
Rozwiązanie Wybierz sposób połączenia pasujący do programu (API, system wielokanałowy, moduł producenta lub własny łącznik), ustal źródło danych dla produktów, stanów i cen oraz…
Sklepy internetowe
Klient zapłacił, a zamówienie WooCommerce dalej „Oczekuje na płatność”
Rozwiązanie Popraw adres powiadomień w panelu operatora, odblokuj go w zaporze i cache, zaktualizuj wtyczkę bramki i sprawdź logi.