Instrukcja rejestracji usługi ZSL, urządzeń GPS i wypełniania zgłoszeń przewozu w zakresie modułu SENT-GEO

  • Operator musi posiadać ZAAWANSOWANY poziom dostępu do Platformy PUESC.
  • Operator rejestruje usługę ZSL (SENT460).
  • Operator otrzymuje numer usługi ZSL, hasło operatora i hasło startowe przewoźnika (SENT461).
  • Operator może aktualizować swoje dane (SENT462 >>> Zarządzanie usługą >>> Edytuj -  SENT 463).
  • Operator przekazuje numer usługi ZSL i hasło startowe przewoźnikowi.
  • Przewoźnik loguje się do platformy PUESC, a następnie przy pomocy numeru usługi ZSL i hasła startowego rejestruje swoje dane oraz dodaje identyfikatory techniczne urządzeń GPS (SENT470).
  • Przewoźnik otrzymuje nowe hasło oraz numery urządzeń powiązanych z usługą ZSL (SENT471).
  • Przewoźnik może aktualizować swoje dane oraz dodawać kolejne lub usuwać istniejące identyfikatory techniczne urządzeń GPS powiązanych z usługą ZSL (SENT472 >>> Zarządzanie urządzeniami >>> Edytuj - SENT473).
  • Przewoźnik wypełniając zgłoszenie przewozu, wprowadza dany numer urządzenia oraz współrzędne miejsca załadunku towaru i/lub współrzędne miejsca dostarczenia towaru. Urządzenie aktywuje się w systemie po wysłaniu pierwszego zgłoszenia przewozu.
 

Przesyłanie danych lokalizacyjnych przez operatorów ZSL do modułu SENT GEO winno mieć miejsce każdorazowo w przypadku zaistnienia jednego z poniższych kryteriów:

  1. maksymalnie po przejechaniu 1 km albo po upływie 1 minuty w zależności, które zdarzenie wystąpi później, ale nie rzadziej niż co 5 minut;
  2. przy zmianie azymutu kierunku jazdy środka transportu o wartość równą lub większą niż 40 stopni;
  3. przy postoju środka transportu, przy włączonym sliniku, co 5 minut;
  4. przed wyłączeniem slinika, wskazując gdzie pojazd się zatrzymał na dłuższą przerwą wynikająca z przepisów związanych z czasem pracy kierowcy oraz po włączeniu slinika, tym samym wskazując zakończenie przerwy.

Dane lokalizacyjne spełniające powyższe warunki powinny być przekazywane z urządzenia lokalizacyjnego do modułu SENT GEO z opóźnieniem nie większym niż 1 minuta. Dane lokalizacyjne zebrane przez urządzenie lokalizacyjne mogą być buforowane przez operatorów ZSL, a następnie w cyklu nie dłuższym niż 1 minuta wysyłane w pakietach do modułu SENT GEO, z zachowaniem ograniczenia na wielkość, która wynosi 500 KB oraz na liczbę pozycji minimalną 1, a maksymalną 500. Dane, których wielkość przekracza 500 KB lub/i 500 pozycji powinny zostać podzielone na odpowiednią liczbę pakietów. Dane w ramach pakietu mogą pochodzić z różnych urządzeń i spełniać różne powyżej zdefiniowane kryteria.

Przykłady do kryterium nr 1:
  1. 30 km/h – później występuje kryterium 1 km - przejechany 1 km, próbka wysłana po 2 min,
  2. 60 km/h – kryterium 1 km i 1 min występuje w tym samym momencie - przejechany 1 km, próbka wysłana po 1 min,
  3. 90 km/h – później występuje kryterium 1 min – przejechane 1,5 km, próbka wysłana po 1 min,
  4. 120 km/h – później występuje kryterium 1 min – przejechane 2 km, próbka wysłana po 1 min.

Do 31 grudnia 2018 r. obowiązuje: schemat JSON sgdi_rest_request_schema_v_0_5.json. Natomiast od 1 stycznia 2019 r. obowiązuje schemat: JSON sgdi_rest_request_schema_v_0_6.json. Niezastosowanie się do powyższych reguł spowoduje niedopełnienie po stronie przewoźników obowiązków wynikających z art. 10a ustawy o systemie monitorowania drogowego i kolejowego przewozu towarów.

Przekazywane dane będą weryfikowane pod kątem spełnienia powyższych kryteriów. W przypadku stwierdzenia ich przekroczenia Operatorzy ZSL będą cyklicznie informowani o stwierdzonych nieprawidłowościach celem ich usunięcia.

 

 

 

