Today Automate logo
Dłonie na klawiaturze laptopa z rozmytym pulpitem na ekranie, w tle paczki e-commerce – diagnozowanie błędów automatycznych akcji w BaseLinker.

Błędy automatycznych akcji w BaseLinker – jak je diagnozować i naprawiać

  • Autor: Milosz
  • Opublikowano: 15 listopada 2026
  • Kategoria: Automatyzacja ecommerce
  • Czas czytania: 8 min

Automatyczna akcja w BaseLinker, która przestaje działać, zwykle nie psuje się sama z siebie. To niemal zawsze efekt zmiany w statusach, konflikcie reguł albo ograniczeń po stronie integracji zewnętrznej. Błędy automatycznych akcji w BaseLinker da się jednak zdiagnozować metodycznie, bez zgadywania, jeśli wie się, gdzie szukać przyczyny.

Dlaczego automatyczne akcje w BaseLinker przestają działać

Najczęstszą przyczyną jest zmiana statusu zamówienia, która nie spełnia już warunku zapisanego w regule. Dzieje się tak na przykład wtedy, gdy integrator płatności zacznie nadawać inną nazwę statusu albo sklep internetowy zmieni mapowanie statusów po aktualizacji. Reguła, która działała miesiącami, nagle przestaje się uruchamiać, bo warunek przestał być spełniony, choć sama akcja w panelu wygląda identycznie jak wcześniej.

Drugim typowym źródłem problemu jest konflikt dwóch reguł działających na tym samym zamówieniu w tym samym momencie. Jedna akcja zmienia status, druga na tej zmianie bazuje, i kolejność wykonania decyduje o tym, czy cokolwiek się uruchomi. Do tego dochodzą przekroczone limity API sklepu lub kuriera oraz zmiany w strukturze danych, na przykład nowe pole w zamówieniu, które psuje szablon wiadomości lub fakturę.

Przykładowy scenariusz: sklep na WooCommerce aktualizuje wtyczkę płatności, która zaczyna wysyłać status "Przetwarzanie" zamiast dotychczasowego "W realizacji". Reguła w BaseLinker, uruchamiająca wysyłkę faktury przy statusie "W realizacji", przestaje działać z dnia na dzień, mimo że nikt nic nie zmieniał w samym panelu. Jeśli sklep działa w kilku kanałach jednocześnie, warto przy okazji przejrzeć całą automatyzację sklepu internetowego, bo podobne niezgodności statusów potrafią się kumulować.

Jak czytać logi i historię akcji automatycznych

BaseLinker zapisuje historię wykonania każdej automatycznej akcji w szczegółach zamówienia, w zakładce z logiem zdarzeń. Widać tam, czy akcja w ogóle została wywołana, czy warunek nie został spełniony, oraz jaki komunikat zwrócił system zewnętrzny, jeśli akcja wysyła dane poza BaseLinker. To pierwsze miejsce, które trzeba sprawdzić, zanim zacznie się zmieniać konfigurację reguł.

Kluczowe jest odróżnienie dwóch rodzajów błędów. Błąd warunku oznacza, że akcja w ogóle się nie uruchomiła, bo zamówienie nie spełniło kryteriów reguły, czyli problem leży w logice warunków. Błąd wykonania oznacza, że warunek został spełniony, akcja wystartowała, ale zakończyła się niepowodzeniem, na przykład z powodu błędu API zewnętrznego systemu.

Typowy komunikat błędu wykonania wygląda tak: "Błąd połączenia z API: kod 429, zbyt wiele zapytań". To jasny sygnał, że problem nie leży w regule, tylko w limicie zapytań po stronie systemu, do którego akcja wysyła dane, na przykład księgowości lub kuriera. Inny częsty komunikat, "Brak uprawnień do wykonania operacji", wskazuje na wygasły token integracji albo zmienione uprawnienia konta.

Diagnozowanie błędnej akcji krok po kroku na przykładzie

Weźmy konkretny case: akcja automatyczna wysyłająca fakturę do klienta nie uruchamia się po zmianie statusu zamówienia na "opłacone". Pierwszy krok to sprawdzenie, czy warunek reguły faktycznie odnosi się do tego statusu, bo nazwy statusów bywają podobne, ale nie identyczne, na przykład "Opłacone" i "Zamówienie opłacone" to dla systemu dwie różne wartości.

