> 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/ilsp.md).

# ILSP

Передавайте координаты транспортных средств и тревоги Охрана из Navixy в центры мониторинга ILSP в Мексике с помощью JSON API с аутентификацией OAuth.

ILSP предоставляет услуги частной охраны в Мексике, а протокол ретрансляции данных ILSP передает координаты транспортных средств и тревоги охраны в его центры мониторинга. Компании, которые используют один центр мониторинга, применяют его, чтобы предоставить ILSP доступ к своим транспортным средствам, а одна учетная запись Navixy может ретранслировать данные сразу нескольким клиентам ILSP.

В Navixy выберите **ILSP** в **Протокол** раскрывающийся список.

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

Navixy отправляет один HTTP POST-запрос на каждое сообщение на `/CustomerServices/api/SetLastEvent`, а в теле JSON содержатся следующие поля:

| Поле                 | Содержимое                                                                                                                    |
| -------------------- | ----------------------------------------------------------------------------------------------------------------------------- |
| `customerId`         | Номер клиента, взятый из первой части External ID                                                                             |
| `transportLineId`    | Номер транспортной линии, взятый из третьей части External ID                                                                 |
| `гос. номера`        | Гос. номер, взятый из второй части External ID                                                                                |
| `generatedEvent`     | Код события: `2` для SOS, `3` при потере питания, `4` для тревоги по затуханию GSM-сигнала и `1` для любого другого сообщения |
| `generatedEventDate` | Когда устройство зафиксировало сообщение                                                                                      |
| `широта` и `долгота` | Позиция в градусах                                                                                                            |
| `скорость`           | Скорость                                                                                                                      |
| `курс`               | Направление движения                                                                                                          |
| `Одометр`            | Пройденное расстояние, отправляется только если устройство сообщает его                                                       |
| `батарея`            | Уровень заряда батареи, отправляется только если устройство сообщает его                                                      |

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

Navixy отправляет сообщение, когда есть корректная позиция, либо когда сообщает SOS, потерю питания или тревогу по затуханию GSM-сигнала. Тревога отправляется даже без позиции, поэтому ILSP получает оповещение. Любое другое сообщение без позиции пропускается.

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

Запросите у ILSP следующее:

* Адрес конечной точки и порт. Обычно адрес `https://www.ilspservices.com.mx/` на порту `443`.
* Ваш идентификатор клиента и секрет клиента. Navixy требует оба значения и не сохранит ретранслятор без них.
* Номер клиента, Гос. номер и номер транспортной линии для каждого транспортного средства.

{% hint style="info" %}
ILSP проходит аутентификацию через OAuth, а не по имени пользователя и паролю. Введите идентификатор клиента в **Вход** поле и секрет клиента в **Пароль** поле. Navixy запрашивает токен перед отправкой данных и обновляет его по истечении срока действия. После пяти неудачных запросов токена Navixy отключает ретранслятор, поэтому неверный идентификатор клиента или секрет останавливают ретрансляцию, а не приводят к бесконечным повторным попыткам.
{% endhint %}

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

{% stepper %}
{% step %}

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

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

{% step %}

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

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

{% step %}

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

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

* **Название**: метка, идентифицирующая этот ретранслятор
* **Протокол**: **ILSP**
* **Адрес**: `https://www.ilspservices.com.mx/`
* **Порт**: `443`
* **Вход**: ваш идентификатор клиента ILSP
* **Пароль**: ваш секрет клиента ILSP
  {% endstep %}

{% step %}

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

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

{% step %}

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

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

{% step %}

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

Нажмите значок ссылки справа от строки ретранслятора, затем введите три значения, по которым ILSP идентифицирует это транспортное средство, разделенные символом вертикальной черты:

```
customerId|licensePlate|transportLineId
```

Например, `4821|ABC-123|17`. Все три части обязательны. Номер клиента и номер транспортной линии должны состоять из цифр, а Гос. номер может содержать заглавные латинские буквы, цифры и дефисы.

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

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

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

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

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

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

1. Ретранслятор включен, и для устройства активирован его переключатель.
2. Идентификатор клиента и секрет клиента указаны верно. После пяти неудачных запросов токена ретранслятор отключается, поэтому исправьте учетные данные и затем переключите **Включено** его выключите и включите снова.
3. Адрес и порт указаны верно.
4. External ID содержит все три части в правильном порядке, разделенные символами |, без пробелов вокруг них.
5. Номер клиента, Гос. номер и номер транспортной линии совпадают с записями на стороне ILSP.


---

# 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/ilsp.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.
