Перейти до основного вмісту

Автоматична перевірка передачі даних до платформи PUESC / SENT

Критично важливо

Для передачі даних в PUESC/SENT паралельно з трекером використовуйте мобільний застосунок як резервний канал передачі. Детальніше за посиланням!!!

Критично важливо

Програмний модуль працює для наших Клієнтів та Партнерів за моделлю "як є". Надається на наших серверах безкоштовно та ми не несемо відповідальність якщо з якихось причин він буде працювати некоректно (не сповістить про проблему).

Критично важливо

Програмний модуль буде працювати коректно, тільки якщо необхідні дані (zsl, rmpd, номер ТЗ) будуть вноситсь в налаштування об'єкта коректно та вчасно (відразу після отримання).

Для запобігання штрафів нами був розроблений програмний модуль, який в автоматичному режимі виконує перевірку ZSL/RMPD на наявність помилок через форму 406.

Усі дані для перевірки беруться з налаштувань об'єктів, для яких необхідно робити перевірку. Ці об'єкти мають бути додані для передачі данних, відповідно алгоритму.

Логіка роботи

Користувачі можуть самостійно вмикати/вимикати перевірку на надсилання сповіщень в Телеграм. Перевірка відбувається лише для тих об'єктів, для яких виконується наступні умови:

  • для об'єкта увімкнута перевірка (sent:1,B,C,D)
  • об'єкт знаходиться в геозоні POLAND_SENT (це геозона, яка створена нами в системі моніторингу, ця геозона повторює контур Польщі та охоплює пропускні пункті на території України)

Програмний модуль виконує перевірку кожні 10 хвилин для необхідних об'єктів.

Сповіщення в Телеграм можуть надчилатись або при зміні Статусу, або кожен раз, коли фіксується помилка (див. параметр sent: ..,..,..,D)

Якщо Вам необхідно вимкнути сповіщення - змініть налаштування об'єкта (sent: 0,B,C,D), перевірка припиниться і сповіщення перестануть надходити.

Налаштування

Для об'єкта, який необхідно перевіряти на помилки по формі 406, необхідно в довільні поля внести наступні налаштування:

ПараметрЗначенняОпис
sentA,B,C,D
[За замовчуванням: 0,0,1800,0]
Налаштування для роботи скрипта:
A: 0 - вимкнути, 1 - увімкнути роботу скрипта
B: 0 - вимкнути, 1 - увімкнути зміну іконок в залежності від Статусу
C: Затримка для передачи координат в PUESC/SENT. Якщо в PUESC/SENT не оновлюються координати довше визначеного параметром часу - сповіщення в телеграм канал, зміна статусу та іконки. Значення в секундах. Значення має бути більше мінімальної частоти передачи данних в систему моніторингу (під час зупинки) + невелика затримка на передачу даних в PUESC/SENT
D: 0 - вимкнути, 1 - увімкнути повторення сповіщень з помилкам
rmpdRMPDXXXXXXXXXXНомер RMPD, який отримує перевізник в системі PUESC
zslZXXXXXXXXXXXXНомер ZSL, який формує провайдер послуг, під час реєстрації об'єкта/трекера в системі PUESC
tg_botXXXXXXXXXXXXXXXXXID Телеграм бота
tg_channel-XXXXXXXXXXID Телеграм канала, починається зі знаку "-"

Приклад налаштувань на зображенні нижче. Зверніть увагу, усі параметри вказуються маленькими літерами!!!

Автоматична перевірка передачи даних до платформи PUESC / SENT

Також обов'язково в Характеристиках об'єкта вказати Реєстраційний знак ТЗ, в такому самому форматі, в якому він реєструвався для RMPD.

Автоматична перевірка передачи даних до платформи PUESC / SENT

