> 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 dos veículos do Navixy para o serviço SOAP Startrack, usado por operadores de frotas na Guatemala, em El Salvador e em Honduras.

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

No Navixy, selecione **Startrack** no **Protocolo** menu suspenso.

## O que a 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                                                              |
| `heading`                 | Direção do 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 uma posição são ignoradas.

## Antes de começar

Obtenha o endereço do endpoint e a porta da Startrack. O serviço geralmente é 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 External ID.

Este protocolo não usa login nem senha.

## Configurar encaminhamento

{% stepper %}
{% step %}

### Abra o bloco de Encaminhamento de dados

Acesse **Dispositivos e configurações**, selecione um dispositivo e depois encontre o **Encaminhamento de dados** bloco.
{% endstep %}

{% step %}

### Abra a lista de protocolos

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

{% step %}

### Insira as configurações do 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** e **Senha** em branco.
{% endstep %}

{% step %}

### Ativar e salvar

Ligue **Ativado**, depois clique em **Salvar**. Um retransmissor que não está ativado não envia nada.
{% endstep %}

{% step %}

### Vincular o retransmissor a um dispositivo

No bloco do **Encaminhamento de dados** dispositivo, ative a chave do retransmissor que você criou e depois clique em **Salvar**.
{% endstep %}

{% step %}

### Definir o ID externo

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

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

## Gerenciar encaminhamento de dados

Para alterar ou interromper o encaminhamento para o Startrack:

* Clique no ícone de link à direita da linha do retransmissor para alterar o ID externo de um dispositivo.
* Desative a chave para interromper o encaminhamento de um dispositivo e manter a configuração dos demais.
* Clique em **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 de todos os dispositivos. Confirme na caixa de diálogo.

## Solução de problemas

Quando os dados não aparecerem no Startrack, verifique o seguinte nesta ordem:

1. O retransmissor está ativado e sua chave está ligada 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 do Startrack.
4. O dispositivo reporta coordenadas válidas.
5. O Startrack confirma que recebe os dados.

### Testar o endpoint diretamente

Para verificar se o endpoint do 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>` elemento e o `ADDED_TO_RECORD_Q` status juntos confirmam que a Startrack enfileirou a posição 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 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/pt-br/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.