# Maquinaria Amarilla ### Что такое Maquinaria Amarilla? Maquinaria Amarilla — это регламентированный протокол безопасности, который отслеживает, обеспечивает прозрачность и формирует отчеты по операциям с тяжелой техникой. Navixy добавил протокол пересылки данных Maquinaria Amarilla для использования компаниями в колумбийской отрасли, которые по закону обязаны находиться под мониторингом Национальной полиции Колумбии. Maquinaria Amarilla используется правительством Колумбии для мониторинга тяжелой техники и предотвращения незаконного использования. Соблюдение этого протокола является обязательным в соответствии с Указом 723 от 2014 года. ### Общая информация Протокол Maquinaria Amarilla использует SOAP для отправки XML-данных каждые 60 минут по HTTP в полицию Колумбии. В Национальную полицию Колумбии отправляются следующие данные: * Государственный номер транспортного средства * Код события * Дата * Адрес * Широта * Долгота * Высота * Скорость * Курс * Зажигание * Одометр * 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 %} Перейдите на **Body** вкладку и выберите **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 (Желтая техника** на английском языке) в раскрывающемся меню * **Адрес**: `https://logmqa.policia.gov.co/Service1.asmx` * **Порт**: `443` * **Логин**: введите логин, предоставленный полицией Колумбии * **Пароль**: введите пароль, предоставленный полицией Колумбии
{% endstep %} {% step %} Убедитесь, что **Включено** флажок установлен {% endstep %} {% step %} Нажмите **Сохранить** {% endstep %} {% endstepper %} #### Как управлять пересылкой данных Чтобы изменить или остановить пересылку данных: * Нажмите **Редактировать** рядом с записью протокола, чтобы открыть окно **Редактирование протокола** и изменить его конфигурацию. * Нажмите **Удалить** чтобы удалить протокол и остановить пересылку данных. Подтвердите изменение во всплывающем окне. ### Устранение неполадок Если данные не отображаются в **Maquinaria Amarilla** системе, проверьте следующее: * Имя пользователя и токен для **Maquinaria Amarilla** введены правильно. * URL введен правильно. * Регистрация устройства была успешно завершена в полиции. * Протокол ретрансляции включен в Navixy. --- # Agent Instructions: 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.