> 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 TMS Unigis, 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, notamment les 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 courant auprès des entreprises situées 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** liste déroulante. 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 `LoginYInsertarEvento` méthode du point de terminaison Unigis. Le corps est encodé sous forme de formulaire et contient les champs suivants :

| Champ                               | Contenu                                                                                          |
| ----------------------------------- | ------------------------------------------------------------------------------------------------ |
| `SystemUser` et `Mot de passe`      | Les identifiants Unigis issus de la configuration du retransmetteur, envoyés avec chaque requête |
| `Dominio`                           | L’ID externe de l’appareil, ou l’ID de l’appareil Navixy lorsque l’ID externe est vide           |
| `Codigo`                            | 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/heure de l'événement`         | Au moment où l’appareil a enregistré la position, au format ISO 8601                             |
| `Date/heure de réception`           | Lorsque Navixy a reçu le message, au format ISO 8601                                             |

Les événements tels qu'une alarme de porte, une pression sur le Bouton panique ou un arrêt moteur ne constituent pas des champs distincts. Chacun arrive comme une valeur dans `Codigo` le message qui le signale.

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

### Quand Navixy envoie

Navixy envoie au maximum une position par minute et par appareil. Lorsqu'un appareil transmet plus souvent que cela, les positions intermédiaires sont ignorées plutôt que mises en file d'attente, si bien 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

Collectez les éléments suivants auprès d'Unigis :

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

Vous avez également besoin de la Plaque d'immatriculation telle qu’elle est enregistrée côté Unigis ; elle va 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 traceur, puis recherchez 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

Remplissez les champs comme suit :

* **Nom**: une étiquette 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`
* **Login** 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 fournie par Unigis plutôt que de vous fier à 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 %}

### Liez le retransmetteur à un traceur

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’enregistrée côté Unigis. Cliquez **Enregistrer**.

Répétez cette étape et la précédente pour chaque appareil qui transfère vers Unigis. La configuration du retransmetteur est partagée sur l’ensemble du compte, mais l’External ID est défini par appareil.
{% endstep %}
{% endstepper %}

## Gérer 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 traceur.
* Désactivez le bouton bascule pour arrêter le transfert pour un traceur, et conservez 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 à chaque traceur lié à ce retransmetteur.
* Supprimez la configuration de la **Protocoles** liste pour arrêter le transfert pour tous les traceurs. Confirmez dans la boîte de dialogue.

## Dépannage

Si les données n’apparaissent pas dans Unigis, vérifiez les points suivants dans cet ordre :

1. Le retransmetteur est activé, et son bouton bascule est activé pour le traceur.
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’External ID correspond à la Plaque d'immatriculation enregistrée côté Unigis.
5. L’appareil signale des coordonnées valides. Les positions sans fix GPS ne sont jamais transmises.

Lorsque des positions arrivent mais qu’elles sont moins nombreuses que prévu, il s’agit de la limite d’une minute et non d’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 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/fr/guide/devices-and-settings/connectivity/data-forwarding/unigis.md?ask=<question>&goal=<endgoal>
```

`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.