> 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/es/guide/devices-and-settings/connectivity/data-forwarding/startrack.md).

# Startrack

Reenvíe las posiciones de los vehículos desde Navixy al servicio SOAP Startrack, utilizado por operadores de flotas en Guatemala, El Salvador y Honduras.

Startrack recibe las posiciones de los vehículos desde Navixy y las pone a disposición de sus propias herramientas de monitoreo y gestión. Los operadores de flotas en Centroamérica lo usan, principalmente en Guatemala, El Salvador y Honduras, para la gestión de flotas, operaciones industriales y de construcción, y transporte con control de temperatura.

En Navixy, seleccione **Startrack** en la **Protocolo** el menú desplegable.

## Lo que envía Navixy

Navixy envía una solicitud SOAP por cada posición al `receiveWithConfirmation` método. La solicitud contiene estos campos:

| Campo                     | Contenido                                                                                        |
| ------------------------- | ------------------------------------------------------------------------------------------------ |
| `vehicleId`               | El ID externo del dispositivo, o el ID del dispositivo de Navixy cuando el ID externo esté vacío |
| `dateAndTime`             | Cuando el dispositivo registró la posición, en ISO 8601                                          |
| `y`                       | Latitud en grados                                                                                |
| `x`                       | Longitud en grados                                                                               |
| `kmph`                    | Velocidad en kilómetros por hora                                                                 |
| `rumbo`                   | Dirección de desplazamiento en grados                                                            |
| `ignitionIsOn`            | Si la ignición está encendida                                                                    |
| `locationIsValid`         | Si la posición es una fijación válida de GPS                                                     |
| `trackingServiceProvider` | Siempre `navixy-retranslator`, identificando a Navixy como la fuente                             |

Tenga en cuenta que `x` es la longitud y `y` es la latitud.

Startrack confirma una posición aceptada con `<ok>true</ok>` en la respuesta.

### Cuando Navixy envía

Navixy envía cada mensaje que tiene coordenadas válidas. Los mensajes sin una posición se omiten.

## Antes de comenzar

Obtenga la dirección del endpoint y el puerto de Startrack. El servicio normalmente está disponible en `https://cempro.gps.gt/gpsDataService?wsdl` en el puerto `443`.

También necesita el identificador del vehículo que Startrack usa para cada dispositivo, el cual va en el campo ID externo.

Este protocolo no usa inicio de sesión ni contraseña.

## Configurar el reenvío de datos

{% stepper %}
{% step %}

### Abra el bloque Reenvío de datos

Vaya a **Dispositivos**, seleccione un dispositivo y luego busque el **Reenvío de datos** .
{% endstep %}

{% step %}

### Abra la lista de protocolos

Haga clic en **Protocolos**, luego haga clic en **+** para agregar una configuración.
{% endstep %}

{% step %}

### Ingresar la configuración de Startrack

Complete los campos de la siguiente manera:

* **Nombre**: una etiqueta que identifica este retransmisor
* **Protocolo**: **Startrack**
* **Dirección**: `https://cempro.gps.gt/gpsDataService?wsdl`
* **Puerto**: `443`

Deje **Usuario** y **Contraseña** vacío.
{% endstep %}

{% step %}

### Habilitar y guardar

Actívelo **Habilitado**, luego haga clic en **Guardar**. Un retransmisor que no está habilitado no envía nada.
{% endstep %}

{% step %}

### Vincule el retransmisor a un dispositivo

En el bloque del dispositivo **Reenvío de datos** active el interruptor del retransmisor que creó y luego haga clic en **Guardar**.
{% endstep %}

{% step %}

### Establezca el ID externo

Haga clic en el ícono de enlace a la derecha de la fila del retransmisor, luego ingrese el identificador del vehículo que usa Startrack. Navixy acepta cualquier valor aquí, por lo que un valor que no coincida con el registro de Startrack se guarda y luego Startrack lo ignora.

Repita este paso y el anterior para cada dispositivo que reenvía a Startrack.
{% endstep %}
{% endstepper %}

## Administrar el reenvío

Para cambiar o detener el reenvío a Startrack:

* Haga clic en el icono de enlace a la derecha de la fila del retransmisor para cambiar el ID externo de un dispositivo.
* Desactive el interruptor para detener el reenvío de un dispositivo y conservar la configuración de los demás.
* Haga clic en **Protocolos**, seleccione la fila y edítela para cambiar el nombre, la dirección o el puerto. El cambio se aplica a cada dispositivo vinculado a este retransmisor.
* Elimine la configuración de la **Protocolos** lista para detener el reenvío para todos los dispositivos. Confirme en el cuadro de diálogo.

## Solución de problemas

Cuando los datos no aparecen en Startrack, verifique lo siguiente en este orden:

1. El retransmisor está habilitado y su interruptor está activado para el dispositivo.
2. La dirección y el puerto son correctos.
3. El ID externo coincide con el identificador del vehículo registrado en Startrack.
4. El dispositivo reporta coordenadas válidas.
5. Startrack confirma que recibe los datos.

### Probar el endpoint directamente

Para comprobar que el endpoint de Startrack acepta datos, envíe una solicitud SOAP con `curl` usando un archivo XML preparado. Una respuesta exitosa se ve así:

{% 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] mensajes:[agregado a la cola del grabador]</result>
      </return>
    </ns2:receiveWithConfirmationResponse>
  </soap:Body>
</soap:Envelope>
```

{% endcode %}

El `<ok>true</ok>` elemento y el `ADDED_TO_RECORD_Q` estado juntos confirman que Startrack puso la posición en cola para su procesamiento.


---

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