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

# Maquinaria Amarilla

Соблюдайте Колумбийский декрет 723, передавая GPS-данные тяжелой техники из Navixy в Национальную полицию по SOAP-протоколу Maquinaria Amarilla.

Maquinaria Amarilla — это протокол, который Национальная полиция Колумбии использует для мониторинга тяжелой техники и предотвращения ее незаконного использования. Компании, эксплуатирующие тяжелую технику в Колумбии, обязаны сообщать в него в соответствии с Декретом 723 от 2014 года. Этот протокол ретранслирует необходимые данные о местоположении и событиях из Navixy на серверы полиции.

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

Настройка состоит из трех этапов, и их нужно выполнить по порядку: сгенерировать токен, зарегистрировать ваши машины в полиции, затем настроить ретрансляцию в Navixy. Первые два этапа выполняются вне Navixy.

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

Navixy отправляет один SOAP-запрос на каждое сообщение в `InsertarUbicacion` методу. Запрос содержит следующие поля:

| Поле                    | Содержимое                                                                                       |
| ----------------------- | ------------------------------------------------------------------------------------------------ |
| `PUSUARIO`              | Логин, зарегистрированный в полиции Колумбии                                                     |
| `PTOKEN`                | Токен, взятый из **Пароль** поля ретранслятора                                                   |
| `PIDUNIDAD`             | Идентификатор машины из External ID                                                              |
| `PFECHAGPS`             | Когда устройство зафиксировало позицию, в формате `dd/MM/yyyy HH:mm:ss` по колумбийскому времени |
| `PLATITUD`, `PLONGITUD` | Положение в градусах                                                                             |
| `PVELOCIDAD`            | Скорость                                                                                         |
| `PDIRECCION`            | Курс как направление по компасу                                                                  |
| `PEVENTO`               | Код события полиции для этого сообщения                                                          |
| `PIGNICION`             | `1` когда зажигание включено, `0` когда оно выключено                                            |
| `PODOMETRO`             | Пройденное расстояние                                                                            |
| `PSTATUS`               | `1` для позиции в реальном времени, `9` для той, которую устройство сохранило и отправило позже  |

Navixy отправляет каждое сообщение, включая сообщения без позиции.

Navixy преобразует свои коды событий в коды, которые ожидает полиция. Идентификация водителя, SOS, зажигание включено и выключено, превышение скорости, несанкционированное движение, низкий заряд резервной батареи, начало и окончание «Стоит с включенным двигателем», потеря GPS, Ускорение и торможение, отключение антенны, пробуждение, сигнал двери и сигнал влажности GSM — каждое событие сопоставляется с соответствующим полицейским кодом. Любое другое сообщение отправляется как обычная позиция мониторинга.

## Перед началом работы

Вам понадобятся следующие данные от полиции Колумбии:

* Логин и пароль вашей компании, зарегистрированные в полиции.
* Код провайдера, который является частью идентификатора машины.

Вам также понадобится **Postman**, установленный локально или в веб-версии, чтобы сгенерировать токен и зарегистрировать ваши машины.

## Сгенерируйте токен

Токен авторизует все последующие операции, включая ретрансляцию данных. Сгенерируйте его до регистрации машин.