Реєстраційний знак ТЗ має складатись з цифр та букв латинського алфавіту. Наприклад, номери CA0000CB (латиниця) та СА000СВ (кирилиця) різні номери, хоча виглядають однаково. Програмний модуль приймає лише латинський букви. В іншому випадку записує номер як ERROR, з таким номером статус буде PUESC_ERROR, а в повідомлені в телеграм замість номера буде ERROR. Щоб виправити цю помилку - запишить коректно номер, відповідно до вимог наданих вище.

Приклад повідомленя для ТЗ з некоректним номером та коректними rmpd та zsl ниже:

Автоматична перевірка передачи даних до платформи PUESC / SENT
Зверніть увагу

Як створити Телеграм канал та отримати ID каналу та бота дивіться за посиланням.

Сповіщення

Повідомлення про стан або його зміну відбувається наступним чином:

  • в Телеграм канал
Автоматична перевірка передачи даних до платформи PUESC / SENTАвтоматична перевірка передачи даних до платформи PUESC / SENTАвтоматична перевірка передачи даних до платформи PUESC / SENT
  • в Адміністративні поля об'єкта
ПараметрЗначенняОпис
_StatusOK
200
500
OLD_GEODATA
PUESC_ERROR
[Інша помилка]
Статус, взятий з форми 406. Якщо помилка не визначена, то записується її текст. Визначені помилки:
200 - помилка координат
500 - помилка координат
OLD_GEODATA - координати не оновлюються довже ніж визначено параметром (за замочуванням 1800 с/30 хв)
PUESC_ERROR - сервер PUECS не відповідає, або у відповіді присутні не усі необхідні дані

OK - помилки відстуні
_Status_DateРРРР-ММ-ДД ГГ:ХХ:ССДата та час запиту до форми 406
_Status_Date_TrackerРРРР-ММ-ДД ГГ:ХХ:СС (PL +1)Дата та час координати, яку останню отримав PUESC/SENT. В дужках вказано що час Польский та яка різниця в годинах з Українським часом.
Автоматична перевірка передачи даних до платформи PUESC / SENT

Помилка PUESC_ERROR зазвичай виникає, якщо сервіси PUESC не працюють, або працюють не коректно. Під час виникненні цієї помилки не радимо заїзжати на КПП на кордоні, бо Польські прикордонники користуються цим самим ресурсом і можуть виписати штраф спираючись на те, що вони не бачать даних по ТЗ (хоча дані в системі PUESC є, але вони не відображаються в наслідок проблем в роботі сервісу). Про збої в роботі сервісу можна почитати на сторінці новин.

По можливості, програмний модуль буде надавати причиниму виникнення PUESC_ERROR

Автоматична перевірка передачи даних до платформи PUESC / SENT
  • іконкою об'єкта (має бути увімкнутий параметр sent: A,1,C,D)
ЗображенняСтатус
Автоматична перевірка передачи даних до платформи PUESC / SENT
Status: OK
Зелена іконка
Автоматична перевірка передачи даних до платформи PUESC / SENT
Status: 200
Червона іконка
Автоматична перевірка передачи даних до платформи PUESC / SENT
Status: 500
Синя іконка
Автоматична перевірка передачи даних до платформи PUESC / SENT
Status: OLD_GEODATA
Червона іконка
Автоматична перевірка передачи даних до платформи PUESC / SENT
Status: PUESC_ERROR
Червона іконка
Автоматична перевірка передачи даних до платформи PUESC / SENT
Status: [Інша помилка]
Червона іконка
Зверніть увагу

Для генерації сповіщення в Польщі можете тимчасово встановити параметр sent:A,B,1800,D на невелике значення - sent: A,B,1,D, маєте отримати сповіщення в телеграм канал та зміну іконки. Усі інші налаштування також мають бути внесені. Перевірка статусу відбувається кожні 10 хвилин. Після перевірки поверніть параметр на потібне значення.

Зверніть увагу

Програмний модуль та алгоритми його роботи на стадії впровадження. В процесі впровадження можуть відбуватись зміни. Усі зміни будуть відображені в цій документації, тому радимо час від часу переглядати документацію.