Przejdź do treści
Darmowy audyt

Sklepy internetowe Problem i rozwiązanie

BaseLinker nie pobiera zamówień z WooCommerce - przyczyny i naprawa krok po kroku

Autor: Bartosz Gromek Zaktualizowano: 6 min czytania

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/

  1. 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.
  2. 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.
  3. Sprawdź, czy wtyczka Base jest aktywna i aktualna, a bezpośrednie odnośniki nie są ustawione na zwykłe.
  4. 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.
  5. Jeśli Base zgłasza brak klucza mimo poprawnych danych, poproś hosting o sprawdzenie przekazywania nagłówka Authorization.
  6. 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

  1. Base.com: integracja z WooCommerce (pomoc) (otwiera się w nowej karcie) base.com
  2. Base.com: pobieranie zamówień (pomoc) (otwiera się w nowej karcie) base.com
  3. Dokumentacja REST API WooCommerce (uwierzytelnianie, wymagania) (otwiera się w nowej karcie) woocommerce.github.io
  4. WooCommerce: webhooki (otwiera się w nowej karcie) woocommerce.com

Podobne problemy

O autorze

Bartosz Gromek

Założyciel CodeScriptum, technologia i rozwój

Założyciel CodeScriptum - firmy technologicznej z Łodzi, działającej od 2022 roku. Odpowiada za technologię i rozwój, a projekty realizuje razem z zespołem specjalistów od stron, sklepów internetowych, systemów CRM, integracji, AI i marketingu. Na blogu opisuje problemy, z którymi zgłaszają się klienci CodeScriptum, i sprawdzone sposoby ich rozwiązania.

Newsletter

Konkretne porady raz na jakiś czas

Nowe problemy i rozwiązania z bloga, zmiany w przepisach dla sklepów i stron oraz sprawdzone sposoby na więcej klientów z internetu. Bez spamu, wypis jednym kliknięciem.