Jeśli warunek jest poprawny, kolejnym krokiem jest sprawdzenie kolejności akcji przypisanych do tego samego statusu. Może się okazać, że inna reguła, uruchamiana wcześniej, zmienia status zamówienia zanim dotrze do niej reguła wysyłająca fakturę, przez co warunek nigdy nie zostaje spełniony w oczekiwanym momencie. Warto wtedy:

  • Sprawdzić warunek reguły: czy dokładnie pasuje do aktualnej nazwy statusu w systemie.
  • Sprawdzić kolejność reguł: czy inna akcja nie zmienia statusu przed wykonaniem tej, która nas interesuje.
  • Sprawdzić uprawnienia integracji: czy token do systemu fakturującego nie wygasł i czy konto ma dostęp do wystawiania dokumentów.
  • Sprawdzić log zdarzenia: czy w ogóle pojawił się wpis o próbie uruchomienia akcji.

Dopiero po przejściu tych czterech punktów warto modyfikować regułę. W praktyce większość przypadków "akcja nie działa" kończy się na pierwszym lub drugim kroku, bo to tam najczęściej leży przyczyna.

Najczęstsze błędy konfiguracyjne i jak ich unikać

Nakładające się warunki to problem, który pojawia się, gdy dwie reguły obsługują ten sam status z różnymi kryteriami dodatkowymi, przez co system wykonuje obie akcje albo żadną, w zależności od kolejności przetwarzania. Podobnie działa brak wykluczeń, czyli sytuacja, w której reguła nie ma zastrzeżenia "nie wykonuj ponownie", przez co akcja uruchamia się wielokrotnie na tym samym zamówieniu, na przykład przy każdej edycji zamówienia przez obsługę klienta.

Zła kolejność akcji w ramach jednego statusu to kolejny częsty błąd. Jeśli akcja wysyłająca powiadomienie SMS jest ustawiona przed akcją aktualizującą dane adresowe, klient dostanie SMS ze starym adresem, mimo że dane w systemie już są poprawne. Kolejność wykonania ma znaczenie i trzeba ją traktować jako element logiki, a nie przypadkową listę.

Kilka praktycznych zasad, które ograniczają ryzyko błędów konfiguracyjnych:

  • Jeden status, jedna reguła: jeśli to możliwe, unikaj przypisywania wielu reguł do tego samego statusu.
  • Dodawaj wykluczenia: zabezpieczaj reguły warunkiem, który blokuje ponowne wykonanie akcji na tym samym zamówieniu.
  • Testuj na pojedynczym zamówieniu: przed wdrożeniem reguły na cały sklep sprawdź ją na jednym testowym zamówieniu.
  • Dokumentuj logikę reguł: zapisuj, po co dana reguła istnieje, bo po kilku miesiącach trudno to odtworzyć z samego panelu.

Problemy po stronie integracji zewnętrznych (API, webhooki, limity)

Część błędów automatycznych akcji nie ma nic wspólnego z konfiguracją w BaseLinker, tylko wynika z ograniczeń po stronie systemu, z którym BaseLinker się komunikuje. Sklepy internetowe, kurierzy i systemy księgowe mają własne limity zapytań API, i jeśli automatyczna akcja próbuje wysłać zbyt wiele żądań w krótkim czasie, część z nich zostaje odrzucona.

Przykładowy scenariusz: sklep generuje kilkaset zamówień dziennie, a akcja automatyczna wysyła każde zamówienie do systemu księgowego w momencie zmiany statusu na "wysłane". Przy większym ruchu, na przykład w okresie wyprzedaży, system księgowy zaczyna zwracać błąd przekroczenia limitu, i część faktur po prostu nie powstaje. Rozwiązaniem bywa rozłożenie wysyłki w czasie, na przykład przez dodanie opóźnienia w akcji albo grupowanie zamówień w paczki przetwarzane co kilka minut zamiast natychmiast.

Webhooki, czyli powiadomienia wysyłane przez zewnętrzne systemy do BaseLinkera, też bywają źródłem problemu, zwłaszcza gdy sklep zmieni adres endpointu albo certyfikat SSL wygaśnie. Wtedy BaseLinker w ogóle nie dostaje informacji o zmianie, więc żadna reguła się nie uruchamia, mimo że z perspektywy panelu wszystko wygląda poprawnie skonfigurowane. W takich przypadkach dobrym punktem odniesienia jest sprawdzenie, jak wyglądało to u klienta, który zmagał się z podobnym problemem limitów API przy skali kilkuset zamówień dziennie.

