> 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/unigis.md).

# Unigis

Transférez les données GPS et télématiques de Navixy vers la plateforme Unigis TMS, en envoyant une position par minute et par véhicule via HTTP.

Unigis est un système de gestion du transport, et le protocole de Transfert des données Unigis y transmet les positions des véhicules depuis Navixy. Les Départements logistiques des entreprises de fabrication et de vente au détail l’utilisent pour recevoir les données de leurs transporteurs, y compris des fournisseurs de chaînes telles que Walmart, Home Garage et Kimberly-Clark. Un transporteur peut envoyer des données à Unigis sans donner à l’entreprise destinataire l’accès au compte Navixy.

Unigis est le plus couramment utilisé par des entreprises aux États-Unis, au Mexique, en Colombie, au Chili, en Argentine, au Brésil et en Espagne.

Dans Navixy, sélectionnez **UNIGIS** dans les **Protocole** menu déroulant. C’est ainsi qu’Unigis est nommé dans l’interface.

## Ce que Navixy envoie

Navixy envoie une requête HTTP POST par position vers le `ConnexionEtInsérerÉvénement` méthode du point de terminaison Unigis. Le corps est encodé au format formulaire et il contient les champs suivants :

| Champ                                   | Contenu                                                                                                           |
| --------------------------------------- | ----------------------------------------------------------------------------------------------------------------- |
| `Utilisateur système` et `Mot de passe` | Les identifiants Unigis de la configuration du retransmetteur, envoyés avec chaque requête                        |
| `Domaine`                               | L’identifiant externe de l’appareil, ou l’identifiant de l’appareil Navixy lorsque l’identifiant externe est vide |
| `Code`                                  | Le code d'événement Navixy pour ce message                                                                        |
| `Latitude`, `Longitude`, `Altitude`     | Position en degrés, altitude en mètres                                                                            |
| `Vitesse`                               | Vitesse                                                                                                           |
| `Cap`                                   | Orientation                                                                                                       |
| `Date et heure de l'événement`          | Quand l’appareil a enregistré la position, au format ISO 8601                                                     |
| `Date et heure de réception`            | Quand Navixy a reçu le message, au format ISO 8601                                                                |

Les événements tels qu'une alarme de porte, un appui sur le Bouton panique ou l'arrêt du moteur ne sont pas des champs séparés. Chacun arrive sous forme de valeur dans `Code` sur le message qui le signale.

Unigis répond à chaque requête par un code numérique. Un code négatif signifie qu'Unigis a rejeté la position, et Navixy ferme la connexion puis réessaie.

### Quand Navixy envoie

Navixy envoie au plus une position par minute et par appareil. Lorsqu'un appareil remonte des données plus fréquemment, les positions intermédiaires sont ignorées plutôt que mises en file d'attente, de sorte que les données dans Unigis constituent un échantillon d'une minute et non une trace complète.

Deux règles priment sur la limite d'une minute :

* Un événement urgent est envoyé dès qu'il arrive, même si la position précédente a été envoyée il y a moins d'une minute.
* Un message sans coordonnées valides n'est jamais envoyé, quel que soit son moment d'envoi.

## Avant de commencer

Récupérez les éléments suivants auprès d'Unigis :

* L'adresse et le port du point de terminaison. Unigis exploite plusieurs hubs ; confirmez donc lequel s'applique à votre compte.
* Votre identifiant et votre mot de passe Unigis. Navixy exige les deux et n'enregistrera pas le retransmetteur sans eux.

Vous avez également besoin de la Plaque d'immatriculation telle qu’elle est enregistrée du côté d’Unigis, et elle doit être saisie dans le champ ID externe de chaque appareil. Navixy accepte ici toute valeur non vide, donc une Plaque d'immatriculation qui ne correspond pas à l’enregistrement Unigis est acceptée lors de l’enregistrement puis rejetée par Unigis.

## 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 %}

### Saisissez les paramètres Unigis

Renseignez les champs comme suit :

* **Nom** : un libellé qui identifie ce retransmetteur
* **Protocole**: **UNIGIS**
* **Adresse** : l’adresse du point de terminaison fournie par Unigis, par exemple `http://unigis2.unisolutions.com.ar/HUB/UNIGIS/MAPI/SOAP/GPS/Service.asmx`
* **Port** : le port fourni par Unigis, généralement `80`
* **Identifiant** et **Mot de passe** : vos identifiants Unigis

Lorsque vous saisissez une adresse sans chemin, Navixy utilise `/HUB/UNIGIS/MAPI/SOAP/COMMServer/service.asmx` l’adresse complète fournie par Unigis plutôt que de vous appuyer sur cette valeur par défaut.
{% 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 la Plaque d'immatriculation telle qu’elle est enregistrée du côté d’Unigis. Cliquez **Enregistrer**.

Répétez cette étape ainsi que la précédente pour chaque appareil qui transfère vers Unigis. La configuration du retransmetteur est partagée dans tout le compte, mais l'ID externe est défini pour chaque appareil.
{% endstep %}
{% endstepper %}

## Gérez le transfert

Pour modifier ou arrêter le transfert vers Unigis :

* 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 les identifiants. 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 Unigis, vérifiez les points suivants dans l'ordre :

1. Le retransmetteur est activé et son interrupteur est activé pour l’appareil.
2. L'identifiant et le mot de passe correspondent à vos identifiants Unigis. Navixy les envoie avec chaque position, donc un mot de passe incorrect fait échouer chaque requête, et pas seulement la première.
3. L'adresse inclut le chemin complet que Unigis vous a fourni, et le port est correct.
4. L'ID externe correspond à la Plaque d'immatriculation enregistrée du côté d'Unigis.
5. L'appareil signale des coordonnées valides. Les positions sans fix GPS ne sont jamais transférées.

Lorsque des positions arrivent mais qu'elles sont moins nombreuses que prévu, il s'agit de la limite d'une minute plutôt que d'une anomalie. Unigis reçoit un échantillon d'une minute de la trace.


---

# 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/unigis.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.
