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

# Startrack

Transférez les positions des véhicules de Navixy vers le service SOAP Startrack, utilisé par les exploitants de flottes au Guatemala, au Salvador et au Honduras.

Startrack reçoit les positions des véhicules depuis Navixy et les met à la disposition de ses propres outils de surveillance et de gestion. Les exploitants de flotte d’Amérique centrale l’utilisent, principalement au Guatemala, au Salvador et au Honduras, pour la Gestion de Flotte, les opérations industrielles et de construction, ainsi que le transport à température dirigée.

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

## Ce que Navixy envoie

Navixy envoie une requête SOAP par position à la `receiveWithConfirmation` méthode. La requête contient les champs suivants :

| Champ                     | Contenu                                                                                                           |
| ------------------------- | ----------------------------------------------------------------------------------------------------------------- |
| `vehicleId`               | L’identifiant externe de l’appareil, ou l’identifiant de l’appareil Navixy lorsque l’identifiant externe est vide |
| `dateAndTime`             | Quand l’appareil a enregistré la position, au format ISO 8601                                                     |
| `y`                       | Latitude en degrés                                                                                                |
| `x`                       | Longitude en degrés                                                                                               |
| `kmph`                    | Vitesse en kilomètres par heure                                                                                   |
| `cap`                     | Direction de déplacement en degrés                                                                                |
| `ignitionIsOn`            | Indique si le contact est mis                                                                                     |
| `locationIsValid`         | Indique si la position correspond à un fix GPS valide                                                             |
| `trackingServiceProvider` | Always `navixy-retranslator`, en identifiant Navixy comme source                                                  |

Notez que `x` est la longitude et `y` est la latitude.

Startrack confirme une position acceptée avec `<ok>true</ok>` dans la réponse.

### Quand Navixy envoie

Navixy envoie tous les messages contenant des coordonnées valides. Les messages sans position sont ignorés.

## Avant de commencer

Récupérez l’adresse du point de terminaison et le port auprès de Startrack. Le service est généralement accessible à l’adresse `https://cempro.gps.gt/gpsDataService?wsdl` sur le port `443`.

Vous avez également besoin de l’identifiant de véhicule que Startrack utilise pour chaque appareil, à renseigner dans le champ External ID.

Ce protocole n’utilise ni identifiant ni mot de passe.

## 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 Startrack

Renseignez les champs comme suit :

* **Nom** : un libellé qui identifie ce retransmetteur
* **Protocole**: **Startrack**
* **Adresse**: `https://cempro.gps.gt/gpsDataService?wsdl`
* **Port**: `443`

Laissez **Identifiant** et **Mot de passe** vide.
{% 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 véhicule utilisé par Startrack. Navixy accepte n’importe quelle valeur ici, donc une valeur qui ne correspond pas à l’enregistrement Startrack est enregistrée, puis ignorée par Startrack.

Répétez cette étape et la précédente pour chaque appareil qui transmet à Startrack.
{% endstep %}
{% endstepper %}

## Gérez le transfert

Pour modifier ou arrêter la transmission vers Startrack :

* 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 et modifiez-la pour changer le nom, l’adresse ou le port. 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 Startrack, vérifiez les points suivants dans cet ordre :

1. Le retransmetteur est activé et son interrupteur est activé pour l’appareil.
2. L’adresse et le port sont corrects.
3. L’External ID correspond à l’identifiant de véhicule enregistré côté Startrack.
4. L’appareil indique des coordonnées valides.
5. Startrack confirme qu’il reçoit les données.

### Testez directement le point de terminaison

Pour vérifier que le point de terminaison Startrack accepte les données, envoyez une requête SOAP avec `curl` en utilisant un fichier XML préparé. Une réponse réussie ressemble à ceci :

{% code overflow="wrap" %}

```xml
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <ns2:receiveWithConfirmationResponse xmlns:ns2="https://cempro.gps.gt">
      <return>
        <ok>true</ok>
        <result>isOk:true statuses:[ADDED_TO_RECORD_Q] messages:[added to recorder queue]</result>
      </return>
    </ns2:receiveWithConfirmationResponse>
  </soap:Body>
</soap:Envelope>
```

{% endcode %}

Le bloc `<ok>true</ok>` élément et le `ADDED_TO_RECORD_Q` statut confirment ensemble que Startrack a placé la position dans la file d’attente pour traitement.


---

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