> 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/fr/guide/devices-and-settings/connectivity/data-forwarding/maquinaria-amarilla.md).

# Maquinaria Amarilla

Respectez le décret colombien 723 en transférant les données GPS des engins lourds de Navixy à la police nationale via le protocole SOAP Maquinaria Amarilla.

Maquinaria Amarilla est le protocole que la Police nationale colombienne utilise pour surveiller les engins lourds et empêcher leur usage illicite. Les entreprises qui exploitent des engins lourds en Colombie doivent lui transmettre leurs données conformément au décret 723 de 2014. Ce protocole transfère les données de position et d'événement requises de Navixy vers les serveurs de la police.

Dans Navixy, sélectionnez **Yellow Machinery** dans les **Protocole** la liste déroulante.

La configuration comporte trois étapes, à réaliser dans cet ordre : générer un jeton, enregistrer vos machines auprès de la police, puis configurer le transfert dans Navixy. Les deux premières étapes se déroulent en dehors de Navixy.

## Ce que Navixy envoie

Navixy envoie une requête SOAP par message au `InsertarUbicacion` méthode. La requête contient les champs suivants :

| Champ                   | Contenu                                                                                                       |
| ----------------------- | ------------------------------------------------------------------------------------------------------------- |
| `PUSUARIO`              | L'identifiant de connexion enregistré auprès de la police colombienne                                         |
| `PTOKEN`                | Le jeton, pris dans le **Mot de passe** champ du retransmetteur                                               |
| `PIDUNIDAD`             | L'identifiant de la machine, issu de l'ID externe                                                             |
| `PFECHAGPS`             | Lorsque l'appareil a enregistré la position, au format `dd/MM/yyyy HH:mm:ss` heure colombienne                |
| `PLATITUD`, `PLONGITUD` | Position en degrés                                                                                            |
| `PVELOCIDAD`            | Vitesse                                                                                                       |
| `PDIRECCION`            | Cap sous forme de direction de la boussole                                                                    |
| `PEVENTO`               | Le code d'événement de police pour ce message                                                                 |
| `PIGNICION`             | `1` lorsque le contact est mis, `0` lorsqu'il est coupé                                                       |
| `PODOMETRO`             | Distance parcourue                                                                                            |
| `PSTATUS`               | `1` pour une position en temps réel, `9` pour une position que l'appareil a stockée et envoyée ultérieurement |

Navixy envoie chaque message, y compris les messages sans position.

Navixy convertit ses propres codes d'événement en codes attendus par la police. L'identification du conducteur, SOS, la mise et la coupure du contact, l'excès de vitesse, le mouvement non autorisé, la batterie de secours faible, le début et la fin du ralenti, la perte de GPS, l'Accélération brutale et le freinage, la déconnexion de l'antenne, le réveil, l'alarme de porte et l'alarme GSM d'humidité correspondent chacun à leur code de police. Tout autre message est déclaré comme une position de suivi de routine.

## Avant de commencer

Vous avez besoin des éléments suivants de la police colombienne :

* L'identifiant de connexion et le mot de passe de votre entreprise tels qu'enregistrés auprès de la police.
* Le code du fournisseur qui fait partie de l'identifiant de la machine.

Vous avez également besoin de **Postman**, installé ou dans sa version web, pour générer le jeton et enregistrer vos machines.

## Générez un jeton

Le jeton autorise toutes les opérations ultérieures, y compris le transfert des données. Générez-le avant d'enregistrer les machines.

