> For the complete documentation index, see [llms.txt](https://navixy.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://navixy.com/docs/user/ru/guide/devices-and-settings/connectivity/data-forwarding/unigis.md).

# Unigis

Передавайте GPS- и телематические данные из Navixy на платформу Unigis TMS, отправляя по одной позиции в минуту на каждое транспортное средство по HTTP.

Unigis — это система управления транспортом, а протокол ретрансляции данных Unigis передает в нее местоположения транспортных средств из Navixy. Логистические отделы производственных и розничных компаний используют ее для получения данных от своих перевозчиков, включая поставщиков таких сетей, как Walmart, Home Гараж и Kimberly-Clark. Перевозчик может отправлять данные в Unigis, не предоставляя принимающей компании доступ к учетной записи Navixy.

Unigis наиболее распространена среди компаний в США, Мексике, Колумбии, Чили, Аргентине, Бразилии и Испании.

В Navixy выберите **UNIGIS** в **Протокол** раскрывающемся списке. Так Unigis называется в интерфейсе.

## Что отправляет Navixy

Navixy отправляет один HTTP POST-запрос для каждого местоположения в `LoginYInsertarEvento` метод конечной точки Unigis. Тело запроса закодировано в формате формы и содержит следующие поля:

| Поле                             | Содержимое                                                                          |
| -------------------------------- | ----------------------------------------------------------------------------------- |
| `SystemUser` и `Пароль`          | Учетные данные Unigis из конфигурации ретранслятора, отправляемые с каждым запросом |
| `Dominio`                        | Внешний ID устройства или идентификатор устройства Navixy, если External ID пуст    |
| `Codigo`                         | Код события Navixy для этого сообщения                                              |
| `Latitud`, `Longitud`, `Altitud` | Положение в градусах, высота в метрах                                               |
| `Velocidad`                      | Скорость                                                                            |
| `Rumbo`                          | Направление движения                                                                |
| `FechaHoraEvento`                | Когда устройство зафиксировало позицию, в формате ISO 8601                          |
| `FechaHoraRecepcion`             | Время получения сообщения Navixy в формате ISO 8601                                 |

Такие события, как тревога двери, нажатие тревожной кнопки «SOS» или выключение двигателя, не являются отдельными полями. Каждое из них поступает в виде значения в `Codigo` в сообщении, которое о нем сообщает.

Unigis отвечает на каждый запрос числовым кодом. Отрицательный код означает, что Unigis отклонила местоположение, и Navixy закрывает соединение и повторяет попытку.

### Когда Navixy отправляет

Navixy отправляет не более одного местоположения в минуту для каждого устройства. Если устройство передает данные чаще, промежуточные местоположения пропускаются, а не ставятся в очередь, поэтому данные в Unigis представляют собой минутную выборку, а не полный трек.

Два правила отменяют ограничение в одну минуту:

* Срочное событие отправляется сразу после поступления, даже если предыдущее местоположение было отправлено менее минуты назад.
* Сообщение без корректных координат никогда не отправляется независимо от времени его поступления.

## Перед началом

Получите в Unigis следующее:

* Адрес и порт конечной точки. Unigis использует несколько хабов, поэтому уточните, какой из них относится к вашей учетной записи.
* Логин и пароль Unigis. Navixy требует оба значения и не сохранит ретранслятор без них.

Также необходим гос. номер в том виде, в котором он зарегистрирован в Unigis; его нужно указать в поле External ID каждого устройства. Navixy принимает здесь любое непустое значение, поэтому гос. номер, не совпадающий с записью Unigis, будет принят при сохранении, а затем отклонен Unigis.

## Настройка ретрансляции

{% stepper %}
{% step %}

### Откройте блок «Ретрансляция»

Перейдите **Управление устройствами**, выберите устройство, затем найдите **Ретрансляция** блок.
{% endstep %}

{% step %}

### Откройте список протоколов

Нажмите **Протоколы**, затем нажмите **+** чтобы добавить конфигурацию.
{% endstep %}

{% step %}

### Введите настройки Unigis

Заполните поля следующим образом:

* **Название**: метка, идентифицирующая этот ретранслятор
* **Протокол**: **UNIGIS**
* **Адрес**: адрес конечной точки из Unigis, например `http://unigis2.unisolutions.com.ar/HUB/UNIGIS/MAPI/SOAP/GPS/Service.asmx`
* **Порт**: порт из Unigis, обычно `80`
* **Вход** и **Пароль**: учетные данные Unigis

Если вы вводите адрес без пути, Navixy использует `/HUB/UNIGIS/MAPI/SOAP/COMMServer/service.asmx`. Введите полный адрес, предоставленный Unigis, вместо использования этого адреса по умолчанию.
{% endstep %}

{% step %}

### Включите и сохраните

Включите **Включено**, затем нажмите **Сохранить**. Ретранслятор, который не включен, ничего не отправляет.
{% endstep %}

{% step %}

### Привяжите ретранслятор к устройству

В блоке устройства **Ретрансляция** включите переключатель для созданного вами ретранслятора, затем нажмите **Сохранить**.
{% endstep %}

{% step %}

### Задайте External ID

Нажмите значок ссылки справа от строки ретранслятора, затем введите гос. номер в том виде, в котором он зарегистрирован в Unigis. Нажмите **Сохранить**.

Повторите этот и предыдущий шаг для каждого устройства, выполняющего ретрансляцию в Unigis. Конфигурация ретранслятора используется всей учетной записью, но External ID задается для каждого устройства отдельно.
{% endstep %}
{% endstepper %}

## Управление ретрансляцией

Чтобы изменить или остановить ретрансляцию в Unigis:

* Нажмите значок ссылки справа от строки ретранслятора, чтобы изменить External ID устройства.
* Выключите переключатель, чтобы остановить ретрансляцию для одного устройства и сохранить конфигурацию для остальных.
* Нажмите **Протоколы**Выберите строку и отредактируйте ее, чтобы изменить имя, адрес или учетные данные. Изменение применяется ко всем устройствам, привязанным к этому ретранслятору.
* Удалите конфигурацию из **Протоколы** списка, чтобы остановить ретрансляцию для всех устройств. Подтвердите в диалоговом окне.

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

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

1. Ретранслятор включен, и для устройства активирован его переключатель.
2. Логин и пароль совпадают с учетными данными Unigis. Navixy отправляет их с каждым местоположением, поэтому неверный пароль приводит к сбою каждого запроса, а не только первого.
3. Адрес содержит полный путь, предоставленный Unigis, и указан правильный порт.
4. External ID совпадает с гос. номером, зарегистрированным в Unigis.
5. Устройство передает корректные координаты. Местоположения без GPS-сигнала никогда не ретранслируются.

Если местоположения поступают, но их меньше ожидаемого, это связано с ограничением в одну минуту, а не с неисправностью. Unigis получает минутную выборку трека.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://navixy.com/docs/user/ru/guide/devices-and-settings/connectivity/data-forwarding/unigis.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.