Автоматична перевірка передачі даних до платформи 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, необхідно в довільні поля внести наступні налаштування:
| Параметр | Значення | Опис |
| sent | A,B,C,D [За замовчуванням: 0,0,1800,0] | Налаштування для роботи скрипта: A: 0 - вимкнути, 1 - увімкнути роботу скрипта B: 0 - вимкнути, 1 - увімкнути зміну іконок в залежності від Статусу C: Затримка для передачи координат в PUESC/SENT. Якщо в PUESC/SENT не оновлюються координати довше визначеного параметром часу - сповіщення в телеграм канал, зміна статусу та іконки. Значення в секундах. Значення має бути більше мінімальної частоти передачи данних в систему моніторингу (під час зупинки) + невелика затримка на передачу даних в PUESC/SENT D: 0 - вимкнути, 1 - увімкнути повторення сповіщень з помилкам |
| rmpd | RMPDXXXXXXXXXX | Номер RMPD, який отримує перевізник в системі PUESC |
| zsl | ZXXXXXXXXXXXX | Номер ZSL, який формує провайдер послуг, під час реєстрації об'єкта/трекера в системі PUESC |
| tg_bot | XXXXXXXXXXXXXXXXX | ID Телеграм бота |
| tg_channel | -XXXXXXXXXX | ID Телеграм канала, починається зі знаку "-" |
Приклад налаштувань на зображенні нижче. Зверніть увагу, усі параметри вказуються маленькими літерами!!!

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

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

Як створити Телеграм канал та отримати ID каналу та бота дивіться за посиланням.
Сповіщення
Повідомлення про стан або його зміну відбувається наступним чином:
- в Телеграм канал



- в Адміністративні поля об'єкта
| Параметр | Значення | Опис |
| _Status | OK 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_ERROR зазвичай виникає, якщо сервіси PUESC не працюють, або працюють не коректно. Під час виникненні цієї помилки не радимо заїзжати на КПП на кордоні, бо Польські прикордонники користуються цим самим ресурсом і можуть виписати штраф спираючись на те, що вони не бачать даних по ТЗ (хоча дані в системі PUESC є, але вони не відображаються в наслідок проблем в роботі сервісу). Про збої в роботі сервісу можна почитати на сторінці новин.
По можливості, програмний модуль буде надавати причиниму виникнення PUESC_ERROR

- іконкою об'єкта (має бути увімкнутий параметр sent: A,1,C,D)
| Зображення | Статус |
![]() | Status: OK Зелена іконка |
![]() | Status: 200 Червона іконка |
![]() | Status: 500 Синя іконка |
![]() | Status: OLD_GEODATA Червона іконка |
![]() | Status: PUESC_ERROR Червона іконка |
![]() | Status: [Інша помилка] Червона іконка |
Для генерації сповіщення в Польщі можете тимчасово встановити параметр sent:A,B,1800,D на невелике значення - sent: A,B,1,D, маєте отримати сповіщення в телеграм канал та зміну іконки. Усі інші налаштування також мають бути внесені. Перевірка статусу відбувається кожні 10 хвилин. Після перевірки поверніть параметр на потібне значення.
Програмний модуль та алгоритми його роботи на стадії впровадження. В процесі впровадження можуть відбуватись зміни. Усі зміни будуть відображені в цій документації, тому радимо час від часу переглядати документацію.





