# Unigis

The **Unigis** протокол — это протокол пересылки данных о местоположении транспортных средств между Navixy и TMS-платформой, разработанной компанией Unigis. Наиболее частые сценарии использования связаны с оперативным сбором данных GPS-трекинга и телематики транспортных средств отделами логистики крупных производственных и розничных сетевых компаний. Большинство таких компаний расположены в США, Мексике, Колумбии, Чили, Аргентине, Бразилии и Испании.

*Категория протокола: Соответствие требованиям предприятия*

#### Содержание

1. [Что такое Unigis?](#what-is-unigis)
2. [Техническая информация об Unigis](#tech-info-unigis)
3. [Конфигурация Unigis](#unigis-config)
4. [Настройка](#setting-up)
5. [Управление](#managing)
6. [Устранение неполадок](#troubleshooting)

### Что такое Unigis?

Через протокол пересылки данных Unigis данные GPS‑отслеживания автопарка упорядочиваются и передаются между несколькими серверами, позволяя ретрансляцию данных между Navixy и партнёрами Unigis.

С помощью протокола Unigis пользователи могут интегрироваться с сетями самообслуживания и/или поставщиками товаров и услуг в сети Unigis, такими как Walmart, Home Depot и Kimberly‑Clark. Данные автопарка могут передаваться между всеми сторонами без необходимости доступа к платформе Navixy.

### Общая техническая информация об Unigis

Протокол Unigis использует SOAP для отправки XML‑данных с трекинговых устройств в Unigis по HTTP в рамках прикладного уровня модели OSI. Данные отправляются с платформы Navixy в Unigis каждые 5 минут.

Данные, отправляемые в Unigis:

* Дата и время
* Долгота
* Широта
* Высота
* Скорость
* События входов (Inputs)
* Открытие двери
* Кнопка тревоги (Panic Button)
* Двигатель выключен
* Кража
* Внешний идентификатор (государственный номер автомобиля)

Формат: ASCII

### Конфигурация Unigis

#### Настройка

Для начала пересылки данных с использованием протокола Unigis из Navixy вам понадобятся следующие параметры:

<table><thead><tr><th width="281.6363525390625">Параметр</th><th>Пояснение</th></tr></thead><tbody><tr><td>Адрес и порт сервера назначения</td><td>URL конечной точки и порт, которые используются Ungis TMS.<br><br>Наиболее часто:<br><br>* Адрес: http://unigis2.unisolutions.com.ar/HUB/UNIGIS/MAPI/SOAP/GPS/Service.asmx<br>* Порт: 80</td></tr><tr><td>Логин и пароль</td><td>Ваш логин и пароль Unigis</td></tr><tr><td>Внешний ID</td><td>Номер государственного регистрационного знака отдельного транспортного средства</td></tr></tbody></table>

Чтобы настроить пересылку данных по протоколу Unigis:

1. Откройте настройки устройства из главного меню, нажав на значок шестерёнки внизу слева экрана.
2. Нажмите **Пересылка данных** виджет.
3. Нажмите Protocols.
4. Откроется всплывающее окно, где вы введёте требуемые параметры, нажав **+** кнопку.

Для протокола Unigis укажите следующую информацию:

1. **Название:** Введите название, чтобы этот ретранслятор было легко идентифицировать
2. **Протокол:** Выберите протокол Unigis из выпадающего списка
3. Логин и пароль Unigis
4. **Адрес сервера назначения**, например <http://unigis2.unisolutions.com.ar/HUB/UNIGIS/MAPI/SOAP/GPS/Service.asmx>
5. **Порт назначения**, например 80

Экран управления ретрансляцией должен выглядеть следующим образом, с логином и паролем Unigis. Убедитесь, что **Включено** флажок установлен и нажмите **Сохранить** кнопку для завершения процесса.

![](https://www.navixy.com/wp-content/uploads/2022/08/pasted-image-0-600x112.png)

Далее ретранслятор необходимо привязать к устройству на стороне Unigis. Для этого выберите **Связать** <img src="https://www.navixy.com/wp-content/uploads/2022/08/image-3.png" alt="link image" data-size="line"> кнопку в виджете пересылки данных. Выберите ретранслятор для подключения и нажмите **Связать** ниже.

Далее добавьте ID устройства в системе третьей стороны либо щёлкнув по значку карандаша, либо в поле внешнего ID. Это значение должно соответствовать номеру регистрационного знака на стороне Unigis. Выберите **Сохранить** после завершения.

#### Управление

Чтобы отредактировать или остановить пересылку данных, выполните следующие шаги:

1. Выберите **Значок карандаша** или нажмите в соответствующем поле, чтобы отредактировать External ID, используемый для указания устройства в системе третьей стороны.
2. Нажмите **Корзина** кнопку, чтобы остановить пересылку данных.
3. Подтвердите изменение во всплывающем окне.
4. Нажмите **Протоколы** чтобы изменить настройки ретранслятора, такие как имя, данные для входа или статус включения
5. Откроется окно управления ретрансляторами. Выберите строку для редактирования и либо нажмите на карандаш в левом верхнем углу, либо дважды щёлкните по соответствующей строке для перехода в режим редактирования. Сохраните все изменения.

![](https://www.navixy.com/wp-content/uploads/2022/08/pasted-image-0-1-600x96.png)

#### Устранение неполадок

Если данные не отображаются в сторонней системе Unigis, пожалуйста, убедитесь, что:

* Имя пользователя и пароль для Unigis введены правильно
* URL введён корректно
* Ретранслятор включён
* Внешний ID соответствует регистрационному знаку в Unigis
