Aller au contenu
For the complete documentation index, see llms.txt. This page is also available as Markdown.

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 d'abord.

1

Importez la collection

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

The Postman Import dialog with the Maquinaria Amarilla collection file selected
Importation de la collection dans Postman
2

Ouvrez la requête de jeton

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

The ValIngreso section of the token generation request in Postman
L'appel de génération du jeton
3

Passez le corps sur l'onglet brut

Accédez à l’ Corps et sélectionnez Brut.

4

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

The token generation request body with the user, password, and valid number fields filled in
Les trois valeurs à remplacer dans le corps de la requête
5

Envoyez la requête

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

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.

1

Ajoutez les appareils GPS

Importer la collection d'appareils dans Postman et envoyez la requête.

2

Ajoutez les machines

Importer la collection de machines dans Postman et envoyez la requête.

3

Liez les machines aux appareils

Importer la collection de liaison dans Postman et envoyez la requête.

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

1

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.

2

Ouvrez la liste des protocoles

Cliquez sur Protocoles, puis cliquez + pour ajouter une configuration.

3

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

The Protocol editing dialog with Yellow Machinery selected and the police endpoint address entered
La configuration de Maquinaria Amarilla terminée
4

Activez et enregistrez

Activez Activé, puis cliquez Enregistrer. Un retransmetteur qui n’est pas activé n’envoie rien.

5

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.

6

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.

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.

Mis à jour

Ce contenu vous a-t-il été utile ?