Przypominamy, że od 1 stycznia 2019 r. obowiązuje nowa schema (sgdi_rest_request_schema_v_0_6.json) do walidacji danych przekazywanych za pośrednictwem ZSL. W schemie tej jako pola obowiązkowe zostały oznaczone pola:

  1. lat (szerokość geograficzna)
  2. lon (długość geograficzna)
  3. tsp (data i czas próbki)
  4. dev (identyfikator techniczny urządzenia)
  5. brg (azymut w stopniach)
  6. acc (dokładność w metrach)
  7. spd (prędkość w metrach na sekundę)

Przesyłanie danych niezgodnych ze schemą sgdi_rest_request_schema_v_0_6.json po 31 stycznia 2019 roku będzie skutkowało odrzucaniem przesyłanych na interfejs danych.
Prosimy o jak najszybsze dostosowanie się do wprowadzonych zmian.

Pragniemy także zwrócić uwagę na często występujące błędy w przesłanych danych:

  1. Pole dev - przesyłanie numeru lokalizatora GPS (Znn-xxnnxx-n) w miejscu identyfikatora technicznego urządzenia.
  2. Pole dev - Przesyłanie numeru lokalizatora w postaci innej niż została zarejestrowana w SENT_47x (np. zmiana wielkości liter, dodanie prefiksu lub sufiksu).
  3. Pola lat - przesyłanie danych spoza granic kraju. Dane, które nie mieszczą się w przedziale 49.0 - 54.835778 nie powinny być przesyłane.
  4. Pola lon - przesyłanie danych spoza granic kraju. Dane, które nie mieszczą się w przedziale 14.116667 - 24.15 nie powinny być przesyłane.
  5. Pole tsp - przesyłanie danych z przyszłości, spowodowane nieprawidłowa implementację stref czasowych (timestamp wyznacza się dla czasu UTC).
  6. Pola lat i lon - zbyt duża dokładność. Dozwolone jest maksymalnie 10 cyfr po kropce dziesiętnej.
  7. Pole spd - dane w tym polu muszą być przesyłane w metrach na sekundę.
  8. Pole id - przesyłanie stałej wartości w polu ID. Pole to jest identyfikatorem rekordu, w związku z czym, każdy przesłany przez Państwa rekord danych powinien mieć w tym polu inną wartość. Może to być np. klucz tabeli z danymi gps po państwa stronie. Pole to jest nieobowiązkowe.

W przypadku 1) i 2) przesłanie błędnych danych nie skutkuje zwróceniem błędu, gdyż zgodnie z ustaleniami ZSL może wysyłać dane wszystkich pojazdów, nawet tych niezarejestrowanych. Od 1 lutego 2019 r. wysłanie takich danych będzie skutkowało dodaniem ostrzeżenia w odpowiedzi.
W przypadku 2) w celu minimalizacji ilości błędów w przesyłanych danych od 1 lutego 2019 r. wielkość liter w identyfikatorze nie będzie brana pod uwagę.
W przypadku 3), 4), 6) i 7) przesłanie takich danych skutkuje błędem 400. Jeżeli paczka danych zawiera więcej niż jeden rekord, to wystąpienie tych błędów (a także innych błędów niezgodności ze schemą) w przynajmniej jednym rekordzie spowoduje odrzucenie całej paczki i konieczność ponownego przesłania danych z pominięciem błędnych rekordów.
W przypadku 5) dane zostaną przyjęte. Od 1 lutego 2019 r. takie dane będą powodowały zwrócenie w odpowiedzi ostrzeżenia. W przyszłości takie dane mogą być odrzucane.
W przypadku 8) dane zostaną przyjęte.

W celu weryfikacji poprawności przesyłania danych prosimy o korzystanie z interfejsów testowych. Interfejsy testowe można rejestrować za pośrednictwem https://test.puesc.gov.pl/. Obecnie interfejsy testowe działają zgodnie ze schemą sgdi_rest_request_schema_v_0_6.json i są wzbogacone o dodatkowe ostrzeżenia w odpowiedzi.

 

 

 

Od 1 kwietnia 2019 roku obowiązuje wydanie 0.61 schematu JSON (sgdi_rest_request_schema_v_0_6_1.json). Wprowadzone zmiany dotyczą odrzucania danych, których współrzędne są spoza obszaru Polski. Szczegóły znajdują się w załączonej poniżej instrukcji.

 

Szczegółowa instrukcja użytkownika

