Przejdź do treści

Strona może być nieaktualna

Nikt jej nie zmieniał od 36 miesięcy (ostatni commit: 2023-11-10, kamil_szulc). Jeśli opisuje stan, którego już nie ma, zgłoś ją jako nieaktualną.

Checkpoints

Statusy transportu

O generowaniu statusów w transporcie można poczytać TUTAJ.

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.

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

  • 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

  • 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:

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

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

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):

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ę):


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


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

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

  • do sekcji Historia zmian dodawany jest wpis o odrzuceniu statusu:

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

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

  • 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:

  • 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

Ostatnia zmiana: 2023-11-10 · kamil_szulc
Zbudowano: 2026-11-20 10:32 UTC · wersja 1.0.0 · rewizja: 19fcdc12e