> 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 выберите **Желтая техника** в **протокол** раскрывающемся списке.
Настройка состоит из трех этапов, и выполнять их нужно по порядку: сгенерировать токен, зарегистрировать технику в полиции, затем настроить Ретрансляцию в 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, нажмите **Import**, и загрузите скачанный файл.
Импорт коллекции в Postman
{% endstep %}
{% step %}
### Откройте запрос на получение токена
Выберите вызов генерации токена, затем перейдите в раздел **ValIngreso** .
Вызов генерации токена
{% endstep %}
{% step %}
### Переключите body в режим raw
Перейдите на **вкладку Body** и выберите **Raw**.
{% endstep %}
{% step %}
### Введите учетные данные
Замените эти три значения в теле запроса:
* **User**: логин вашей компании, зарегистрированный в полиции
* **Пароль**: пароль вашей компании, зарегистрированный в полиции
* **Valid number**: число в формате `4.1234567890`
Три значения, которые нужно заменить в теле запроса
{% endstep %}
{% step %}
### Отправьте запрос
Отправьте запрос. Сохраните токен из ответа, потому что позже вы введете его в Navixy.
{% endstep %}
{% endstepper %}
## Зарегистрируйте технику и устройства
Зарегистрируйте технику в полиции до Ретрансляции данных. Координаты незарегистрированной техники отклоняются.
Каждый шаг использует отдельную коллекцию Postman. В каждом из них введите логин и токен, который вы сгенерировали, а также сведения о технике точно так, как они указаны в вашей регистрационной таблице.
{% stepper %}
{% step %}
### Добавьте GPS-устройства
Import [коллекцию устройств](https://drive.google.com/file/d/1C45u-A2n3E1wbteuLl_D-dqrxMbHJYGw/view?usp=share_link) в Postman и отправьте запрос.
{% endstep %}
{% step %}
### Добавьте технику
Import [коллекцию техники](https://drive.google.com/file/d/1Y77If2KFPvnSIl-JZ6safx8Rm5nnI101/view) в Postman и отправьте запрос.
{% endstep %}
{% step %}
### Свяжите технику с устройствами
Import [коллекцию связывания](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 %}
### Откройте настройки «Желтая техника»
Заполните поля следующим образом:
* **Имя**: название, идентифицирующее этот ретранслятор
* **протокол**: **Желтая техника**
* **Адрес**: `https://logmqa.policia.gov.co/Service1.asmx`
* **Порт**: `443`
* **Логин**: логин, предоставленный полицией Колумбии
* **Пароль**: сгенерированный вами токен, а не ваш пароль от полиции
Завершенная настройка «Желтая техника»
{% endstep %}
{% step %}
### Включите и сохраните
Включите **Включено**, затем нажмите **Сохраните**. Неактивный ретранслятор ничего не отправляет.
{% endstep %}
{% step %}
### Привяжите ретранслятор к устройству
В блоке устройства **Ретрансляция** , включите переключатель для созданного ретранслятора, затем нажмите **Сохраните**.
{% endstep %}
{% step %}
### Задайте External ID
Щелкните значок ссылки справа от строки ретранслятора, затем введите идентификатор техники, который включает код поставщика. Он может содержать до 20 символов, только заглавные буквы и цифры.
Повторите этот шаг и предыдущий для каждой техники, которая передает данные в полицию.
{% endstep %}
{% endstepper %}
{% hint style="warning" %}
Токен истекает. Когда это произойдет, Ретрансляция остановится, а серверы полиции ответят ошибкой `ER3`. Сгенерируйте новый токен и введите его в **Пароль** поле ретранслятора, чтобы возобновить работу.
{% endhint %}
## Управление ретрансляцией
Чтобы изменить или остановить Ретрансляцию в Maquinaria Amarilla:
* Нажмите значок ссылки справа от строки ретранслятора, чтобы изменить External 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 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/maquinaria-amarilla.md?ask=&goal=
```
`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.
