> 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 lui transmet les positions des véhicules depuis Navixy. Les départements logistiques des entreprises manufacturières et de vente au détail l’utilisent pour recevoir des 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 accès au compte Navixy.

Unigis est le plus répandu parmi les entreprises aux États-Unis, au Mexique, en Colombie, au Chili, en Argentine, au Brésil et en Espagne.

Dans Navixy, sélectionnez **UNIGIS** dans le **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 à `Connexion et insertion d’événement` méthode du point de terminaison Unigis. Le corps est encodé en Formulaire et 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'ID externe de l'appareil, ou l'ID de l'appareil Navixy lorsque l'ID 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`                                   | Cap                                                                                        |
| `Date et heure de l’événement`          | Moment où 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 distincts. Chacun arrive comme une valeur dans `Code` dans 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 coupe la connexion et réessaie.

### Quand Navixy envoie

Navixy envoie au maximum une position par minute et par appareil. Lorsqu'un appareil remonte des données plus souvent que cela, 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�a0:

* 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 le moment.

## Avant de commencer

Recueillez les éléments suivants depuis Unigis�a0:

* L'adresse et le port du point de terminaison. Unigis exploite plusieurs hubs, alors confirmez lequel s'applique à votre compte.
* Votre identifiant et votre mot de passe Unigis. Navixy a besoin des 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, laquelle est renseignée dans le champ External ID 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 recherchez le **Transfert des données** bloc.
{% endstep %}

{% step %}

### Ouvrez la liste des protocoles

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

{% step %}

### Saisissez les paramètres Unigis

Remplissez 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`. Saisissez l'adresse complète qu'Unigis vous a fournie plutôt que de vous fier à cette valeur par défaut.
{% endstep %}

{% step %}

### Activez et enregistrez

Activez **Activé**, puis cliquez sur **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, activez le bouton bascule 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 redirige vers Unigis. La configuration du retransmetteur est partagée au niveau du compte, mais External ID est défini pour chaque appareil.
{% endstep %}
{% endstepper %}

## Gérer le transfert

Pour modifier ou arrêter la redirection 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 le bouton bascule pour arrêter le transfert pour un appareil, tout en conservant la configuration pour les autres.
* Cliquez sur **Protocoles**sélectionnez la ligne et 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 éléments suivants dans l’ordre :

1. Le retransmetteur est activé, et son bouton bascule 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 non seulement la première.
3. L’adresse inclut le chemin complet que Unigis vous a fourni, et le port est correct.
4. L'External ID correspond à la Plaque d'immatriculation enregistrée côté Unigis.
5. L'appareil signale des coordonnées valides. Les positions sans acquisition GPS ne sont jamais redirigées.

Lorsque les positions arrivent mais sont moins nombreuses que prévu, cela correspond à la limite d’une minute plutôt qu’à un dysfonctionnement. 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.
