Как настроить объекты для автоматической оплаты дорожных сборов через Toll BG

Руководство пользователя Интеграции Как настроить объекты для автоматической оплаты дорожных сборов через Toll BG

flespi
retranslators
toll_bg
integration

В этой инструкции описывается, как настроить объекты для автоматической оплаты дорожных сборов в Болгарии через систему Toll BG. Процесс настройки состоит из следующих этапов:

регистрация в системе Toll BG;
создание канала на flespi;
создание ретранслятора в Wialon;
создание устройства на flespi;
настройка плагина на flespi;
настройка потока на flespi.

После выполнения всех этапов сообщения объектов передаются из Wialon на бэкэнд-платформу flespi, где к ним добавляются необходимые для оплаты данные. Затем сообщения отправляются с flespi в систему Toll BG.

Регистрация в системе Toll BG

Для регистрации в системе Toll BG выполните следующие шаги:

Зарегистрируйтесь на сайте tollbg.eu (кнопка Request service).
Получите учетные данные и укажите регистрационные номера транспортных средств, для которых необходимо настроить автоматическую оплату дорожных сборов.
Укажите https://flespi.io/gw/hooks/toll_health в качестве конечного адреса (Endpoint), по которому должен идти запрос на платформу flespi, чтобы проверить ее состояние.

Создание канала на flespi

Чтобы платформа flespi получала сообщения объектов, передаваемые из Wialon, на ней необходимо создать канал (Channel). Для этого выполните следующие шаги:

1. Зарегистрируйтесь в телематическом хабе (Telematics Hub).

2. Откройте вкладку Channels.

3. Нажмите на кнопку в правом нижнем углу экрана.

4. В поле name укажите имя канала.

5. Активируйте опцию messages_ttl и выберите Without TTL в выпадающем списке.

6. В поле protocol_id укажите wialon_retranslator.

7. Нажмите на Save.

8. Скопируйте адрес сервера (Host) и порт (Port) созданного канала, нажав на иконку .

Создание ретранслятора в Wialon

Чтобы сообщения объектов передавались из Wialon на платформу flespi, в Wialon необходимо создать ретранслятор. Для этого выполните следующие шаги:

1. В системе управления откройте вкладку Ретрансляторы.

2. Нажмите на Создать ретранслятор.

3. Укажите имя ретранслятора.

4. Выберите Wialon Retranslator в качестве протокола ретрансляции.

5. Укажите адрес сервера (Host) и порт (Port) канала flespi в полях Сервер и Порт соответственно.

6. С помощью иконки-стрелки перенесите из списка Все объекты в список Объекты для ретрансляции те из них, для которых необходимо настроить автоматическую оплату дорожных сборов.

7. Нажмите OK.

8. Обновите страницу и запустите ретранслятор.

9. На платформе flespi щелкните по карточке канала и убедитесь, что установлено как минимум одно соединение (Connection) и на вкладке Toolbox показываются сообщения от объектов (Messages).

Нельзя изменять уникальные ID объектов для ретрансляции.

Создание устройства на flespi

Для каждого объекта, сообщения которого должны передаваться в систему Toll BG, необходимо создать устройство (Device) на платформе flespi. Чтобы создать устройство, выполните следующие шаги:

1. В телематическом хабе откройте вкладку Devices.

2. Нажмите на кнопку в правом нижнем углу экрана.

3. Выберите устройство с возможностью хранения сообщений (Device with messages storing) или без нее (Device without messages storing).

4. Активируйте опцию Device name и укажите имя устройства.

5. В поле Device type укажите тип устройства вашего объекта.

6. В разделе Device configuration укажите уникальный ID объекта (Device identifier). Для некоторых типов устройств можно также указать пароль, номер телефона и т. п.

7. Если на третьем шаге вы выбрали устройство с возможностью хранения сообщений, укажите период их хранения (Messages TTL) и допустимый размер (Messages rotation size).

8. Нажмите на Save.

Настройка плагина на flespi

Чтобы к сообщениям объектов добавлялись данные, которые требуются для системы Toll BG, на платформе flespi необходимо создать плагин (Plugin) и активировать его для устройств объектов. Для этого выполните следующие шаги:

1. В телематическом хабе откройте вкладку Plugins.

2. Нажмите на кнопку в правом нижнем углу экрана.

3. Нажмите на Plugin templates и выберите шаблон tollbg.

4. Нажмите на Save.

5. Перейдите на вкладку Devices.

6. Щелкните по карточке устройства, сообщения которого должны передаваться в систему Toll BG.

7. Откройте вкладку Plugins.

8. Нажмите на кнопку в правом нижнем углу экрана.

9. В выпадающем списке выберите плагин tollbg.

10. Активируйте опцию Axles count и укажите количество оборотов оси (необязательно).

11. В поле Plate number введите регистрационный номер транспортного средства.

12. Активируйте опцию Pan number и введите PAN-код, полученный при регистрации в системе Toll BG.

13. Активируйте опцию Weight и укажите вес транспортного средства (необязательно).

14. Нажмите на Save.

Настройка потока на flespi

Чтобы сообщения объектов с добавленными данными передавались с платформы flespi в систему Toll BG, на flespi необходимо создать поток (Stream) и привязать к нему устройства объектов. Для этого выполните следующие шаги:

1. В телематическом хабе откройте вкладку Streams.

2. Нажмите на кнопку в правом нижнем углу экрана.

3. Активируйте опцию name и укажите имя потока.

4. Активируйте опцию queue_ttl и укажите период времени, в течении которого должны храниться неотправленные сообщения, когда система Toll BG недоступна. По истечении указанного периода эти сообщения не передаются. Если сообщения должны отправляться только в реальном времени, в выпадающем списке выберите Queue with realtime delivery only. По умолчанию период хранения неотправленных сообщений при недоступности системы равен одному дню.

5. В поле protocol_id укажите tollbg.

6. В разделе configuration введите ваше имя пользователя (username) и пароль (password), используемые для авторизации в системе Toll BG.

7. Нажмите на Save.