Téléchargez la [collection Postman](https://drive.google.com/file/d/1XFe_vi22rHqqIDgLlAiTlcepLBBVPemZ/view) d'abord.

{% stepper %}
{% step %}

### Importez la collection

Ouvrez Postman, cliquez **Importer**, puis téléversez le fichier que vous avez téléchargé.

<div align="left"><figure><img src="https://2196179364-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F446mKak1zDrGv70ahuYZ%2Fuploads%2Fgit-blob-05666c301892ef9ca37f6be9de650c3cdd82f8b9%2Fimage.png?alt=media" alt="The Postman Import dialog with the Maquinaria Amarilla collection file selected"><figcaption><p>Importation de la collection dans Postman</p></figcaption></figure></div>
{% endstep %}

{% step %}

### Ouvrez la requête de jeton

Sélectionnez l'appel de génération du jeton, puis allez à **ValIngreso** section.

<div align="left"><figure><img src="https://2196179364-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F446mKak1zDrGv70ahuYZ%2Fuploads%2Fgit-blob-d364a2215f72954039aa24be82be435cc6e4ae7b%2Fimage.png?alt=media" alt="The ValIngreso section of the token generation request in Postman"><figcaption><p>L'appel de génération du jeton</p></figcaption></figure></div>
{% endstep %}

{% step %}

### Passez le corps sur l'onglet brut

Accédez à l’ **Corps** et sélectionnez **Brut**.
{% endstep %}

{% step %}

### Saisissez vos identifiants

Remplacez ces trois valeurs dans le corps de la requête :

* **Utilisateur**: l'identifiant de connexion de votre entreprise tel qu'il est enregistré auprès de la police
* **Mot de passe**: le mot de passe de votre entreprise tel qu'il est enregistré auprès de la police
* **Numéro valide**: un nombre au format `4.1234567890`

<figure><img src="https://2196179364-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F446mKak1zDrGv70ahuYZ%2Fuploads%2Fgit-blob-15bec39ce6c1dc4e4e3a03c69501893cf5faec4a%2Fimage.png?alt=media" alt="The token generation request body with the user, password, and valid number fields filled in"><figcaption><p>Les trois valeurs à remplacer dans le corps de la requête</p></figcaption></figure>
{% endstep %}

{% step %}

### Envoyez la requête

Envoyez la requête. Conservez le jeton de la réponse, car vous le saisirez plus tard dans Navixy.
{% endstep %}
{% endstepper %}

## Enregistrez les machines et les appareils

Enregistrez vos machines auprès de la police avant de transférer les données. Une position correspondant à une machine non enregistrée est rejetée.

Chaque étape utilise une collection Postman distincte. Dans chacune, saisissez l'identifiant de connexion et le jeton que vous avez généré, ainsi que les détails de la machine exactement tels qu'ils sont consignés dans votre feuille de calcul d'enregistrement.

{% stepper %}
{% step %}

### Ajoutez les appareils GPS

Importer [la collection d'appareils](https://drive.google.com/file/d/1C45u-A2n3E1wbteuLl_D-dqrxMbHJYGw/view?usp=share_link) dans Postman et envoyez la requête.
{% endstep %}

{% step %}

### Ajoutez les machines

Importer [la collection de machines](https://drive.google.com/file/d/1Y77If2KFPvnSIl-JZ6safx8Rm5nnI101/view) dans Postman et envoyez la requête.
{% endstep %}

{% step %}

### Liez les machines aux appareils

Importer [la collection de liaison](https://drive.google.com/file/d/1cfj26NXqdTvLIbSHWoeA-QSGDwz29EWk/view?usp=sharing) dans Postman et envoyez la requête.
{% endstep %}
{% endstepper %}

Chaque requête renvoie l'un de ces codes :

| Code  | Signification                                                                                                    |
| ----- | ---------------------------------------------------------------------------------------------------------------- |
| `001` | Le processus a démarré                                                                                           |
| `002` | L'enregistrement a été inséré avec succès                                                                        |
| `ER1` | Enregistrement en double. Les cinq chiffres qui suivent constituent le code d'erreur de la base de données.      |
| `ER2` | Autre erreur d'enregistrement. Les cinq chiffres qui suivent constituent le code d'erreur de la base de données. |
| `ER3` | L'utilisateur est incorrect, ou le jeton n'est plus actif                                                        |

Une machine est correctement enregistrée lorsque la réponse est `002`.

## Configurer le transfert des données

{% stepper %}
{% step %}

### Ouvrez le bloc Transfert des données

Accédez à **Paramétrage des traceurs**, sélectionnez un appareil, puis trouvez le **Transfert des données** bloc.
{% endstep %}

{% step %}

### Ouvrez la liste des protocoles

Cliquez sur **Protocoles**, puis cliquez **+** pour ajouter une configuration.
{% endstep %}

{% step %}

### Accédez aux paramètres de Maquinaria Amarilla

Renseignez les champs comme suit :

* **Nom** : un libellé qui identifie ce retransmetteur
* **Protocole**: **Yellow Machinery**
* **Adresse**: `https://logmqa.policia.gov.co/Service1.asmx`
* **Port**: `443`
* **Identifiant**: l'identifiant de connexion fourni par la police colombienne
* **Mot de passe**: le jeton que vous avez généré, et non votre mot de passe auprès de la police

<figure><img src="https://2196179364-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F446mKak1zDrGv70ahuYZ%2Fuploads%2Fgit-blob-b2b7cf251c487757b5d3f494fb82822f2a26fbe1%2Fimage.png?alt=media" alt="The Protocol editing dialog with Yellow Machinery selected and the police endpoint address entered" width="270"><figcaption><p>La configuration de Maquinaria Amarilla terminée</p></figcaption></figure>
{% endstep %}

{% step %}

### Activez et enregistrez

Activez **Activé**, puis cliquez **Enregistrer**. Un retransmetteur qui n’est pas activé n’envoie rien.
{% endstep %}

{% step %}

### Associez le retransmetteur à un appareil

Dans le **Transfert des données** bloc de l’appareil, activez l’interrupteur du retransmetteur que vous avez créé, puis cliquez sur **Enregistrer**.
{% endstep %}

{% step %}

### Définissez l’ID externe

Cliquez sur l'icône de lien à droite de la ligne du retransmetteur, puis saisissez l'identifiant de la machine qui inclut votre code fournisseur. Il peut comporter jusqu'à 20 caractères, en n'utilisant que des lettres majuscules et des chiffres.

Répétez cette étape et la précédente pour chaque machine qui transmet des données à la police.
{% endstep %}
{% endstepper %}

{% hint style="warning" %}
Le jeton expire. Lorsqu'il expire, le transfert s'arrête et les serveurs de la police répondent avec l'erreur `ER3`. Générez un nouveau jeton et saisissez-le dans le **Mot de passe** champ du retransmetteur pour reprendre.
{% endhint %}

## Gérez le transfert

Pour modifier ou arrêter le transfert vers Maquinaria Amarilla :

* Cliquez sur l’icône de lien à droite de la ligne du retransmetteur pour modifier l’ID externe d’un appareil.
* Désactivez l’interrupteur pour arrêter le transfert pour un appareil, tout en conservant la configuration pour les autres.
* Cliquez sur **Protocoles**, sélectionnez la ligne, puis modifiez-la pour changer le nom, l'adresse ou le jeton. La modification s'applique à tous les appareils liés à ce retransmetteur.
* Supprimez la configuration de la **Protocoles** liste pour arrêter le transfert pour tous les appareils. Confirmez dans la boîte de dialogue.

## Dépannage

Lorsque les données n'apparaissent pas dans le système Maquinaria Amarilla, vérifiez les points suivants dans l'ordre :

1. Le retransmetteur est activé et son interrupteur est activé pour l’appareil.
2. Le bloc **Mot de passe** le champ contient un jeton en cours de validité, et non votre mot de passe auprès de la police.
3. Le jeton n'a pas expiré. Un jeton expiré produit l'erreur `ER3`.
4. La machine et son appareil ont été enregistrés auprès de la police, et l'enregistrement a renvoyé `002`.
5. L’adresse et le port sont corrects.
6. L'ID externe correspond à l'identifiant de la machine enregistré auprès de la police, y compris le code fournisseur.


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://navixy.com/docs/user/fr/guide/devices-and-settings/connectivity/data-forwarding/maquinaria-amarilla.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
