
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.
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ć.
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.
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:
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.
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:
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.
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ę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.
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.
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.
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.