> 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/guide/devices-and-settings/connectivity/data-forwarding/maquinaria-amarilla.md). # Maquinaria Amarilla ### What is Maquinaria Amarilla? Maquinaria Amarilla is a regulatory security protocol that monitors, provides visibility, and generates reports on heavy machinery operations. Navixy added the Maquinaria Amarilla data forwarding protocol for use by companies in the Colombian industry, which are required by law to be monitored by the National Police of Colombia. Maquinaria Amarilla is used by the Colombian government to monitor heavy machinery and prevent illicit use. Compliance with this protocol is mandatory under Decree 723 of 2014. ### General information The Maquinaria Amarilla protocol uses SOAP to send XML data every 60 minutes via HTTP to the Colombian police. The following data is sent to the Colombian National Police: * Vehicle license plate * Event code * Date * Address * Latitude * Longitude * Altitude * Speed * Course * Ignition * Odometer * Device ID ### Configuration #### Required parameters The following parameters are required: * User and password: Credentials for Maquinaria Amarilla * External ID: A 20-character ID that includes the provider code provided by the Colombian Police * Token: Required for all operations within the protocol #### How to generate a token To obtain a token, you must send specific XML data. **Prerequisites**: * Download the [Postman collection](https://drive.google.com/file/d/1XFe_vi22rHqqIDgLlAiTlcepLBBVPemZ/view) * Install **Postman** or use its web version {% stepper %} {% step %} Open **Postman** {% endstep %} {% step %} Click **Import** and upload the previously downloaded XML file
{% endstep %} {% step %} Select the call for token generation and go to the **ValIngreso** section
{% endstep %} {% step %} Go to the **Body** tab and select **Raw**
{% endstep %} {% step %} Change the following three values: * **User**: The login of the company registered with the Colombian police * **Password**: The password of the company registered with the Colombian police * **Valid number**: The number in the example format `4.1234567890`
{% endstep %} {% step %} Send the request to generate the token {% endstep %} {% endstepper %} #### How to register objects and devices Once the token is generated, you must register the objects and devices to synchronize them with the Police database. The process is similar to obtaining the token, but uses the device and object data. {% stepper %} {% step %} Add GPS devices Import [this JSON](https://drive.google.com/file/d/1C45u-A2n3E1wbteuLl_D-dqrxMbHJYGw/view?usp=share_link) into Postman. Enter the user and token generated previously, along with the fields exactly as registered in your Excel file. The system generates one of the following response codes: ``` 001 --> STARTING PROCESS 002 --> RECORD INSERTED OK ER1 XXXXX --> DUPLICATE RECORD ERROR (IDTRAMA) XXXXX = ORACLE ERROR CODE ER2 XXXXX --> OTHER RECORD ERROR XXXXX = ORACLE ERROR CODE ER3 XXXXXXXXXX --> USER ERROR OR INACTIVE TOKEN ``` {% endstep %} {% step %} Add objects Import [this JSON](https://drive.google.com/file/d/1Y77If2KFPvnSIl-JZ6safx8Rm5nnI101/view) into Postman Enter the user and token generated previously, along with the fields exactly as registered in your Excel file. The system will generate one of the response codes listed above. {% endstep %} {% step %} Link objects with devices Import [this JSON](https://drive.google.com/file/d/1cfj26NXqdTvLIbSHWoeA-QSGDwz29EWk/view?usp=sharing) into Postman. Enter the previously generated user and token, along with the fields exactly as listed in your Excel file. When the machine is registered correctly, the system returns `002`, indicating that the machine was inserted successfully. {% endstep %} {% endstepper %} #### How to configure data forwarding in Navixy To configure data forwarding for the Maquinaria Amarilla protocol: {% stepper %} {% step %} Navigate to the **Devices and settings** in the main side panel {% endstep %} {% step %} Select the **Data Forwarding** block {% endstep %} {% step %} Click **Protocols** {% endstep %} {% step %} Click the **+** button to add a new retranslation protocol. {% endstep %} {% step %} Enter the following parameters: * **Name**: Enter a name to identify this protocol * **Protocol**: Select **Maquinaria Amarilla (Yellow Machinery** in English) from the dropdown menu * **Address**: `https://logmqa.policia.gov.co/Service1.asmx` * **Port**: `443` * **Login**: Enter the login provided by the Colombian Police * **Password**: Enter the password provided by the Colombian Police
{% endstep %} {% step %} Ensure the **Enabled** checkbox is selected {% endstep %} {% step %} Click **Save** {% endstep %} {% endstepper %} #### How to manage data forwarding To edit or stop data forwarding: * Click **Edit** next to the protocol's entry to open the **Protocol editing** window and change its configuration. * Click **Delete** to delete a protocol and stop data forwarding. Confirm the change in the pop-up window. ### Troubleshooting If data doesn't appear in the **Maquinaria Amarilla** system, verify the following: * The username and token for **Maquinaria Amarilla** are entered correctly. * The URL is entered correctly. * Device registration was completed successfully with the police. * The retranslation protocol is enabled in 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, and the optional `goal` query parameter: ``` GET https://navixy.com/docs/user/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.