> 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/simpliroute.md).

# SimpliRoute

Encaminhe posições dos veículos do Navixy para o SimpliRoute via HTTP, vinculando os dados de localização em tempo real aos pedidos de entrega gerenciados no SimpliRoute.

A SimpliRoute é um serviço de gestão de pedidos e rotas de entrega, e este protocolo encaminha para ela as posições dos veículos da Navixy. A SimpliRoute associa cada posição aos pedidos atribuídos a esse veículo, para que os despachantes possam acompanhar as entregas em relação à rota planejada. Ela é usada principalmente na América Latina.

Na Navixy, selecione **Rota simples** em **Protocolo** na lista suspensa. É assim que a SimpliRoute é nomeada na interface.

## O que a Navixy envia

A Navixy envia uma solicitação HTTP POST por posição, com um corpo JSON contendo estes campos:

| Campo                    | Conteúdo                                                            |
| ------------------------ | ------------------------------------------------------------------- |
| `idVeículo`              | O VIN do veículo vinculado ao dispositivo                           |
| `placa`                  | O número de registro do veículo, abreviado conforme descrito abaixo |
| `empresaProvedoraGPS`    | O número fiscal do Perfil da conta, que identifica o provedor GPS   |
| `acc`                    | Se a Ignição está ligada                                            |
| `latitude` e `longitude` | Posição em graus                                                    |
| `velocidade`             | Velocidade                                                          |
| `data e hora`            | Quando o dispositivo registrou a posição                            |

A SimpliRoute responde com `GPS ok.` quando aceita uma posição.

{% hint style="warning" %}
A Navixy encurta o número de registro antes de enviá-lo: ela remove espaços e hífens e, em seguida, mantém os seis primeiros caracteres. Uma placa registrada como `ABC-1234` é enviado como `ABC123`. Certifique-se de que o veículo esteja registrado no SimpliRoute na forma abreviada, ou o SimpliRoute não corresponderá a posição a um veículo.
{% endhint %}

### Quando a Navixy envia

A Navixy envia todas as Mensagens que tenham uma posição válida e tenham menos de 15 dias. Mensagens sem posição são ignoradas. O mesmo acontece com Mensagens com mais de 15 dias, que um dispositivo pode enviar depois de armazenar dados off-line por um longo período.

O ID externo não é usado por este protocolo. Em vez disso, a Navixy identifica o veículo pelo seu VIN e pelo número da placa.

## Antes de começar

Este protocolo lê os dados do veículo e da conta, em vez de obtê-los da configuração do retransmissor. Os três itens a seguir devem estar configurados, ou o retransmissor não enviará nada:

* A **número de identificação fiscal** no perfil da conta. A SimpliRoute o usa para identificar o provedor de GPS.
* A **veículo** vinculado ao dispositivo, criado em [Gestão de Frotas](/docs/user/pt-br/guide/fleet-management/vehicles.md).
* A **VIN** e um **número de registro** naquele veículo.

Confirme os três antes de criar o retransmissor. Se qualquer um estiver ausente, o encaminhamento falha silenciosamente: não há erro no **Encaminhamento de dados** bloco, e nenhum dado chega ao SimpliRoute.

Você também precisa do endereço do endpoint e da porta do SimpliRoute.

## Configurar o encaminhamento

{% stepper %}
{% step %}

### Verificar os dados do veículo e da conta

Confirme o número de identificação fiscal no perfil da conta e confirme que o dispositivo está vinculado a um veículo que tenha tanto um VIN quanto um número de registro.
{% endstep %}

{% step %}

### Abrir o bloco de Encaminhamento de dados

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

{% step %}

### Abrir a lista de protocolos

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

{% step %}

### Inserir as configurações do SimpliRoute

Preencha os campos da seguinte forma:

* **Nome**: um rótulo que identifica este retransmissor
* **Protocolo**: **Rota simples**
* **Endereço**: o endereço do endpoint do SimpliRoute
* **Porta**: a porta do SimpliRoute, normalmente `443`

Este protocolo não usa login nem senha. Deixe ambos os campos em branco.
{% endstep %}

{% step %}

### Ativar e salvar

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

{% step %}

### Vincular o retransmissor a um dispositivo

No **Encaminhamento de dados** bloco do dispositivo, ative a chave do retransmissor que você criou e, em seguida, clique em **Salvar**. Deixe o ID externo em branco, porque este protocolo não o usa.
{% endstep %}
{% endstepper %}

## Gerenciar o encaminhamento

Para alterar ou interromper o encaminhamento para o SimpliRoute:

* Desative a chave no **Encaminhamento de dados** bloco para interromper o encaminhamento de um dispositivo e mantenha a configuração para os outros.
* 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 para todos os dispositivos. Confirme na caixa de diálogo.

## Solução de problemas

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

1. O retransmissor está ativado e sua chave está ligada para o dispositivo.
2. O perfil da conta tem um número de identificação fiscal.
3. O dispositivo está vinculado a um veículo e esse veículo tem tanto um VIN quanto um número de registro. Um valor ausente aqui interrompe o encaminhamento sem nenhum erro visível.
4. O veículo está registrado no SimpliRoute com o número de registro abreviado, com espaços e hífens removidos e mantendo apenas os seis primeiros caracteres.
5. O endereço e a porta estão corretos.
6. O dispositivo reporta coordenadas válidas.


---

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