Integracje / PUESC SENT
Integracja AI z PUESC SENT
Podłączamy PUESC przez API REST do TMS firmy i czytamy zlecenia: kody CN towaru, ilości i dane trasy. Asystent weryfikuje obowiązek SENT, buduje projekt komunikatu XML, monitoruje sygnał lokalizatora SENT-GEO i pilnuje zamknięcia zgłoszenia po dostawie.
Rozmowa trwa 15 minut. Dzwonimy my, nic nie trzeba instalować.
Po rozmowie dwa tygodnie za darmo. Jeśli uznamy, że u Was to ma sens, uruchamiamy Wam własną platformę podłączoną pod PUESC SENT. Bez umowy i bez karty.
Czym jest PUESC SENT
PUESC SENT to państwowy system monitorowania przewozu towarów wrażliwych: paliw silnikowych, olejów smarowych, alkoholu i suszu tytoniowego powyżej określonych progów. Obowiązek zgłoszenia spoczywa na nadawcy lub nabywcy przed wyjazdem, przewoźnik uzupełnia dane pojazdu i kierowcy, odbiorca zamyka je po rozładunku. System dotyczy firm transportowych, spedycji i dystrybutorów wożących towary objęte ustawą o monitorowaniu przewozu i obrotu towarami.
Na co dzień praca polega na składaniu komunikatów XML przez panel webowy PUESC lub przez API. Zgłoszenie zawiera kilkanaście pól: kod CN towaru, ilość, dane nadawcy i nabywcy z NIP albo EORI, adresy załadunku i dostawy, kraj wysyłki. Pozycję GPS kierowca przekazuje aplikacją SENT-GEO, urządzeniem ZSL w pojeździe albo własnym systemem GPS certyfikowanym przez KAS. Firma widzi wyłącznie własne zgłoszenia.
Co podłączamy w PUESC SENT
- Zlecenia TMS: kod CN towaru, ilość i próg obowiązku SENT
- Zgłoszenia PUESC: status, numer referencyjny i dane pojazdu
- Sygnał lokalizatora SENT-GEO i ZSL w aktywnych przewozach
- Komunikat XML nadawcy lub przewoźnika: projekt przed wysyłką
- Historia przewozów SENT: otwarte i zamknięte zgłoszenia miesięcznie
Zakres ustalamy pod Was. Zaczynamy od odczytu danych, a zapis i akcje włączamy dopiero wtedy, gdy sami tego chcecie.
O co pytają w praktyce
Pytania zadaje się po polsku, jak koledze z pracy.
„Czy to zlecenie wymaga zgłoszenia SENT przed wyjazdem?"
„Kierowca ma numer referencyjny i działa mu lokalizator?"
„Które zgłoszenia SENT są nadal otwarte po dostawie?"
„Ile zgłoszeń SENT złożyliśmy w tym miesiącu i ile zostało otwartych?"
Co dokładnie podłączamy w PUESC SENT
Obszar po obszarze: jakie dane czytamy i co asystent z nich robi. To lista z realnego wdrożenia, nie katalog możliwości.
CzytamyKod CN towaru, ilość i jednostka miary ze zlecenia TMS porównane z listą towarów w aktualnych rozporządzeniach KAS
AsystentOdpytuje bazę przepisów aktualizowaną przy każdej zmianie rozporządzenia i określa obowiązek SENT przed wyjazdem pojazdu
CzytamyNumer rejestracyjny pojazdu i naczepy, PESEL lub numer prawa jazdy kierowcy, identyfikator zgłoszenia SENT w PUESC
AsystentDopasowuje zgłoszenia oczekujące na dane przewoźnika do zleceń w TMS i przygotowuje komplet danych do zatwierdzenia przez dyspozytora
CzytamyZnaczniki czasu i pozycje GPS przesłane przez SENT-GEO lub ZSL, z informacją o przerwach w transmisji podczas przewozu
AsystentWykrywa luki w historii lokalizacji dłuższe niż ustalony próg i wysyła alert z numerem zgłoszenia oraz ostatnią odnotowaną pozycją pojazdu
CzytamyIdentyfikator zgłoszenia nadany przez PUESC po przyjęciu komunikatu, kontakt do kierowcy lub integracja z aplikacją flotową
AsystentZapisuje numer referencyjny do zlecenia w TMS i wysyła go kierowcy przez SMS, aplikację flotową lub wydruk przed wyjazdem
CzytamyStatus aktywnych zgłoszeń w PUESC oraz daty zakończonych dostaw odnotowanych w TMS przez dyspozytora lub system
AsystentWykrywa otwarte zgłoszenia przy dostawach oznaczonych jako wykonane i wysyła przypomnienie do osoby odpowiedzialnej po stronie odbiorcy
CzytamyOdpowiedzi testowego API KAS na wysłane komunikaty XML oraz protokoły błędów walidacji schematu SENT
AsystentWeryfikuje poprawność komunikatów XML na środowisku testowym przed uruchomieniem na koncie produkcyjnym i wychwytuje błędy mapowania pól
Co się zmienia
Dyspozytor wie przed każdym wyjazdem, że zgłoszenie SENT jest złożone, numer referencyjny przekazany i lokalizator nadaje, bez ręcznej weryfikacji w kilku systemach.
Asystent stoi na Waszym serwerze i łączy się z PUESC SENT na Waszych uprawnieniach. Dane nie wychodzą do zewnętrznych usług, a każdy odczyt i każda akcja zostawiają ślad w logu. Zakres uprawnień ustalacie Wy, więc asystent widzi dokładnie tyle, ile ma widzieć.
Nie wymieniamy Wam programu i nie zmuszamy nikogo do zmiany nawyków. PUESC SENT zostaje tam, gdzie jest, razem z historią danych i przyzwyczajeniami zespołu.
Jak łączymy się z PUESC SENT
Łączymy się z PUESC przez oficjalne API REST (w starszych modułach SOAP). Każdy komunikat XML musi być podpisany certyfikatem elektronicznym powiązanym z kontem PUESC firmy; bez ważnego podpisu PUESC odrzuca żądanie. Asystent stoi na serwerze firmy. Połączenie do PUESC jest szyfrowane, certyfikat i dane logowania trzymamy w bezpiecznym magazynie konfiguracji.
Tryb pracy: odczyt z TMS i zapis do PUESC wyłącznie po zatwierdzeniu przez dyspozytora. Żaden komunikat nie trafia do PUESC bez zgody człowieka. PUESC ogranicza liczbę zapytań w krótkim czasie; przy kilkudziesięciu zgłoszeniach dziennie limity nie są problemem, ale przy setkach wywołań integracja kolejkuje wysyłkę, żeby nie przekroczyć dopuszczalnego progu.
Czego potrzebujemy od Was
- Konto PUESC z rolą nadawcy, nabywcy lub przewoźnika i uprawnieniami do obsługi zgłoszeń SENT
- Certyfikat elektroniczny do autoryzacji maszynowej, akceptowany przez API PUESC do podpisywania komunikatów XML
- Ustrukturyzowane dane w TMS: kod CN jako osobne pole, nie tylko tekst w opisie zlecenia
- Dostęp do środowiska testowego PUESC do sprawdzenia komunikatów XML przed uruchomieniem na produkcji
- Osoba po stronie firmy znająca obsługę konta PUESC i układ danych zleceń w TMS
Gdzie to działa najlepiej
Dyspozytor transportu
Nowe zlecenie wpada do TMS: transport oleju opałowego w ilości przekraczającej próg SENT. Dyspozytor nie sprawdza ręcznie stanu zgłoszenia ani czy nadawca uzupełnił wymagane pola w PUESC, bo ma kilkanaście zleceń do obsługi naraz.
Z asystentem: Asystent weryfikuje kod CN i ilość, potwierdza obowiązek SENT, sprawdza stan zgłoszenia w PUESC i pokazuje listę warunków niegotowych przed wyjazdem. Jeden widok zamiast kilku systemów.
Kierownik floty
Pojazd z paliwem jest w trasie. Kierowca po odebraniu telefonu nieświadomie wyłączył SENT-GEO i aplikacja przestała wysyłać pozycję do PUESC. Dyspozytor skupiony na nowych zleceniach nic nie sprawdza.
Z asystentem: Asystent wykrywa przerwę dłuższą niż ustalony próg i natychmiast wysyła alert z numerem referencyjnym zgłoszenia, danymi pojazdu oraz ostatnią odnotowaną pozycją GPS.
Logistyk przewoźnika
Firma działa jako przewoźnik: nadawca złożył zgłoszenie SENT w PUESC, ale czeka ono na dane pojazdu i kierowcy. W TMS jest kilkanaście zleceń i logistyk nie wie, które zgłoszenia PUESC odpowiadają którym wyjazdom.
Z asystentem: Asystent pobiera listę oczekujących zgłoszeń z PUESC, dopasowuje je do zleceń w TMS na podstawie kontrahenta i towaru oraz przygotowuje dane do wpisania dla każdego z nich.
Jak to uruchamiamy
- Rozmowa 15 minut. Mówicie, na czym pracujecie i co Was korkuje. Mówimy, czy da się to spiąć.
- Podłączenie i pierwsze pytania. Zaczynamy od odczytu, na Waszym serwerze, w zakresie który zatwierdzacie.
- Rozszerzanie. Dokładamy kolejne moduły i akcje, gdy zespół już ufa temu, co dostaje.
Koszt: od 3 000 zł miesięcznie. W tym wdrożenie, integracja, szkolenie zespołu i opieka. Widełki na Wasz przypadek podajemy na tej pierwszej rozmowie, bez ofert na dwadzieścia stron.
Chcecie najpierw poczytać konkrety: jakie moduły ruszamy, jakie dane bierzemy i czego potrzebujemy po Waszej stronie?
Cały opis integracji z PUESC SENT →Czego asystent nie robi
Żebyście wiedzieli, gdzie kończy się jego rola, zanim zaczniecie.
- Nie wysyła komunikatu XML do PUESC bez zatwierdzenia przez dyspozytora; projekt zawsze czeka na kliknięcie.
- Nie zamyka zgłoszenia SENT w imieniu odbiorcy; wysyła wyłącznie przypomnienie do osoby odpowiedzialnej za potwierdzenie dostawy.
- Nie pobiera danych lokalizacyjnych z urządzenia kierowcy bezpośrednio; monitoruje sygnał przesłany do PUESC przez SENT-GEO lub ZSL.
- Nie ma dostępu do zgłoszeń innych firm w PUESC; działa wyłącznie na koncie firmy klienta.
Pytania o integrację z PUESC SENT
Nasz TMS nie ma oddzielnego pola na kod CN. Czy można mimo to uruchomić integrację?
Bez kodu CN w osobnym polu asystent nie może weryfikować obowiązku SENT automatycznie. Przed wdrożeniem sprawdzamy układ danych w Waszym TMS. Jeśli kod CN jest w opisie zlecenia, razem ustalamy: dodać pole do formularza, czy importować zlecenia przez plik z wymaganymi kolumnami. Zwykły krok przed startem.
Co się dzieje z naszymi zleceniami, gdy PUESC jest niedostępny lub w oknie serwisowym?
Komunikaty trafiają do kolejki i czekają na powrót połączenia. Dyspozytor dostaje informację, że PUESC jest niedostępny, żeby nie zakładać, że zgłoszenie już poszło. KAS ogłasza planowane przerwy serwisowe z wyprzedzeniem. Integracja bierze je pod uwagę i nie próbuje wysyłać komunikatów w zaplanowanym oknie.
Czy integracja obsługuje firmy, które są jednocześnie nadawcą i przewoźnikiem?
Tak, obsługujemy oba przepływy w ramach jednej integracji: złożenie zgłoszenia nadawcy i uzupełnienie danych przewoźnika w tym samym zleceniu. Asystent rozpoznaje pozycję firmy na podstawie roli przypisanej do konta PUESC i kieruje zlecenie właściwym przepływem bez ręcznego przełączania.
Jaki certyfikat elektroniczny jest potrzebny do autoryzacji w API PUESC?
PUESC wymaga certyfikatu do autoryzacji maszynowej podpisującego każdy komunikat XML. Wymagania co do rodzaju certyfikatu są w dokumentacji technicznej PUESC. Przed wdrożeniem sprawdzamy razem, czy macie już odpowiedni, czy trzeba go wyrobić. To jeden z punktów na liście przed startem, nie odkrywamy tego w trakcie.
Piętnaście minut o PUESC SENT
Wybierzcie termin z kalendarza. Na rozmowie powiemy wprost, co da się u Was podłączyć, ile to trwa i ile kosztuje. Jeśli nie ma czego automatyzować, też to powiemy. A jeśli ma, dostajecie 14 dni działającej platformy podłączonej pod PUESC SENT, żeby sprawdzić to na własnych danych zamiast wierzyć nam na słowo.
Urzędy, rejestry i zgodność
PUESC SENT jest znakiem towarowym swojego właściciela. Nie jesteśmy z nim powiązani ani przez niego autoryzowani. Nazwy używamy wyłącznie po to, żeby wskazać, z jakim programem integrujemy asystenta.