Reguły wyboru kuriera i usługi: jak Zaksio decyduje

Reguły wyboru wskazują, którym kontem i którą usługą kuriera ma pojechać zamówienie. Dzięki nim magazynier nie musi za każdym razem wybierać kuriera ręcznie. Wybór jest jawny i powtarzalny: te same dane zamówienia zawsze dają ten sam wynik.

Z czego składa się reguła

• „Nazwa reguły”, „Priorytet” (liczba od 0 do 100000, mniejsza oznacza sprawdzaną wcześniej) i przełącznik „Reguła aktywna”.
• Warunki: „Waga razem od (kg)” i „do (kg)”, „Maks. waga jednej paczki (kg)”, maksymalna długość, szerokość i wysokość paczki w centymetrach (to jest gabaryt), „Kraje dostawy”, „Dostawa” (do punktu odbioru, na przykład Paczkomat, albo do drzwi), „Pobranie” (tylko za pobraniem lub tylko bez), „Kanały sprzedaży”, „Wartość zamówienia od i do (zł)”, „Magazyny” i „Metody dostawy klienta”.
• „Konto i usługa”: konto kurierskie i usługa, które zostaną użyte, gdy reguła pasuje.
• „Kurierzy zapasowi (do 5)”: kolejne pary konto i usługa, próbowane po kolei, jeśli główny kurier zawiedzie.

Jak wybierana jest reguła

• Warunki łączą się spójnikiem „i”: wszystkie podane muszą być spełnione, a puste pola niczego nie ograniczają.
• Reguły są sprawdzane według priorytetu (przy remisie według daty utworzenia), a pierwsza pasująca wygrywa. Dalsze reguły są już pomijane.
• Jeśli gabaryt paczki jest nieznany, a reguła ma limit gabarytu, reguła nie pasuje. Nie zgadujemy wymiarów.
• Brak pasującej reguły to nie błąd, tylko decyzja dla człowieka: zamówienie dostaje flagę „wymaga decyzji” (shipping_rule_missing), a Ty wybierasz kuriera i usługę ręcznie albo dodajesz regułę. Ręczny wybór zdejmuje flagę.
• Ślad „Dlaczego ten kurier” zapisuje się przy przesyłce i jest widoczny w jej szczegółach oraz przy wycenie: widać, która reguła wygrała i dlaczego poprzednie odpadły.

Kiedy próbujemy zapasowego kuriera

Zapasowy kurier jest używany tylko wtedy, gdy główny zawiedzie w sposób, który nie grozi dublem przesyłki: po błędach dostępności z kodem HTTP (5xx, 429), po błędach autoryzacji oraz gdy kurier uzna usługę za nieobsługiwaną albo odrzuci przesyłkę. Po timeoucie, braku połączenia ani po błędzie walidacji danych (na przykład zły adres) nie przechodzimy na zapasowego: timeout może oznaczać, że przesyłka jednak powstała, a błąd danych powtórzyłby się u każdego kuriera.

Jak ułożyć reguły

1. Zacznij od najbardziej szczegółowych reguł z niskim numerem priorytetu, na przykład „pobranie do punktu odbioru” albo „zagranica”.
2. Dodaj ogólną regułę z wyższym numerem, która łapie resztę zamówień, na przykład wszystkie krajowe paczki do określonej wagi.
3. Do głównych reguł dopisz zapasowych kurierów, jeśli masz więcej niż jedno konto.
4. Sprawdź układ w sekcji „Podgląd: co się stanie dla przykładowej paczki”: podaj przykładowe dane i zobacz, która reguła wygra. Podgląd liczy w przeglądarce według tej samej logiki co serwer, ale to symulacja: ostateczny wybór zawsze robi serwer przy tworzeniu przesyłki.

Czego reguły jeszcze nie robią

• Nie wybierają kuriera po cenie ani „najtańszego z pasujących”. Cenę przez API zwracają tylko InPost, UPS i DHL Express, a własnego cennika klienta nie ma (ta decyzja czeka na omówienie).
• Nie uwzględniają terminu doręczenia ani innych parametrów SLA.
• Nie księgują kosztu przesyłki ani nie porównują go z opłatą pobraną od klienta.

Gdzie to znaleźć w aplikacji

Menu „Wysyłki” (grupa „Magazyn”), zakładka „Reguły wyboru”, przycisk „Dodaj regułę”. Oglądanie wymaga uprawnienia shipping:read, zmiany reguł uprawnienia shipping:write. Moduł shipping jest dostępny, gdy w profilu firmy włączona jest cecha shipping. Konta, z których korzystają reguły, dodajesz w zakładce „Konta kurierskie”.