> 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 de veículos do Navixy para o SimpliRoute via HTTP, vinculando dados de localização em tempo real aos pedidos de entrega gerenciados no SimpliRoute.

O SimpliRoute é um serviço de gestão de rotas de entrega e pedidos, e este protocolo encaminha para ele as posições dos veículos vindas da Navixy. O 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. Ele é usado principalmente na América Latina.

No Navixy, selecione **Rota simples** em **Protocolo** menu suspenso. É assim que o SimpliRoute é chamado na interface.

## O que o Navixy envia

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

| Campo                          | Conteúdo                                                             |
| ------------------------------ | -------------------------------------------------------------------- |
| `idVehiculo`                   | O VIN do veículo vinculado ao dispositivo                            |
| `patent`                       | O número de registro do veículo, abreviado conforme descrito abaixo  |
| `empresaProveedoraGps`         | O número fiscal do perfil da conta, que identifica o provedor de GPS |
| `acc`                          | Se a Ignição está ligada                                             |
| `latitude` Webhook `longitude` | Posição em graus                                                     |
| `velocidade`                   | Velocidade                                                           |
| `datetime`                     | Quando o dispositivo registrou a posição                             |

O 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 primeiros seis caracteres. Uma placa registrada como `ABC-1234` é enviada como `ABC123`. Certifique-se de que o veículo esteja cadastrado no SimpliRoute na forma abreviada, ou o SimpliRoute não associará a posição a um veículo.
{% endhint %}

### Quando a Navixy envia

A Navixy envia todas as mensagens que têm uma posição válida e menos de 15 dias. Mensagens sem posição são ignoradas. O mesmo vale para mensagens com mais de 15 dias, que um dispositivo pode enviar após armazenar dados offline por um longo período.

O ID externo não é usado por este protocolo. A Navixy identifica o veículo pelo VIN e pelo número de registro em vez disso.

## 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 em vigor, ou o retransmissor não envia absolutamente nada:

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

Confirme os três antes de criar o retransmissor. Quando 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 encaminhamento

{% stepper %}
{% step %}

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

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

{% step %}

### Abra o bloco Encaminhamento de dados

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

{% step %}

### Abra a lista de protocolos

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

{% step %}

### Configurar o 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, geralmente `443`

Este protocolo não usa login nem senha. Deixe ambos os campos 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**. Deixe o ID externo em branco, pois este protocolo não o usa.
{% endstep %}
{% endstepper %}

## Gerenciar encaminhamento

Para alterar ou interromper o encaminhamento para o SimpliRoute:

* Desative o botão de alternância no **Encaminhamento de dados** bloco para interromper o encaminhamento para um dispositivo e manter a configuração para os demais.
* 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 aparecerem no SimpliRoute, verifique o seguinte na ordem abaixo:

1. O retransmissor está ativado e seu alternador está ligado para o dispositivo.
2. O perfil da conta tem um número 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á cadastrado no SimpliRoute com o número de registro abreviado, com espaços e hífens removidos e apenas os seis primeiros caracteres mantidos.
5. O endereço e a porta estão corretos.
6. O dispositivo informa 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 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/simpliroute.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.