## Statusy transportu

O generowaniu statusów w transporcie można poczytać [TUTAJ](<https://docs.logintegra.com/apollo-backend/6. Authorities &amp; Settings/transport-types/workflows/index.md>).

### Uprawnienia do statusów

Uprawnienia do statusu przechowywane są w tabli `authority_restrictions`. W kolumnie `authority_id` możemy wprowadzić referencję do następujących `authority`:

```
ROLE_CAN_ACCESS_TASK - widoczność statusu w oknie do potwierdzania  
ROLE_CAN_CONFIRM_TASK - wyświetlenie przycisku do potwierdzania  
ROLE_CAN_REVOKE_TASK - wyświetlenie przycisku do wycofania statusu  
ROLE_CAN_REJECT_TASK - wyświetlenie przycisku do odrzucenia statusu (w wierszu transportu)
```

### Potwierdzanie statusów

Żeby status mógł być potwierdzony przez użytkownika z daną rolą należy:  
\- dodać odpowiedni wpis w `authority_restrictions` - `ROLE_CAN_CONFIRM_TASK`

Sytuacje wyjątkowe:

```
Jeśli w tabeli `task` ustawimy flagę `canBeConfirmAfterAddingDocumentsForTransport` na 'true' 
to przycisk do potwierdzania będzie zablokowany do momentu dodania jakiegoś dokumentu do zlecenia.
```

> UWAGA ! Do potwierdzania statusu nie można liczyć automatycznie generowanych dokumentów

Status można potwierdzić w następujące sposoby:

- w tabeli transportów po kliknięciu w kolumnie status w jego nazwę pojawia się okno ze szczegółami statusów, a w nim przycisk do potwierdzenia.

![](<https://docs.logintegra.com/apollo-backend/static/Transports/process/checkpoints/confirmInCheckpointsDetails.png>)

- w tabeli transportów po kliknięciu nr zlecenia pojawia się okno ze szczegółami transportu, a w nim przycisk do potwierdzenia statusu.

![](<https://docs.logintegra.com/apollo-backend/static/Transports/process/checkpoints/confirmInTransportDetails.png>)

- w tabeli transportów na koncie ochrony jeśli w tabeli task ustawimy flagę `canBeConfirmedByGuard` na true, w kolumnach odpowiadającym nazwom statusów będą widoczne przyciski do potwierdzenia

> UWAGA: W przypadku statusów posiadających subtaski (`Task#subTasks`), statusy o tych samych aliasach są agregowane i wyświetlamy tylko 1 kolumnę dla danej grupy statusów. Daty kolejnych potwierdzeń statusów o tym samym aliasie wyświetlane są pod przyciskiem do zatwierdzania. ![Guard aggregated checkpoints](<https://docs.logintegra.com/apollo-backend/static/Transports/process/checkpoints/guard-aggregated-checkpoints.png>)

![](<https://docs.logintegra.com/apollo-backend/static/Transports/process/checkpoints/confirmByGuard.png>)

- poprzez SK API dla swiss-krono załadunki i dostawy
- poprzez publiczne API

#### Podanie rzeczywistej daty potwierdzenia statusu

W przypadku potwierdzania statusu przez platformę domyślnie data oraz godzina potwierdzenia ustawiana jest na moment wykonania tej akcji.

W celu podania rzeczywistej daty potwierdzenia statusu przez użytkownika z daną rolą należy:  
\- dodać odpowiedni wpis w `authority_restriction` - `ROLE_CAN_ADD_CONFIRMATION_DATE_TASK`

Podanie rzeczywistej daty potwierdzenia statusu możliwe jest w okienku statusów oraz formularzu transportu po zaznaczeniu opcji `Podanie rzeczywistej daty potwierdzenia statusu`:

![](<https://docs.logintegra.com/apollo-backend/static/Transports/process/checkpoints/actualConfirmationDateCheckboxPopup.png>)

![](<https://docs.logintegra.com/apollo-backend/static/Transports/process/checkpoints/actualConfirmationDateCheckboxModal.png>)

Wartość pola domyślnie wypełniona będzie aktualną datą oraz czasem:

![](<https://docs.logintegra.com/apollo-backend/static/Transports/process/checkpoints/actualConfirmationDateInputPopup.png>)

![](<https://docs.logintegra.com/apollo-backend/static/Transports/process/checkpoints/actualConfirmationDateInputModal.png>)

Po wybraniu odpowiedniej daty oraz czasu w polu `Rzeczywista data potwierdzenia` można potwierdzić status poprzez kliknięcie klawisza `Potwierdź`.  
Status potwierdzi się z wybraną datą oraz czasem przypisanym do pola `executionDate` w bazie danych.

> Wybrana data potwierdzenia statusu musi spełniać następujące warunki: - data musi być z przeszłości  
> \- data musi być późniejsza niż data potwierdzenia poprzedniego etapu

![](<https://docs.logintegra.com/apollo-backend/static/Transports/process/checkpoints/actualConfirmationDateErrorPopup.png>)

![](<https://docs.logintegra.com/apollo-backend/static/Transports/process/checkpoints/actualConfirmationDateErrorModal.png>)

### Odznaczanie statusów

Żeby status mógł być odznaczony przez użytkownika z daną rolą należy:  
\- dodać odpowiedni wpis w `authority_restriction` - `ROLE_CAN_REVOKE_TASK`  
\- flaga `canBeRevoked` w tabeli `task` musi być ustawiona na wartość `true`  
\- rola użytkownika musi mieć uprawnienie (Authority): `ROLE_REVOKE_CHECKPOINT`

Odznaczenie statusu możliwe jest poprzez kliknięcie klawisza przy odpowiednim statusie (w oknie statusów):

![](<https://docs.logintegra.com/apollo-backend/static/Transports/process/checkpoints/revokeCheckpoint.png>)

### Odrzucanie statusów

Żeby status mógł być odrzucony przez użytkownika z daną rolą należy:  
\- dodać odpowiedni wpis w `authority_restriction` - `ROLE_CAN_REJECT_TASK`  
\- flaga `canBeRejected` w tabeli `task` musi być ustawiona na wartość `true`  
\- rola użytkownika musi mieć uprawnienie (Authority): `ROLE_REJECT_CHECKPOINT`

---

Ochrona - Odrzucenie statusu możliwe jest poprzez kliknięcie klawisza przy odpowiednim statusie w wierszu transportu (rola musi mieć włączoną odpowiednią kolumnę):

![](<https://docs.logintegra.com/apollo-backend/static/Transports/process/checkpoints/rejectCheckpoint.png>)

---

Admin - Odrzucenie statusu możliwe jest poprzez kliknięcie klawisza przy odpowiednim statusie w szczegółach zlecenia lub tabeli transportów:

![](<https://docs.logintegra.com/apollo-backend/static/Transports/process/checkpoints/book-of-disinfection.png>)

![](<https://docs.logintegra.com/apollo-backend/static/Transports/process/checkpoints/book-of-disinfection-2.png>)

---

Po kliknięciu w klawisz `Odrzuć` zostanie wyświetlone okno potwierdzenia:

![](<https://docs.logintegra.com/apollo-backend/static/Transports/process/checkpoints/rejectCheckpointAlert.png>)

Po odrzuceniu statusu dzieją się następujące rzeczy:  
\- do transportu dodawana jest notatka mówiąca o odrzuceniu statusu:

![](<https://docs.logintegra.com/apollo-backend/static/Transports/process/checkpoints/rejectCheckpointNote.png>)

- do sekcji `Historia zmian` dodawany jest wpis o odrzuceniu statusu:

![](<https://docs.logintegra.com/apollo-backend/static/Transports/process/checkpoints/rejectCheckpointHistory.png>)

- wysyłany jest e-mail do użytkowników przwoźnika oraz dostawcy przypisanych do transportu (jeśli mają włączone odpowiednie powiadomienie):

![](<https://docs.logintegra.com/apollo-backend/static/Transports/process/checkpoints/rejectCheckpointEmail.png>)

![](<https://docs.logintegra.com/apollo-backend/static/Transports/process/checkpoints/rejectCheckpointHistoryEmail.png>)

> powiadomienie, które musi użytkownik mieć włączone aby otrzymać e-mail po odrzuceniu statusu:

![](<https://docs.logintegra.com/apollo-backend/static/Transports/process/checkpoints/rejectCheckpointNotification.png>)

- pod klawiszami statusu (w wierszu transportu) oraz `Odrzuć` pojawia się data odrzucenia. Zawsze jest to ostatnia data odrzucenia, więc po ponownym odrzuceniu zostanie ona zaktualizowana:

![](<https://docs.logintegra.com/apollo-backend/static/Transports/process/checkpoints/rejectCheckpointDate.png>)

- klawisz `Odrzuć` pozostaje aktywny (odrzucanie statusu można ponawiać wielokrotnie)

### Blokada potwierdzenia statusu związana z polami niestandarowymi

Dokumentacja dostępna pod linkiem:  
[Blokada potwierdzenia statusu związana z polami niestandarowymi](<https://docs.logintegra.com/apollo-backend/1. Transports/form/custom-fields/checkpoint-blockade/index.md>)