Сначала загрузите [коллекцию Postman](https://drive.google.com/file/d/1XFe_vi22rHqqIDgLlAiTlcepLBBVPemZ/view) сначала.

{% stepper %}
{% step %}

### Импортируйте коллекцию

Откройте Postman, нажмите **Импорт**, и загрузите скачанный файл.

<div align="left"><figure><img src="https://2388694493-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F446mKak1zDrGv70ahuYZ%2Fuploads%2Fgit-blob-05666c301892ef9ca37f6be9de650c3cdd82f8b9%2Fimage.png?alt=media" alt="The Postman Import dialog with the Maquinaria Amarilla collection file selected"><figcaption><p>Импорт коллекции в Postman</p></figcaption></figure></div>
{% endstep %}

{% step %}

### Откройте запрос для получения токена

Выберите вызов для генерации токена, затем перейдите на вкладку **ValIngreso** раздел.

<div align="left"><figure><img src="https://2388694493-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F446mKak1zDrGv70ahuYZ%2Fuploads%2Fgit-blob-d364a2215f72954039aa24be82be435cc6e4ae7b%2Fimage.png?alt=media" alt="The ValIngreso section of the token generation request in Postman"><figcaption><p>Вызов генерации токена</p></figcaption></figure></div>
{% endstep %}

{% step %}

### Переключите тело на raw

Перейдите в **Тело** вкладку и выберите **Raw**.
{% endstep %}

{% step %}

### Введите учетные данные

Замените эти три значения в теле запроса:

* **Пользователь**: логин вашей компании, зарегистрированный в полиции
* **Пароль**: пароль вашей компании, зарегистрированный в полиции
* **Допустимое число**: число в формате `4.1234567890`

<figure><img src="https://2388694493-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F446mKak1zDrGv70ahuYZ%2Fuploads%2Fgit-blob-15bec39ce6c1dc4e4e3a03c69501893cf5faec4a%2Fimage.png?alt=media" alt="The token generation request body with the user, password, and valid number fields filled in"><figcaption><p>Три значения, которые нужно заменить в теле запроса</p></figcaption></figure>
{% endstep %}

{% step %}

### Отправьте запрос

Отправьте запрос. Сохраните токен из ответа, потому что позже вы введете его в Navixy.
{% endstep %}
{% endstepper %}

## Зарегистрируйте машины и устройства

Зарегистрируйте ваши машины в полиции до ретрансляции данных. Позиция для незарегистрированной машины будет отклонена.

Для каждого шага используется отдельная коллекция Postman. В каждой из них укажите логин и сгенерированный токен, а также сведения о машине точно так, как они записаны в вашей регистрационной таблице.

{% stepper %}
{% step %}

### Добавьте GPS-устройства

Импорт [коллекцию для устройств](https://drive.google.com/file/d/1C45u-A2n3E1wbteuLl_D-dqrxMbHJYGw/view?usp=share_link) в Postman и отправьте запрос.
{% endstep %}

{% step %}

### Добавьте машины

Импорт [коллекцию для машин](https://drive.google.com/file/d/1Y77If2KFPvnSIl-JZ6safx8Rm5nnI101/view) в Postman и отправьте запрос.
{% endstep %}

{% step %}

### Свяжите машины с устройствами

Импорт [коллекцию связывания](https://drive.google.com/file/d/1cfj26NXqdTvLIbSHWoeA-QSGDwz29EWk/view?usp=sharing) в Postman и отправьте запрос.
{% endstep %}
{% endstepper %}

Каждый запрос возвращает один из этих кодов:

| Код   | Значение                                                                  |
| ----- | ------------------------------------------------------------------------- |
| `001` | Процесс запущен                                                           |
| `002` | Запись успешно добавлена                                                  |
| `ER1` | Дублирующаяся запись. Пять следующих цифр — это код ошибки базы данных.   |
| `ER2` | Еще одна ошибка записи. Пять следующих цифр — это код ошибки базы данных. |
| `ER3` | Неверный пользователь или токен больше не активен                         |

Машина считается зарегистрированной корректно, когда ответ `002`.

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

{% stepper %}
{% step %}

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

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

{% step %}

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

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

{% step %}

### Откройте настройки Maquinaria Amarilla

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

* **Имя**: метка, которая идентифицирует этот ретранслятор
* **Протокол**: **Yellow Machinery**
* **Адрес**: `https://logmqa.policia.gov.co/Service1.asmx`
* **Порт**: `443`
* **Вход**: логин, предоставленный полицией Колумбии
* **Пароль**: сгенерированный вами токен, а не пароль от полиции

<figure><img src="https://2388694493-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F446mKak1zDrGv70ahuYZ%2Fuploads%2Fgit-blob-b2b7cf251c487757b5d3f494fb82822f2a26fbe1%2Fimage.png?alt=media" alt="The Protocol editing dialog with Yellow Machinery selected and the police endpoint address entered" width="270"><figcaption><p>Готовая настройка Maquinaria Amarilla</p></figcaption></figure>
{% endstep %}

{% step %}

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

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

{% step %}

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

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

{% step %}

### Задайте внешний ID

Нажмите значок ссылки справа от строки ретранслятора, затем введите идентификатор машины, включающий код провайдера. Он может содержать до 20 символов, только заглавные буквы и цифры.

Повторите этот шаг и предыдущий для каждой машины, которая передает данные в полицию.
{% endstep %}
{% endstepper %}

{% hint style="warning" %}
Срок действия токена истекает. После этого ретрансляция прекращается, а серверы полиции отвечают ошибкой `ER3`. Сгенерируйте новый токен и введите его в **Пароль** поле ретранслятора, чтобы возобновить работу.
{% endhint %}

## Управление пересылкой

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

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

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

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

1. Ретранслятор включён, и для устройства активирован его переключатель.
2. Этот **Пароль** в поле указан действующий токен, а не ваш пароль от полиции.
3. Срок действия токена не истек. Просроченный токен вызывает ошибку `ER3`.
4. Машина и ее устройство были зарегистрированы в полиции, и регистрация вернула `002`.
5. Адрес и порт указаны верно.
6. External ID совпадает с идентификатором машины, зарегистрированным в полиции, включая код провайдера.


---

# 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/maquinaria-amarilla.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.
