Automatyzacje

Reguła w Kangurze to trzy rzeczy: kiedy (wyzwalacz), czy na pewno (warunki) i co zrobić (akcje, po kolei).

Wyzwalacze

Reguła rusza, gdy w systemie zajdzie zdarzenie. Pełną listę zwraca GET /api/automations/triggers; dziś obsługiwane są między innymi:

Zamówienia — order.created, order.updated, order.status_changed, order.paid, order.shipped

Magazyn i kompletacja — order.picking_started, order.picked, order.packing_started, order.packed, order.picking_cancelled, order.packing_cancelled

Produkty — product.created, product.updated, product.stock_changed, product.price_changed, product.cost_changed, stock.low_alert

Przesyłki i zwroty — shipment.created, shipment.status_changed, return.created, return.status_changed, return.refunded

Warunki

Zawężają regułę do konkretnych przypadków: „tylko powyżej 500 zł”, „tylko dla kuriera DPD”, „tylko gdy klient ma etykietę VIP”. Reguła bez warunków wykona się przy każdym zdarzeniu swojego typu.

Akcje

Wykonują się po kolei. Pierwszy błąd zatrzymuje resztę — kolejne kroki się nie wykonają, a wykonanie ma status „nieudane" z powodem.

Akcja	Co robi
Zmień status	ustawia status zamówienia
Dodaj / usuń tag	zarządza tagami zamówienia
Ustaw pole	zapisuje wartość w wybranym polu
Webhook HTTP	wysyła żądanie pod Twój adres
Wyślij e-mail	wiadomość do klienta albo zespołu
Wyślij wiadomość	odpowiedź w kanale sprzedaży
Wyślij na Telegram	powiadomienie zespołu
Wybierz kuriera	dobiera przewoźnika wg reguł logistyki
Nadaj przesyłkę	nadaje u kuriera i zapisuje numer śledzenia
Czekaj	wstrzymuje regułę na zadany czas i wznawia od następnego kroku
Podziel wg dostępności	wydziela pozycje bez pokrycia do osobnego zamówienia
Akcje produktowe	status, tagi, cena produktu

Nadaj przesyłkę

Idzie tą samą drogą co przycisk w panelu. Kuriera bierze z ustawień akcji, a gdy go tam nie ma — z zamówienia (na przykład po wcześniejszym kroku „Wybierz kuriera”). Zamówienie, które ma już przesyłkę, jest pomijane — drugie nadanie to druga paczka i druga faktura od kuriera. Odmowa kuriera to błąd z jego powodem, nie ciche pominięcie.

Czekaj

Wstrzymuje regułę i wznawia ją od następnego kroku. Przerwa przeżywa restart aplikacji — nie jest uśpieniem procesu, tylko wpisem w kolejce. Maksimum 30 dni. Wznowienia sprawdzane są co pół minuty, więc może nastąpić do 30 sekund po terminie.

Bieg próbny pomija przerwy

Test reguły z panelu przechodzi przez „Czekaj” bez czekania i nie zostawia nic w kolejce.

Historia wykonań

Każde uruchomienie zapisuje się z krokami i wynikiem. Statusy: wykonane, pominięte (warunki nie pasowały), nieudane (błąd z powodem), wstrzymane (czeka na wznowienie), wykryto pętlę (szczegóły).