> 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/es/guide/devices-and-settings/connectivity/data-forwarding/maquinaria-amarilla.md).
# Maquinaria Amarilla
Cumpla con el Decreto 723 de Colombia enviando datos GPS de maquinaria pesada desde Navixy a la Policía Nacional a través del protocolo SOAP de Maquinaria Amarilla.
Maquinaria Amarilla es el protocolo que usa la Policía Nacional de Colombia para monitorear maquinaria pesada y prevenir su uso ilícito. Las empresas que operan maquinaria pesada en Colombia deben reportarla conforme al Decreto 723 de 2014. Este protocolo reenvía los datos de posición y evento requeridos desde Navixy a los servidores de la policía.
En Navixy, seleccione **Maquinaria Amarilla** en la **Protocolo** lista desplegable.
La configuración tiene tres etapas, y deben realizarse en orden: genere un token, registre sus máquinas con la policía y luego configure el reenvío de datos en Navixy. Las dos primeras etapas ocurren fuera de Navixy.
## Lo que envía Navixy
Navixy envía una solicitud SOAP por mensaje a la `InsertarUbicacion` . La solicitud contiene estos campos:
| Campo | Contenido |
| ----------------------- | ---------------------------------------------------------------------------------------------- |
| `PUSUARIO` | El usuario registrado con la Policía Colombiana |
| `PTOKEN` | El token, tomado del **Contraseña** campo del retransmisor |
| `PIDUNIDAD` | El identificador de la máquina, a partir del ID externo |
| `PFECHAGPS` | Cuando el dispositivo registró la posición, como `dd/MM/yyyy HH:mm:ss` en hora colombiana |
| `PLATITUD`, `PLONGITUD` | Posición en grados |
| `PVELOCIDAD` | Velocidad |
| `PDIRECCION` | Rumbo como dirección de la brújula |
| `PEVENTO` | El código de evento de la policía para este mensaje |
| `PIGNICION` | `1` cuando la ignición está encendida, `0` cuando está apagada |
| `PODOMETRO` | Distancia recorrida |
| `PSTATUS` | `1` para una posición en tiempo real, `9` para una que el dispositivo almacenó y envió después |
Navixy envía cada mensaje, incluidos los mensajes sin posición.
Navixy convierte sus propios códigos de evento en los códigos que espera la policía. La identificación del conductor, SOS, ignición encendida y apagada, exceso de velocidad, movimiento no autorizado, batería de respaldo baja, inicio y fin de ralentí, pérdida de GPS, aceleración brusca y frenado brusco, desconexión de la antena, activación, alarma de puerta y alarma de atenuación GSM se asignan cada uno a su código policial. Cualquier otro mensaje se informa como una posición de seguimiento rutinaria.
## Antes de comenzar
Necesita lo siguiente de la Policía Colombiana:
* El usuario y la contraseña de su empresa, tal como están registrados con la policía.
* El código de proveedor que forma parte del identificador de la máquina.
También necesita **Postman**, instalado o en su versión web, para generar el token y registrar sus máquinas.
## Generar un token
El token autoriza todas las operaciones posteriores, incluido el reenvío de datos. Genérelo antes de registrar las máquinas.
Descargue la [colección de Postman](https://drive.google.com/file/d/1XFe_vi22rHqqIDgLlAiTlcepLBBVPemZ/view) primero.
{% stepper %}
{% step %}
### Importar la colección
Abra Postman, haga clic en **Importar**, y cargue el archivo que descargó.
Importación de la colección en Postman
{% endstep %}
{% step %}
### Abra la solicitud del token
Seleccione la llamada de generación de token y luego vaya a la sección **ValIngreso** .
La llamada de generación de token
{% endstep %}
{% step %}
### Cambie el cuerpo a raw
Vaya a la **Body** pestaña y seleccione **Raw**.
{% endstep %}
{% step %}
### Ingrese sus credenciales
Reemplace estos tres valores en el cuerpo de la solicitud:
* **Usuario**: el usuario de su empresa registrado con la policía
* **Contraseña**: la contraseña de su empresa registrada con la policía
* **Número válido**: un número con el formato `4.1234567890`
Los tres valores que debe reemplazar en el cuerpo de la solicitud
{% endstep %}
{% step %}
### Envíe la solicitud
Envíe la solicitud. Conserve el token de la respuesta, porque lo ingresará en Navixy más adelante.
{% endstep %}
{% endstepper %}
## Registrar máquinas y dispositivos
Registre sus máquinas con la policía antes de reenviar datos. Se rechaza una posición de una máquina no registrada.
Cada paso utiliza una colección distinta de Postman. En cada una, ingrese el usuario y el token que generó, junto con los detalles de la máquina exactamente como figuran en su hoja de registro.
{% stepper %}
{% step %}
### Agregar los dispositivos GPS
Importar [la colección de dispositivos](https://drive.google.com/file/d/1C45u-A2n3E1wbteuLl_D-dqrxMbHJYGw/view?usp=share_link) en Postman y envíe la solicitud.
{% endstep %}
{% step %}
### Agregar las máquinas
Importar [la colección de máquinas](https://drive.google.com/file/d/1Y77If2KFPvnSIl-JZ6safx8Rm5nnI101/view) en Postman y envíe la solicitud.
{% endstep %}
{% step %}
### Vincular las máquinas con los dispositivos
Importar [la colección de vinculación](https://drive.google.com/file/d/1cfj26NXqdTvLIbSHWoeA-QSGDwz29EWk/view?usp=sharing) en Postman y envíe la solicitud.
{% endstep %}
{% endstepper %}
Cada solicitud devuelve uno de estos códigos:
| Código | Significado |
| ------ | ------------------------------------------------------------------------------------------------ |
| `001` | El proceso comenzó |
| `002` | El registro se insertó correctamente |
| `ER1` | Registro duplicado. Los cinco dígitos que siguen son el código de error de la base de datos. |
| `ER2` | Otro error de registro. Los cinco dígitos que siguen son el código de error de la base de datos. |
| `ER3` | El usuario es incorrecto o el token ya no está activo |
Una máquina se registra correctamente cuando la respuesta es `002`.
## Configurar el reenvío
{% stepper %}
{% step %}
### Abra el bloque Reenvío de datos
Vaya a **Dispositivos**, seleccione un dispositivo y luego busque el **Reenvío de datos** bloque.
{% endstep %}
{% step %}
### Abra la lista de protocolos
Haga clic en **Protocolos**, luego haga clic en **+** para agregar una configuración.
{% endstep %}
{% step %}
### Ingrese a la configuración de Maquinaria Amarilla
Complete los campos de la siguiente manera:
* **Nombre**: una etiqueta que identifica este retransmisor
* **Protocolo**: **Maquinaria Amarilla**
* **Dirección**: `https://logmqa.policia.gov.co/Service1.asmx`
* **Puerto**: `443`
* **Inicio de sesión**: el usuario proporcionado por la Policía Colombiana
* **Contraseña**: el token que generó, no su contraseña policial
La configuración completa de Maquinaria Amarilla
{% endstep %}
{% step %}
### Habilite y guarde
Active **Habilitado**, luego haga clic en **Guardar**. Un retransmisor que no está habilitado no envía nada.
{% endstep %}
{% step %}
### Vincule el retransmisor a un dispositivo
En el **Reenvío de datos** bloque del dispositivo, active el interruptor del retransmisor que creó y luego haga clic en **Guardar**.
{% endstep %}
{% step %}
### Establezca el ID externo
Haga clic en el ícono de enlace a la derecha de la fila del retransmisor y luego ingrese el identificador de la máquina que incluye su código de proveedor. Puede tener hasta 20 caracteres y usar solo letras mayúsculas y dígitos.
Repita este paso y el anterior para cada máquina que reporta a la policía.
{% endstep %}
{% endstepper %}
{% hint style="warning" %}
El token expira. Cuando sucede, el reenvío de datos se detiene y los servidores de la policía responden con el error `ER3`. Genere un nuevo token e ingréselo en el **Contraseña** campo del retransmisor para reanudar.
{% endhint %}
## Administrar el reenvío
Para cambiar o detener el reenvío de datos a Maquinaria Amarilla:
* Haga clic en el ícono de enlace a la derecha de la fila del retransmisor para cambiar el ID externo de un dispositivo.
* Desactive el interruptor para detener el reenvío de un dispositivo y conserve la configuración para los demás.
* Haga clic en **Protocolos**, seleccione la fila y edítela para cambiar el nombre, la dirección o el token. El cambio se aplica a todos los dispositivos vinculados a este retransmisor.
* Elimine la configuración de la **Protocolos** lista para detener el reenvío para todos los dispositivos. Confirme en el cuadro de diálogo.
## Solución de problemas
Cuando los datos no aparecen en el sistema Maquinaria Amarilla, revise lo siguiente en orden:
1. El retransmisor está habilitado y su interruptor está activado para el dispositivo.
2. El **Contraseña** el campo contiene un token actual, no su contraseña policial.
3. El token no ha expirado. Un token expirado produce el error `ER3`.
4. La máquina y su dispositivo se registraron con la policía, y el registro devolvió `002`.
5. La dirección y el puerto son correctos.
6. El ID externo coincide con el identificador de la máquina registrado con la policía, incluido el código de proveedor.
---
# 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/es/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.
