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

# Startrack

Encaminhe posições de veículos do Navixy para o serviço SOAP Startrack, usado por operadores de frota na Guatemala, em El Salvador e em Honduras.

A Startrack recebe as posições dos veículos da Navixy e as disponibiliza em suas próprias ferramentas de monitoramento e gestão. Operadores de frota na América Central a utilizam, principalmente na Guatemala, em El Salvador e em Honduras, para Gestão de Frotas, operações industriais e de construção e transporte com temperatura controlada.

No Navixy, selecione **Startrack** em **Protocolo** o menu suspenso.

## O que o Navixy envia

A Navixy envia uma solicitação SOAP por posição para o `receiveWithConfirmation` método. A solicitação contém estes campos:

| Campo                     | Conteúdo                                                                                        |
| ------------------------- | ----------------------------------------------------------------------------------------------- |
| `vehicleId`               | O ID Externo do dispositivo, ou o id do dispositivo na Navixy quando o ID Externo estiver vazio |
| `dateAndTime`             | Quando o dispositivo registrou a posição, em ISO 8601                                           |
| `y`                       | Latitude em graus                                                                               |
| `x`                       | Longitude em graus                                                                              |
| `kmph`                    | Velocidade em quilômetros por hora                                                              |
| `rumo`                    | Direção de deslocamento em graus                                                                |
| `ignitionIsOn`            | Se a Ignição está ligada                                                                        |
| `locationIsValid`         | Se a posição é um fix GPS válido                                                                |
| `trackingServiceProvider` | Sempre `navixy-retranslator`, identificando a Navixy como a origem                              |

Observe que `x` é a longitude e `y` é a latitude.

A Startrack confirma uma posição aceita com `<ok>true</ok>` na resposta.

### Quando a Navixy envia

A Navixy envia todas as Mensagens que têm coordenadas válidas. Mensagens sem posição são ignoradas.

## Antes de começar

Obtenha o endereço e a porta do endpoint com a Startrack. O serviço é normalmente acessado em `https://cempro.gps.gt/gpsDataService?wsdl` na porta `443`.

Você também precisa do identificador do veículo que a Startrack usa para cada dispositivo, que vai no campo ID Externo.

Este protocolo não usa login nem senha.

## Configurar encaminhamento

{% stepper %}
{% step %}

### Abra o bloco Encaminhamento de dados

Dispositivos e configurações **na barra lateral esquerda.**, selecione um dispositivo e, em seguida, encontre o **Encaminhamento de dados** bloco.
{% endstep %}

{% step %}

### Abra a lista de protocolos

Salvar **Protocolos**, depois clique em **+** para adicionar uma configuração.
{% endstep %}

{% step %}

### Insira as configurações da Startrack

Preencha os campos da seguinte forma:

* **Nome**: um rótulo que identifica este retransmissor
* **Protocolo**: **Startrack**
* **Endereço**: `https://cempro.gps.gt/gpsDataService?wsdl`
* **Porta**: `443`

Deixe **Login** Webhook **Senha** em branco.
{% endstep %}

{% step %}

### Ative e salve

Ative **Ativado**, depois clique em **para salvar o comando. Clique em**. Um retransmissor que não está ativado não envia nada.
{% endstep %}

{% step %}

### Vincule o retransmissor a um dispositivo

No dispositivo **Encaminhamento de dados** bloco, ative o alternador do retransmissor que você criou e, em seguida, clique **para salvar o comando. Clique em**.
{% endstep %}

{% step %}

### Defina o ID externo

Clique no ícone de link à direita da linha do retransmissor e, em seguida, insira o identificador do veículo que a Startrack usa. A Navixy aceita qualquer valor aqui, portanto um valor que não corresponda ao registro da Startrack é salvo e depois ignorado pela Startrack.

Repita esta etapa e a anterior para cada dispositivo que encaminha para a Startrack.
{% endstep %}
{% endstepper %}

## Gerenciar encaminhamento

Para alterar ou interromper o encaminhamento para a Startrack:

* Clique no ícone de link à direita da linha do retransmissor para alterar o ID externo de um dispositivo.
* Desative o alternador para interromper o encaminhamento de um dispositivo e manter a configuração para os outros.
* Salvar **Protocolos**, selecione a linha e edite-a para alterar o nome, o endereço ou a porta. A alteração se aplica a todos os dispositivos vinculados a este retransmissor.
* Exclua a configuração da **Protocolos** lista para interromper o encaminhamento para todos os dispositivos. Confirme na caixa de diálogo.

## Solução de problemas

Quando os dados não aparecem na Startrack, verifique o seguinte nesta ordem:

1. O retransmissor está ativado e seu alternador está ligado para o dispositivo.
2. O endereço e a porta estão corretos.
3. O ID Externo corresponde ao identificador do veículo registrado no lado da Startrack.
4. O dispositivo informa coordenadas válidas.
5. A Startrack confirma que recebe os dados.

### Teste o endpoint diretamente

Para verificar se o endpoint da Startrack aceita dados, envie uma solicitação SOAP com `curl` usando um arquivo XML preparado. Uma resposta bem-sucedida se parece com isto:

{% 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] mensagens:[adicionado à fila do gravador]</result>
      </return>
    </ns2:receiveWithConfirmationResponse>
  </soap:Body>
</soap:Envelope>
```

{% endcode %}

O `<ok>true</ok>` o elemento e o `ADDED_TO_RECORD_Q` status juntos confirmam que a Startrack colocou a posição na fila para processamento.


---

# 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/pt-br/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.