# Statusy generowane dla zlecenia

To, jakie statusy będą w zleceniu danego typu, określa tabela `workflow`. Wskazuje ona na konkretny [typ transportu](<https://docs.logintegra.com/apollo-backend/6. Authorities &amp; Settings/transport-types/%23index/index.md>) (referencja `transport_type_id`). Referencje do tabeli `workflow` posiadają z kolei wpisy w tabeli `task`, będące szablonem statusu w zleceniu i określające, w jaki sposób status powinien się zachowywać.

## Ustawienia tasków (a więc szablonów dla statusów)

Ustawienia poszczególnych tasków można znaleźć w zakładce "Ustawienia", klikając w nazwę typu transportu:

![](<https://docs.logintegra.com/apollo-backend/static/Authorities &amp; Settings/transport-types/workflows/edit-form.png>)

Opis zaawansowanych ustawień tasków można znaleźć [TUTAJ](<https://docs.logintegra.com/apollo-backend/6. Authorities %26 Settings/transport-types/task-settings/index.md>). W formularzu przedstawionym na powyższym obrazku można:

- zmieniać nazwy statusów,
- zmieniać kolejność statusów,
- zmieniać kolor zlecenia, gdy będzie w danym statusie,
- zmieniać planowany czas zatwierdzenia statusu - w odniesieniu do wybranej daty w zleceniu,
- zmieniać tryb śledzenia statusu:

  - zlecenie będzie miało kolor czerwony, jeśli status zostanie zatwierdzony z opóźnieniem (ikona dzwonka),
  - okna czasowe będą miały czerwoną ramkę w przypadku opóźnienia zatwierdzenia statusu ([WIĘCEJ TU](<https://docs.logintegra.com/apollo-backend/2. Schedule &amp; Time windows/special-features/red-frame/index.md>)).

## Grupy tasków

Taski dzielą się na trzy grupy:

- prace przygotowawcze,
- załadunki i rozładunki,
- zakończenie procesu.

W przypadku tasków z pierwszej i ostatniej grupy (`prace przygotowawcze` i `zakończenie procesu`) statusy w zleceniu będą zawsze wygenerowane tylko raz dla całego zlecenia, w kolejności jaką wskazują ustawienia.

Taski z grupy `załadunki i rozładunki` są powiązane z konkretnym typem stepu w zleceniu. Oznacza to, że w przypadku większej ilości stepów w zleceniu statusy te mogą się generować oddzielnie dla każdego stepu. Jest to zależne od oczekiwanego czasu potwierdzenia statusu. Na poniższym obrazku przedstawione są dostępne opcje:

![](<https://docs.logintegra.com/apollo-backend/static/Authorities &amp; Settings/transport-types/workflows/step-types.png>)

W zależności od wybranej opcji może wygenerować się różna liczba statusów:

- opcja `załadunku` / `rozładunku` - dotyczy wszystkich stepów danego typu w zleceniu. Statusów tego typu wygeneruje się tyle, ile stepów danego typu w zleceniu - dla każdego stepu załadunkowego/rozładunkowego oddzielny,
- opcja `pierwszego załadunku` / `pierwszego rozładunku` - dotyczy tylko pierwszego stepu danego typu w zleceniu. Wygeneruje się jeden status tego typu dla całego zlecenia, a planowana data potwierdzenia będzie liczona względem pierwszego statusu danego typu w zleceniu,
- opcja `ostatniego załadunku` / `ostatniego rozładunku` - dotyczy tylko ostatniego stepu danego typu w zleceniu. Wygeneruje się jeden status tego typu dla całego zlecenia, a planowana data potwierdzenia będzie liczona względem ostatniego statusu danego typu w zleceniu.

### Przykład

Przy następującej konfiguracji statusów związanych ze stepami:

![](<https://docs.logintegra.com/apollo-backend/static/Authorities &amp; Settings/transport-types/workflows/example-settings.png>)

Dla zlecenia, w którym są 3 stepy rozładunkowe, powinno wygenerować się 5 statusów związanych z etapami transportu. Mam zlecenie z trzema rozładunkami w trzech różnych magazynach:

![](<https://docs.logintegra.com/apollo-backend/static/Authorities &amp; Settings/transport-types/workflows/examples-time-windows.png>)

Statusy przy wskazanej konfiguracji powinny wyglądać następująco:

- jeden status "Przyjazd kierowcy", z planowaną datą liczoną względem pierwszego rozładunku,
- trzy statusy "Rozpoczęcie rozładunku" - po jednym dla każdego stepu rozładunkowego,
- jeden status "Zakończenie rozładunku", z planowaną datą liczoną względem ostatniego rozładunku

![](<https://docs.logintegra.com/apollo-backend/static/Authorities &amp; Settings/transport-types/workflows/examples-checkpoints.png>)

W przypadku gdy status powiązany jest z etapem powiązanym kontrahentem, pod nazwą statusu zostanie wyświetlona skrócona nazwa firmy lub nazwa firmy i miasto (jeśli jest dostępne).

![](<https://docs.logintegra.com/apollo-backend/static/Authorities &amp; Settings/transport-types/workflows/customer_checkpoint.png>)

### Jak to powinno działać?

Dla każdego typu możemy przypisać odpowiednie taski w workflow. Jak mamy transport to na podstawie tasków tworzymy odpowiednie checkpointy.

Przy taskach mamy oznaczenie "Etap związany z" (w części załadunki i rozładunki) i mamy opcje:

- Magazynem,
- Kontrahentem,
- Magazynem i Kontrahentem.

To mówi nam tylko tyle: Jak masz ten task, to jak będzie step z magazynem, to na podstawie tego tasku powinien generować się checkpoint. Alternatywnie jak masz ten task, to wygeneruj mi chekpoint dla stepu bez magazynu. No i te checkpointy się generują dla każdego stepu, który spełnia warunek.

Checkpointy generują się napierw dla 1-szego stepu, potem dla drugiego, itd.

Niech oznaczenia (M - magazyn, K - kontrahent) definiują zlecenie: MKMK. Załóżmy, że mamy task przypisany do M i do K: Sprawdzenie temperatury. Reszta albo tylko M albo tylko K. Możemy mieć dla takiego transportu więc takie taski:

- Utworzenie (nie jest w sekcji załadunki i rozładunki),
- M1 wjazd,
- M1 Sprawdzenie temperatury,
- M1 rozpoczęcie,
- M1 zakończenie,
- M1 wyjazd,
- K1 Sprawdzenie temperatury,
- K1 potwierdzenie,
- M2 wjazd,
- M2 Sprawdzenie temperatury,
- M2 rozpoczęcie,
- M2 zakończenie,
- M2 wyjazd,
- K2 Sprawdzenie temperatury,
- K2 potwierdzenie,
- Wystawienie faktury (nie jest w sekcji załadunki i rozładunki)

Wtedy jak mamy chekpoint, gdzie mamy oznaczenie:

- M - ma być nazwa magazynu,
- K - ma być skrócona nazwa firmy i miejscowość (jeśli jest dostępna)

> Trzeba mieć na uwadze, że taski to taki szblon, na podstawie którego tworzone są checkpointy. I to właśnie opisy tyczą się checkpointów a nie tasków. Bo z jednego tasku mogą być różne checkpointy (z jednego tasku może być chekpoint magazynowy jak i niemagazynowy).
