> 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

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

Startrack recibe las posiciones de los vehículos de Navixy y las pone a disposición de sus propias herramientas de monitoreo y gestión. Los operadores de flotas en Centroamérica la 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** lista desplegable.

## Lo que envía Navixy

Navixy envía una solicitud SOAP por posición al método `receiveWithConfirmation` . 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`             | Cuándo registró el dispositivo la posición, en ISO 8601                                          |
| `y`                       | Latitud en grados                                                                                |
| `x`                       | Longitud en grados                                                                               |
| `kmph`                    | Velocidad en kilómetros por hora                                                                 |
| `heading`                 | Dirección de desplazamiento en grados                                                            |
| `ignitionIsOn`            | Si la ignición está encendida                                                                    |
| `locationIsValid`         | Si la posición es una fijación GPS válida                                                        |
| `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 todos los mensajes que tienen coordenadas válidas. Los mensajes sin una posición se omiten.

## Antes de comenzar

Obtenga de Startrack la dirección del endpoint y el puerto. Por lo general, el servicio se encuentra 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 usuario ni contraseña.

## Configurar el reenvío

{% stepper %}
{% step %}

### Abra el bloque Reenvío de datos

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

{% step %}

### Abra la lista de protocolos

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

{% step %}

### Ingrese 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 **Inicio de sesión** y **Contraseña** vacíos.
{% endstep %}

{% step %}

### Habilite y guarde

Active **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 **Reenvío de datos** bloque del dispositivo, 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 y 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 ícono 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 conserve la configuración para 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 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 del lado de Startrack.
4. El dispositivo informa coordenadas válidas.
5. Startrack confirma que recibe los datos.

### Pruebe 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 estados:[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 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/es/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.