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ę
canBeConfirmedByGuardna 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.
- 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 zmiandodawany 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