Specyfikację techniczną usługi SENT-GEO

 

  NAZWA FORMULARZA WYPEŁNIAJĄCY OPIS
SENT460 - REJESTRACJA USŁUGI ZSL OPERATOR USŁUG ZSL Rejestracja usługi zewnętrznych systemów lokalizacyjnych (ZSL) przez operatorów
SENT462 - AKTUALIZACJA DANYCH REJESTRACYJNYCH USŁUGI ZSL OPERATOR USŁUG ZSL Podgląd i edycja danych rejestracyjnych usługi ZSL, zmiana hasła operatora, wyświetlenie listy usług ZSL świadczonych przez operatora
SENT470 - REJESTRACJA URZĄDZEŃ GPS W RAMACH USŁUGI ZSL PRZEWOŹNIK - UŻYTKOWNIK URZĄDZEŃ GPS Rejestracja przez przewoźników urządzeń GPS w ramach usługi zewnętrznych systemów lokalizacyjnych ZSL
SENT472 - AKTUALIZACJA DANYCH REJESTRACYJNYCH PRZEWOŹNIKA ORAZ DODAWANIE/USUWANIE URZĄDZEŃ GPS W RAMACH USŁUGI ZSL PRZEWOŹNIK - UŻYTKOWNIK URZĄDZEŃ GPS Podgląd i edycja danych rejestracyjnych przewoźnika oraz urządzeń GPS, zmianą hasła przewoźnika, wyświetlenie listy zarejestrowanych urządzeń GPS w ramach usługi ZSL

 

* ustawa z dnia 9 marca 2017 r. o systemie monitorowania drogowego i kolejowego przewozu towarów (Dz. U. poz. 708, z późn. zm.)

** rozporządzenie Ministra Finansów z dnia 19 września 2018 r. w sprawie zgłoszeń przewozu towarów (Dz. U. poz. 1849)

 

 

Komunikaty

history image 27.09.2019 Awaria systemu SENT-GEO

Informujemy, że dniu 27.09.2019r. około godziny 15:00 nastąpiła awaria systemu SENT-GEO. Awaria...

history image SENT – prace serwisowe

Uprzejmie informujemy, że w dniu 15.08.2019 r. w godzinach od 22:00 do 24:00 mogą wystąpić...
Wyświetlanie 1 - 3 z 66 rezultatów.
Pozycji na stronę 3
z 22

Przydatne linki

HELP DESK - infolinia i pomoc dotyczące systemu SENT

AWARIA SENT - Instrukcja postępowania w przypadku niedostępności rejestru zgłoszeń SENT

DOKUMENT ZASTĘPUJACY ZGŁOSZENIE - wzór

FAQ - najczęściej zadawane pytania dotyczące systemu SENT

REJESTRACJA NA PUESC - dla potrzeb dokonywania zgłoszeń do rejestru SENT (obowiązuje od 1.09.2019 r.)

INSTRUKCJA REJESTRACJI NA PUESC - KROK PO KROKU

SENT-GEO - USŁUGI I URZĄDZENIA ZSL - Instrukcja rejestracji usług i urządzeń ZSL

SENT-GEO - LOKALIZATORY - Instrukcja instalacji i obsługi Aplikacji kierowcy SENT-GEO


AKTY PRAWNE

OBOWIĄZUJĄCE
OCZEKUJĄCE
ARCHIWALNE

MATERIAŁY SZKOLENIOWE

Zgłoszenie przewozu towaru rozpoczynającego się na terytorium Polski (SENT_100)

Zgłoszenie przewozu towaru kończącego się na terytorium Polski (SENT_200)

Zgłoszenie przewozu towaru rozpoczynającego i kończącego się poza terytorium Polski (SENT_300)


AKTUALNOŚCI

history image 03.10.2019 SENT GEO - Przypomnienie o odnowieniu certyfikatów usług ZSL

Uwaga na wygasanie certyfikatu X.509 klienta SSL/TLS po stronie ZSL. Usługa ZSL...

history image SENT - Spotkanie dot. rozporządzenia w sprawie dodatkowych danych (LPG)

Ministerstwo Finansów informuje, że 7 października 2019 r. o godz. 12.30 w budynku MF (sala...

history image 13.09.2019 SENT - Nowa Specyfikacja Techniczna Komunikatów

Na stronie w zakładce Katalog e-Usług > e-Przewóz została opublikowana nowa Specyfikacja...
Wyświetlanie 1 - 3 z 36 rezultatów.
Pozycji na stronę 3
z 12