> 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 opérateurs de flotte 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 surveillance et de gestion. Les opérateurs 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 contrôlée.

Dans Navixy, sélectionnez **Startrack** dans la **Protocole** 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`             | Au 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 mis                                                          |
| `locationIsValid`         | Indique si la position correspond à un fix GPS valide                                  |
| `trackingServiceProvider` | Toujours `navixy-retranslator`, en identifiant Navixy comme source                     |

Notez que `x` correspond à la longitude et `y` correspond à la latitude.

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

### Lorsque Navixy envoie

Navixy envoie chaque message qui contient des coordonnées valides. Les messages sans position sont ignorés.

## Avant de commencer

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

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

Ce protocole n'utilise ni identifiant de connexion ni mot de passe.

## Configurer le transfert

{% 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 sur **+** pour ajouter une configuration.
{% endstep %}

{% step %}

### Saisissez les paramètres Startrack

Renseignez les champs comme suit :

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

Laissez **l'identifiant** et **le mot de passe** vides.
{% 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 de l'appareil, activez le commutateur du retransmetteur que vous avez créé, puis cliquez sur **Enregistrer**.
{% endstep %}

{% step %}

### Définir l'ID externe

Cliquez sur l'icône de lien à droite de la ligne du retransmetteur, puis saisissez l'identifiant du véhicule que Startrack utilise. 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 le transfert 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 commutateur pour arrêter le transfert d'un appareil, et conservez 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 l'ordre :

1. Le retransmetteur est activé et son commutateur 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 signale 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 %}

L’ `<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 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/startrack.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.