# Maquinaria Amarilla ### ¿Qué es Maquinaria Amarilla? Maquinaria Amarilla es un protocolo regulatorio de seguridad que supervisa, proporciona visibilidad y genera reportes sobre las operaciones de maquinaria pesada. Navixy añadió el protocolo de reenvío de datos Maquinaria Amarilla para su uso por empresas de la industria colombiana, que por ley deben ser monitoreadas por la Policía Nacional de Colombia. Maquinaria Amarilla es utilizada por el gobierno colombiano para supervisar maquinaria pesada y prevenir su uso ilícito. El cumplimiento de este protocolo es obligatorio según el Decreto 723 de 2014. ### Información general El protocolo Maquinaria Amarilla utiliza SOAP para enviar datos XML cada 60 minutos mediante HTTP a la policía colombiana. Los siguientes datos se envían a la Policía Nacional de Colombia: * Placa del vehículo * Código de evento * Fecha * Dirección * Latitud * Longitud * Altitud * Velocidad * Rumbo * Ignición * Odómetro * Device ID ### Configuración #### Parámetros requeridos Los siguientes parámetros son obligatorios: * Usuario y contraseña: credenciales para Maquinaria Amarilla * ID externo: un ID de 20 caracteres que incluye el código del proveedor proporcionado por la Policía de Colombia * Token: requerido para todas las operaciones dentro del protocolo #### Cómo generar un token Para obtener un token, debe enviar datos XML específicos. **Requisitos previos**: * Descargue la [colección de Postman](https://drive.google.com/file/d/1XFe_vi22rHqqIDgLlAiTlcepLBBVPemZ/view) * Instale **Postman** o use su versión web {% stepper %} {% step %} Abra **Postman** {% endstep %} {% step %} Haga clic en **Importe** y cargue el archivo XML descargado previamente
{% endstep %} {% step %} Seleccione la llamada para la generación del token y vaya a la **ValIngreso** sección
{% endstep %} {% step %} Vaya a la pestaña **Body** y seleccione **Raw**
{% endstep %} {% step %} Cambie los siguientes tres valores: * **Usuario**: El inicio de sesión de la empresa registrada ante la policía colombiana * **Contraseña**: La contraseña de la empresa registrada ante la policía colombiana * **Número válido**: El número en el formato del ejemplo `4.1234567890`
{% endstep %} {% step %} Envíe la solicitud para generar el token {% endstep %} {% endstepper %} #### Cómo registrar objetos y dispositivos Una vez generado el token, debe registrar los objetos y dispositivos para sincronizarlos con la base de datos de la Policía. El proceso es similar al de obtención del token, pero utiliza los datos del dispositivo y del objeto. {% stepper %} {% step %} Añadir dispositivos GPS Importe [este JSON](https://drive.google.com/file/d/1C45u-A2n3E1wbteuLl_D-dqrxMbHJYGw/view?usp=share_link) en Postman. Introduzca el usuario y el token generados previamente, junto con los campos exactamente como se registraron en su archivo Excel. El sistema generará uno de los siguientes códigos de respuesta: ``` 001 --> INICIANDO PROCESO 002 --> REGISTRO INSERTADO CORRECTAMENTE ER1 XXXXX --> ERROR DE REGISTRO DUPLICADO (IDTRAMA) XXXXX = CÓDIGO DE ERROR DE ORACLE ER2 XXXXX --> OTRO ERROR DE REGISTRO XXXXX = CÓDIGO DE ERROR DE ORACLE ER3 XXXXXXXXXX --> ERROR DE USUARIO O TOKEN INACTIVO ``` {% endstep %} {% step %} Añadir objetos Importe [este JSON](https://drive.google.com/file/d/1Y77If2KFPvnSIl-JZ6safx8Rm5nnI101/view) en Postman Introduzca el usuario y el token generados previamente, junto con los campos exactamente como se registraron en su archivo Excel. El sistema generará uno de los códigos de respuesta indicados arriba. {% endstep %} {% step %} Vincular objetos con dispositivos Importe [este JSON](https://drive.google.com/file/d/1cfj26NXqdTvLIbSHWoeA-QSGDwz29EWk/view?usp=sharing) en Postman. Introduzca el usuario y el token generados previamente, junto con los campos exactamente como se indican en su archivo Excel. Cuando la máquina se registra correctamente, el sistema devuelve `002`, lo que indica que la máquina se insertó correctamente. {% endstep %} {% endstepper %} #### Cómo configurar el reenvío de datos en Navixy Para configurar el reenvío de datos para el protocolo Maquinaria Amarilla: {% stepper %} {% step %} Vaya a la **Dispositivos y ajustes** en el panel lateral principal {% endstep %} {% step %} Seleccione el **Reenvío de datos** bloque {% endstep %} {% step %} Haga clic en **Protocolos** {% endstep %} {% step %} Haga clic en el botón **+** botón para añadir un nuevo protocolo de retransmisión. {% endstep %} {% step %} Introduzca los siguientes parámetros: * **Nombre**: Introduzca un nombre para identificar este protocolo * **Protocolo**: Seleccione **Maquinaria Amarilla (Yellow Machinery** en inglés) en el menú desplegable * **Dirección**: `https://logmqa.policia.gov.co/Service1.asmx` * **Puerto**: `443` * **Inicio de sesión**: Introduzca el inicio de sesión proporcionado por la Policía de Colombia * **Contraseña**: Introduzca la contraseña proporcionada por la Policía de Colombia
{% endstep %} {% step %} Asegúrese de que la **Enabled** casilla de verificación esté seleccionada {% endstep %} {% step %} Haga clic en **Guardar** {% endstep %} {% endstepper %} #### Cómo administrar el reenvío de datos Para editar o detener el reenvío de datos: * Haga clic en **Editar** junto a la entrada del protocolo para abrir la **edición del protocolo** ventana y cambie su configuración. * Haga clic en **Eliminar** para eliminar un protocolo y detener el reenvío de datos. Confirme el cambio en la ventana emergente. ### Solución de problemas Si los datos no aparecen en el **Maquinaria Amarilla** sistema, verifique lo siguiente: * El nombre de usuario y el token de **Maquinaria Amarilla** se han introducido correctamente. * La URL se ha introducido correctamente. * El registro del dispositivo se completó correctamente con la policía. * El protocolo de retransmisión está habilitado en 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/es/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.