Gdy Baselinker przestaje pobierać zamówienia, w dziewięciu przypadkach na dziesięć winne jest połączenie ze sklepem albo marketplace, a nie sam Baselinker. Najczęstsze przyczyny to: wygasła autoryzacja lub zmieniony klucz API, wyłączone albo źle ustawione pobieranie w konfiguracji integracji, złe mapowanie statusów (zamówienia są, ale wpadają do statusu, którego nie oglądasz), zmiany po stronie sklepu (nowy adres, certyfikat SSL, wtyczka zabezpieczająca), limity konta lub API oraz zwykła przerwa techniczna po stronie marketplace. Zanim cokolwiek przełączysz, wejdź w logi integracji - Baselinker zapisuje tam każdą próbę pobrania i to one mówią, czy w ogóle doszło do połączenia.
Poniżej masz kolejność sprawdzania od najczęstszego do najrzadszego, tak żeby nie tracić godziny na przeklikiwanie ustawień, które akurat są w porządku.
Zacznij od logów, nie od ustawień
Logi to zapis każdej próby połączenia Baselinkera z Twoim sklepem lub kontem sprzedażowym - z datą, wynikiem i treścią błędu. Znajdziesz je w panelu przy konkretnej integracji (sekcja z listą sklepów i marketplace, opcja z historią zdarzeń lub logami) oraz w historii samego zamówienia, jeśli już się pobrało.
Trzy scenariusze, które od razu zawężają szukanie:
| Co widzisz w logach | Co to znaczy | Gdzie szukać dalej |
|---|---|---|
| Brak wpisów, integracja „milczy” | Pobieranie jest wyłączone albo integracja została wstrzymana | Ustawienia integracji, status konta |
| Wpisy z błędem autoryzacji lub odmową dostępu | Klucz, token albo hasło przestały działać | Sekcja z kluczami API po stronie sklepu |
| Wpisy z sukcesem, ale zero nowych zamówień | Pobieranie działa, filtr statusów odcina zamówienia | Mapowanie statusów i zakres dat |
Ostatni przypadek jest najbardziej mylący: wszystko świeci na zielono, a zamówień nie ma. To prawie zawsze konfiguracja, nie awaria.
Przyczyna 1 - wygasła autoryzacja albo zmieniony klucz API
Autoryzacja to zgoda, którą Twój sklep lub konto na marketplace dało Baselinkerowi na pobieranie danych. Ta zgoda potrafi wygasnąć sama (część połączeń wymaga okresowego odnowienia) albo zostać unieważniona, gdy ktoś zmienił hasło, wyłączył konto pracownika albo skasował klucze.
Co zrobić po kolei:
- Wejdź w ustawienia integracji i sprawdź, czy jest tam komunikat o wygasłym połączeniu - często wystarczy jedno kliknięcie „Połącz ponownie”
- Przy sklepie na WooCommerce sprawdź, czy klucz API (para: klucz i sekret) nadal istnieje i ma uprawnienia do odczytu i zapisu
- Jeśli klucza nie ma albo nie masz pewności - wygeneruj nowy i wklej go do Baselinkera; stary od razu skasuj
- Zapisz i uruchom ręczne pobranie, żeby zobaczyć wynik w logach od razu, a nie za kwadrans
Uwaga na pułapkę: klucze API są przypisane do konkretnego konta użytkownika w sklepie. Jeśli skasowałeś konto pracownika, integracja wpięta na jego dane umiera razem z nim.
Przyczyna 2 - zmiana po stronie sklepu, o której nikt nie pomyślał
Baselinker łączy się z Twoim sklepem po adresie internetowym. Cokolwiek zmieni ten adres albo sposób wchodzenia na niego, potrafi zerwać połączenie z dnia na dzień:
- Wygasły certyfikat SSL - połączenie szyfrowane przestaje być uznawane za zaufane; objawy opisałem szerzej przy wygasłym certyfikacie SSL
- Zmiana adresu ze starego na nowy albo przejście na inną domenę bez aktualizacji adresu w integracji
- Wtyczka bezpieczeństwa albo firewall blokujące zapytania z serwerów Baselinkera - typowe po zmianie hostingu lub włączeniu nowej ochrony
- Zmiana hostingu, po której stary adres jeszcze przez chwilę odpowiada, a nowy wymaga ponownego wpięcia
- Aktualizacja wtyczki łączącej sklep z Baselinkerem, po której zmieniły się ustawienia
Test na dwie minuty: otwórz adres sklepu w przeglądarce i sprawdź, czy kłódka jest zamknięta i czy adres zgadza się co do znaku z tym w Baselinkerze (z „www” lub bez - to ma znaczenie).
Przyczyna 3 - złe mapowanie statusów
Mapowanie statusów to reguła mówiąca, które zamówienia ze sklepu mają trafić do Baselinkera i w jakim statusie mają wylądować. Jeśli integracja pobiera wyłącznie zamówienia opłacone, a Twoje wpadają jako „oczekujące na płatność”, to Baselinker działa poprawnie i po prostu ich nie bierze.
Co sprawdzić w ustawieniach integracji:
- Które statusy źródłowe są pobierane - najczęstszy błąd to zawężenie do jednego statusu
- Do jakiego statusu w Baselinkerze trafiają - być może są, tylko na liście, której nie masz przypiętej na wierzchu
- Od jakiej daty pobierane są zamówienia - po ponownym wpięciu integracji zakres potrafi się zresetować
- Czy nie działa automatyczna akcja, która od razu przenosi zamówienie dalej, np. do zrealizowanych
Zanim uznasz, że zamówień nie ma, wyszukaj konkretny numer w wyszukiwarce Baselinkera bez filtrów. Zaskakująco często się znajduje.
Przyczyna 4 - limity, wstrzymanie i zawieszenie konta
Baselinker rozlicza się w modelu abonamentowym i ma limity - zarówno liczby zamówień w pakiecie, jak i liczby zapytań do API w jednostce czasu. Gdy limit zostanie przekroczony albo płatność nie przejdzie, pobieranie może zostać wstrzymane, a konto ograniczone.
Sprawdź w tej kolejności:
- Komunikaty na górze panelu i wiadomości w skrzynce - blokady zwykle są zapowiadane
- Stan płatności i wykorzystanie pakietu za bieżący miesiąc
- Czy integracja nie jest ręcznie wyłączona (przełącznik przy sklepie na liście)
- Czy nie masz zbyt agresywnych automatów lub własnych skryptów odpytujących API - potrafią wyczerpać limit zapytań i wtedy „nic nie działa” tylko w godzinach szczytu
Cenniki i limity zmieniają się w czasie, więc aktualne progi weryfikuj w swoim panelu. Własny skrypt warto przejrzeć pod kątem tego, jak często pyta - rozpisałem to przy automatyzacjach na API Baselinkera.
Przyczyna 5 - problem po stronie marketplace
Przy Allegro i innych platformach dochodzi warstwa, na którą nie masz wpływu: autoryzacja aplikacji, przerwy techniczne i zmiany w interfejsie sprzedażowym. Objaw jest charakterystyczny - jedno źródło milczy, a pozostałe pobierają normalnie.
Co robić:
- Sprawdź, czy w logach są błędy autoryzacji akurat dla tego konta sprzedażowego
- Wejdź na to konto w przeglądarce i zobacz, czy zamówienia tam są (jeśli nie ma ich u źródła, Baselinker nie zawinił)
- Odnów połączenie z kontem sprzedażowym w ustawieniach integracji
- Przy kilku kontach na jednej platformie sprawdź każde osobno - wygasa zwykle jedno
Więcej o układaniu wielu kanałów sprzedaży obok siebie jest w tekście o integracji marketplace ze sklepem.
Po każdej poprawce nie czekaj na automatyczny cykl - uruchom pobieranie ręcznie z poziomu integracji. Widzisz wynik od razu i dostajesz świeży wpis w logach dotyczący dokładnie tej zmiany. Zmieniaj jedną rzecz naraz, bo trzy poprawki jednocześnie i udane pobranie nie mówią nic o tym, co było zepsute.
Kiedy usunąć integrację i wpiąć ją od nowa
Usunięcie integracji to ostatni krok, nie pierwszy. Ma sens, gdy przeszedłeś powyższe punkty i logi dalej pokazują błąd autoryzacji, albo gdy sklep zmienił adres czy platformę. Zanim to zrobisz:
- Spisz aktualne ustawienia: mapowanie statusów, magazyny, sposób pobierania cen i podatków
- Sprawdź, czy usunięcie nie zerwie powiązania z już pobranymi zamówieniami i wystawionymi dokumentami
- Wpinaj od nowa poza godzinami szczytu, żeby uniknąć nakładania się pobrań
- Ustaw zakres dat tak, by nie zaciągnąć ponownie starych zamówień i nie zrobić duplikatów
- Po wpięciu skontroluj pierwsze pięć zamówień ręcznie: kwoty, dostawę, dane do faktury
Duplikaty to najgorszy skutek pośpiesznego przepięcia - wypływają dopiero przy fakturach i wysyłce.
Jak nie wracać do tego co miesiąc
Większość takich awarii ma jedną wspólną cechę: nikt ich nie zauważa przez kilka godzin, bo zamówienia po prostu „przestają przychodzić”, a to wygląda jak słabszy dzień. Trzy rzeczy, które to ucinają:
- Prosty alarm - powiadomienie, gdy przez X godzin nie wpadło żadne zamówienie z danego kanału
- Kalendarz odnowień - zapisane daty wygasania certyfikatu, kluczy i autoryzacji marketplace
- Jedna osoba od dostępów - klucze API na konto techniczne, nie na prywatne konto pracownika
Jeśli sklep dodatkowo gubi maile o zamówieniach, to zwykle osobny wątek - opisałem go przy WooCommerce, który nie wysyła maili.
Gdy to nie pomogło - zajrzę do tego z Tobą
Jeśli przeszedłeś całą listę i zamówienia dalej nie wpadają, problem najczęściej siedzi głębiej: w sposobie, w jaki sklep oddaje dane, w konfiguracji serwera albo we własnym kodzie wpiętym w zamówienia. Zaczynam wtedy od bezpłatnej diagnozy - patrzę w logi, sprawdzam połączenie i mówię wprost, co jest zepsute i ile zajmie naprawa. Drobne rzeczy naprawiam od ręki, a przy większej robocie (przebudowa integracji, własne automaty, spięcie z fakturami lub magazynem) dostajesz wycenę na piśmie przed startem - projekty tego typu mieszczą się zwykle w widełkach 5000-10000 zł netto. Jeśli zależy Ci na tym, żeby ktoś pilnował tego na bieżąco, jest stała opieka techniczna w trzech pakietach: 1000, 2000 albo 3500 zł netto miesięcznie. Sam sklep i jego integracje rozwijam w ramach prac nad e-commerce.
Najczęstsze pytania
Dlaczego Baselinker nie pobiera zamówień z mojego sklepu? Najczęściej dlatego, że wygasła autoryzacja lub klucz API przestał działać, albo dlatego, że pobierane są tylko zamówienia w wybranym statusie, a Twoje mają inny. Rozstrzygają to logi integracji: brak wpisów oznacza wyłączone pobieranie, wpisy z sukcesem bez nowych zamówień oznaczają problem z mapowaniem statusów.
Gdzie są logi w Baselinkerze? Przy każdej integracji w panelu jest podgląd historii połączeń, a przy pojedynczym zamówieniu - jego własna historia zdarzeń. To pierwsze miejsce, do którego warto zajrzeć, bo pokazuje datę i treść błędu, zamiast zgadywania po objawach.
Jak usunąć integrację w Baselinkerze i wpiąć ją od nowa? Integrację usuwa się z listy sklepów w ustawieniach, ale wcześniej spisz mapowanie statusów i ustawienia magazynów, bo znikną razem z nią. Po ponownym wpięciu ustaw zakres dat tak, żeby nie zaciągnąć starych zamówień drugi raz - inaczej zrobisz sobie duplikaty w dokumentach i wysyłce.
Czy zawieszenie konta blokuje pobieranie zamówień? Tak, ograniczenia konta i przekroczone limity pakietu potrafią wstrzymać pobieranie, a w panelu pojawia się wtedy komunikat. Zamówienia w sklepie i na marketplace są bezpieczne - po odblokowaniu można je pobrać, ustawiając odpowiedni zakres dat.
Powiązane: Automatyzacje na API Baselinkera · Synchronizacja stanów magazynowych · Stała opieka techniczna