> 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 устройства или ID устройства Navixy, если External ID пуст.              |
| `Codigo`                      | Код события Navixy для этого сообщения                                              |
| `Широта`, `Долгота`, `Высота` | Положение в градусах, высота в метрах                                               |
| `Скорость`                    | Скорость                                                                            |
| `Курс`                        | Направление                                                                         |
| `Дата и время события`        | Время, когда устройство зафиксировало позицию, в формате ISO 8601                   |
| `Дата и время получения`      | Когда 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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.