Kiedy naprawić samemu, a kiedy potrzebne jest wsparcie techniczne

Błędy warunków, złą kolejność reguł i proste literówki w nazwach statusów da się zwykle naprawić samodzielnie, bezpośrednio w panelu BaseLinker, bez ingerencji w kod czy API. Wystarczy przejść przez kroki diagnostyczne opisane wcześniej i poprawić konfigurację reguły, co w typowym wdrożeniu zajmuje od kilkunastu minut do godziny.

Inaczej wygląda sytuacja, gdy problem leży w integracji zewnętrznej, czyli w limitach API, wygasłych tokenach, zmienionej strukturze webhooków albo w konflikcie między kilkoma systemami podłączonymi jednocześnie. Taka diagnostyka wymaga dostępu do logów po stronie integracji, czasem kontaktu z dostawcą API, i w typowym wdrożeniu zajmuje od kilku godzin do kilku dni roboczych, w zależności od liczby podłączonych systemów.

Jeśli po sprawdzeniu logów i warunków problem nadal nie jest jasny, albo dotyczy złożonej automatyzacji łączącej BaseLinker z ERP, kurierem i systemem księgowym jednocześnie, warto skorzystać z pomocy w konfiguracji BaseLinkera. Specjalista z dostępem do logów API po obu stronach znajdzie przyczynę szybciej niż próby metodą prób i błędów, co w praktyce oszczędza czas i ogranicza ryzyko powtórzenia się błędu w przyszłości.

Najczęstsze pytania

Dlaczego akcja automatyczna uruchomiła się dwukrotnie?

Najczęstszą przyczyną jest brak wykluczenia w regule, przez co akcja uruchamia się ponownie przy każdej zmianie powiązanej z danym zamówieniem, nie tylko przy pierwszym spełnieniu warunku. Warto dodać do reguły warunek blokujący ponowne wykonanie, na przykład sprawdzający, czy dana akcja nie została już zrealizowana.

Czy błąd akcji może zablokować inne zamówienia?

Pojedynczy błąd wykonania akcji zwykle dotyczy tylko jednego zamówienia i nie wpływa bezpośrednio na pozostałe. Wyjątkiem jest sytuacja, gdy błąd wynika z przekroczenia limitu API, bo wtedy kolejne zamówienia w kolejce też mogą zostać odrzucone, dopóki limit się nie odnowi.

Jak sprawdzić, czy problem leży po stronie BaseLinker czy integracji zewnętrznej?

Trzeba sprawdzić log zdarzenia akcji: jeśli widać tam komunikat błędu z kodem zwróconym przez system zewnętrzny, na przykład błąd API księgowości, problem leży po stronie integracji. Jeśli log pokazuje, że akcja w ogóle się nie uruchomiła, przyczyna najczęściej tkwi w warunku reguły wewnątrz BaseLinkera.

Jak zabezpieczyć się przed podobnymi błędami w przyszłości?

Warto regularnie przeglądać logi akcji automatycznych, zwłaszcza po aktualizacjach sklepu lub integracji, oraz testować nowe reguły na pojedynczym zamówieniu przed wdrożeniem na cały sklep. Dobrą praktyką jest też dokumentowanie logiki reguł, co ułatwia szybkie ustalenie przyczyny, gdy coś przestanie działać po kilku miesiącach.

Diagnozowanie błędów automatycznych akcji w BaseLinker sprowadza się do trzech kroków: sprawdzenia logu zdarzenia, rozróżnienia błędu warunku od błędu wykonania, i weryfikacji, czy problem nie leży po stronie integracji zewnętrznej. Jeśli po przejściu tych kroków przyczyna wciąż nie jest jasna, zamiast dalej zgadywać, warto przejrzeć całą konfigurację automatyzacji i przy okazji sprawdzić, jak zbudować sprzedaż wielokanałową w sklepie internetowym tak, by podobne błędy nie powtarzały się przy każdym nowym kanale sprzedaży.

Skontaktuj się z nami

Wyrażam zgodę na przetwarzanie danych oraz akceptuję Politykę Prywatności

Kontakt

Numer telefonu

+48 697 322 226

Błędy automatycznych akcji w BaseLinker – diagnoza i naprawa | Blog Today Automate