> 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/data-forwarding/maquinaria-amarilla.md). # Maquinaria Amarilla ### Что такое Maquinaria Amarilla? Maquinaria Amarilla — это регуляторный протокол безопасности, который отслеживает, обеспечивает прозрачность и формирует отчеты по работе тяжелой техники. Navixy добавила протокол ретрансляции данных Maquinaria Amarilla для использования компаниями в Колумбии, которые по закону обязаны находиться под контролем Национальной полиции Колумбии. Maquinaria Amarilla используется правительством Колумбии для мониторинга тяжелой техники и предотвращения ее незаконного использования. Соблюдение этого протокола является обязательным в соответствии с Декретом 723 от 2014 года. ### Общая информация Протокол Maquinaria Amarilla использует SOAP для отправки XML-данных каждые 60 минут через HTTP в колумбийскую полицию. В Национальную полицию Колумбии отправляются следующие данные: * Государственный регистрационный номер транспортного средства * Код события * Дата * Адрес * Широта * Долгота * Altitude * Скорость * Course * Зажигание * Одометр * ID устройства ### Конфигурация #### Обязательные параметры Требуются следующие параметры: * Пользователь и пароль: учетные данные для Maquinaria Amarilla * Внешний ID: идентификатор длиной 20 символов, который включает код провайдера, предоставленный колумбийской полицией * Токен: требуется для всех операций в рамках протокола #### Как сгенерировать токен Чтобы получить токен, необходимо отправить определенные XML-данные. **Предварительные условия**: * Скачайте [коллекцию Postman](https://drive.google.com/file/d/1XFe_vi22rHqqIDgLlAiTlcepLBBVPemZ/view) * Установить **Postman** или используйте его веб-версию {% stepper %} {% step %} Откройте **Postman** {% endstep %} {% step %} Нажмите **Импортируйте** и загрузите ранее скачанный XML-файл
{% endstep %} {% step %} Выберите запрос на генерацию токена и перейдите на **ValIngreso** раздел
{% endstep %} {% step %} Перейдите во **Тело** вкладку и выберите **Raw**
{% endstep %} {% step %} Измените следующие три значения: * **Пользователь**: Логин компании, зарегистрированной в колумбийской полиции * **Пароль**: Пароль компании, зарегистрированной в колумбийской полиции * **Действительный номер**: Номер в формате примера `4.1234567890`
{% endstep %} {% step %} Отправьте запрос на генерацию токена {% endstep %} {% endstepper %} #### Как зарегистрировать объекты и устройства После генерации токена необходимо зарегистрировать объекты и устройства, чтобы синхронизировать их с базой данных полиции. Процесс аналогичен получению токена, но использует данные устройства и объекта. {% stepper %} {% step %} Добавить GPS-устройства Импортируйте [этот JSON](https://drive.google.com/file/d/1C45u-A2n3E1wbteuLl_D-dqrxMbHJYGw/view?usp=share_link) в Postman. Введите ранее сгенерированные имя пользователя и токен вместе с полями точно так, как они зарегистрированы в вашем файле Excel. Система сгенерирует один из следующих кодов ответа: ``` 001 --> НАЧАЛО ПРОЦЕССА 002 --> ЗАПИСЬ УСПЕШНО ВСТАВЛЕНА ER1 XXXXX --> ОШИБКА ДУБЛИРОВАНИЯ ЗАПИСИ (IDTRAMA) XXXXX = КОД ОШИБКИ ORACLE ER2 XXXXX --> ДРУГАЯ ОШИБКА ЗАПИСИ XXXXX = КОД ОШИБКИ ORACLE ER3 XXXXXXXXXX --> ОШИБКА ПОЛЬЗОВАТЕЛЯ ИЛИ НЕАКТИВНЫЙ ТОКЕН ``` {% endstep %} {% step %} Добавить объекты Импортируйте [этот JSON](https://drive.google.com/file/d/1Y77If2KFPvnSIl-JZ6safx8Rm5nnI101/view) в Postman Введите ранее сгенерированные имя пользователя и токен вместе с полями точно так, как они зарегистрированы в вашем файле Excel. Система сгенерирует один из перечисленных выше кодов ответа. {% endstep %} {% step %} Связать объекты с устройствами Импортируйте [этот JSON](https://drive.google.com/file/d/1cfj26NXqdTvLIbSHWoeA-QSGDwz29EWk/view?usp=sharing) в Postman. Введите ранее сгенерированные имя пользователя и токен вместе с полями точно так, как они указаны в вашем файле Excel. Когда машина зарегистрирована корректно, система возвращает `002`, что означает, что машина была успешно добавлена. {% endstep %} {% endstepper %} #### Как настроить ретрансляцию данных в Navixy Чтобы настроить ретрансляцию данных для протокола Maquinaria Amarilla: {% stepper %} {% step %} Перейдите в **Устройства и настройки** в главной боковой панели {% endstep %} {% step %} Выберите **Перенаправление данных** блок {% endstep %} {% step %} Нажмите **Протоколы** {% endstep %} {% step %} Нажмите **+** кнопка для добавления нового протокола ретрансляции. {% endstep %} {% step %} Введите следующие параметры: * **Имя**: Введите имя для идентификации этого протокола * **Протокол**: Выберите **Maquinaria Amarilla (Yellow Machinery** на английском языке) в раскрывающемся меню * **Адрес**: `https://logmqa.policia.gov.co/Service1.asmx` * **Порт**: `443` * **Логин**: Введите логин, предоставленный колумбийской полицией * **Пароль**: Введите пароль, предоставленный колумбийской полицией
{% endstep %} {% step %} Убедитесь, что **кнопка «Включено»** флажок установлен {% endstep %} {% step %} Нажмите **Сохраните** {% endstep %} {% endstepper %} #### Как управлять ретрансляцией данных Чтобы изменить или остановить ретрансляцию данных: * Нажмите **Изменить** рядом с записью протокола, чтобы открыть **Редактирование протокола** окно и изменить его конфигурацию. * Нажмите **Удалить** чтобы удалить протокол и остановить ретрансляцию данных. Подтвердите изменение во всплывающем окне. ### Устранение неполадок Если данные не отображаются в **Maquinaria Amarilla** системе, проверьте следующее: * Имя пользователя и токен для **Maquinaria Amarilla** введены корректно. * URL введен корректно. * Регистрация устройства была успешно завершена в полиции. * Протокол ретрансляции включен в Navixy. --- # 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: ``` GET https://navixy.com/docs/user/ru/guide/devices-and-settings/data-forwarding/maquinaria-amarilla.md?ask= ``` The question should be specific, self-contained, and written in natural language. 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.