> 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 de Navixy et les met à disposition de ses propres outils de supervision et de gestion. Les exploitants de flottes en 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, et le transport sous température dirigée.

Dans Navixy, sélectionnez **Startrack** dans le **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'ID externe de l'appareil, ou l'ID de l'appareil Navixy lorsque l'ID externe est vide |
| `dateAndTime`             | Moment où 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                                                        |
| `heading`                 | Direction du déplacement en degrés                                                     |
| `ignitionIsOn`            | Indique si le contact est activé                                                       |
| `locationIsValid`         | Indique si la position est un fix GPS valide                                           |
| `trackingServiceProvider` | Always `navixy-retranslator`, qui identifie Navixy comme source                        |

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

Startrack confirme la prise en compte d'une position avec `<ok>true</ok>` dans la réponse.

### Quand Navixy envoie

Navixy envoie chaque message qui possède 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 à `https://cempro.gps.gt/gpsDataService?wsdl` sur le port `443`.

Vous avez aussi besoin de l'identifiant du véhicule que Startrack utilise pour chaque appareil, lequel doit être renseigné dans le champ ID externe.

Ce protocole n'utilise ni identifiant de connexion 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 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 de Startrack

Remplissez 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 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 l'identifiant du 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érer 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 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 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 bouton bascule est activé pour l’appareil.
2. L’adresse et le port sont corrects.
3. L'ID externe correspond à l'identifiant du véhicule enregistré côté Startrack.
4. L'appareil transmet des coordonnées valides.
5. Startrack confirme qu'il reçoit les données.

### Tester le point de terminaison directement

Pour vérifier que le point de terminaison Startrack accepte les données, envoyez une requête SOAP avec `curl` à l'aide d'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:[ajouté à la file d'attente de l'enregistreur]</result>
      </return>
    </ns2:receiveWithConfirmationResponse>
  </soap:Body>
</soap:Envelope>
```

{% endcode %}

Le `<ok>true</ok>` élément et le `ADDED_TO_RECORD_Q` statut confirment ensemble que Startrack a placé la position en 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.