# Veículos — cadastrar o veículo e o rastreador

> Como cadastrar veículo e rastreador no Nativ, ler o IMEI e o chip pelo celular, editar, ajustar hodômetro e horas de motor e ler a ficha do veículo.

A tela **Gerenciamento de Veículos** (`Menu › Veículos`) lista a frota. No painel, **um veículo é um rastreador**: o cadastro junta os dados do carro e os do aparelho instalado nele.

## A lista de veículos

Cada linha mostra:

- **Placa**, **Nome** e modelo;
- **Grupo** e **Endereço** da última posição;
- **IMEI / ID** e **Telefone do chip**;
- **Ativação / Validade** — com "(vencido)" quando a validade passou;
- **Status**: Online, Offline, Em movimento, Parado ou Bloqueado;
- **Hodômetro** em km;
- **Sensores**: ignição (ON/OFF), movimento (MOV/STOP) e satélites;
- **Última Atualização**.

Para achar um veículo:

- busque por placa, nome, IMEI, telefone, modelo, contato ou grupo;
- filtre por **status**, **categoria** e **grupo** (inclusive **Sem grupo**).

> **Dica:** o veículo que fica 15 minutos sem comunicar aparece como **Offline**.

### O menu de cada linha

O botão de ações da linha tem:

- **Editar veículo**;
- **Ver detalhes** — abre a [ficha do veículo](#a-ficha-do-veiculo);
- **Ver no mapa** — veja [Mapa em tempo real](mapa-em-tempo-real.md);
- **Enviar comando** — veja [Comandos e bloqueio](comandos-e-bloqueio.md);
- **Compartilhar localização** — veja [Compartilhar o veículo](compartilhar-veiculo.md);
- **Remover veículo**.

> **Atenção:** **Novo Veículo**, **Editar veículo** e **Remover veículo** não aparecem para as funções **Somente Leitura** e **Leit. Dispositivos**. **Enviar comando** só aparece para quem tem a tela **Comandos** liberada. Veja [Usuários e permissões](usuarios-e-permissoes.md).

### Exportar a lista

1. Marque as linhas (ou **Selecionar todos**).
2. Clique em **Exportar XLSX** ou **Exportar PDF**.

Sem nenhuma linha marcada, os botões ficam desligados.

## Cadastrar veículo e rastreador

> **Dica:** antes de cadastrar, programe o rastreador com o servidor e a porta do protocolo dele. Veja [Rastreadores e portas](rastreadores-e-portas.md).

1. Abra `Menu › Veículos` e clique em **Novo Veículo**.
2. Em **Identificação**, preencha os dois campos obrigatórios:
   - **Nome** — como a frota chama o veículo (ex.: Caminhão 12);
   - **IMEI / identificador** — o número único do rastreador.
3. Informe a **Placa**, se houver.
4. Preencha o resto, se quiser (veja a tabela abaixo).
5. Clique em **Criar veículo**.

| Bloco | Campos |
|---|---|
| **Detalhes** | **Categoria** (Carro, Caminhonete, Moto, Caminhão, Ônibus, Trator e outras), **Grupo**, **Modelo**, **Ano**, **Cor**, **Limite de velocidade (km/h)**, **Categoria de consumo**, **Calendário** |
| **Chip e contato** | **Telefone do chip** (só números, com DDI — usado nos comandos por SMS) e **Contato / ICCID** (o ICCID do chip ou o nome do responsável) |
| **Contrato e bloqueio** | **Data de ativação**, **Válido até** e **Veículo desativado** |
| **Atributos adicionais** | pares de nome e valor, para dados que não têm campo próprio |

- **Limite de velocidade** vazio = sem limite neste veículo.
- **Categoria de consumo** só aparece quando a central já cadastrou categorias. Ela define a faixa de km/L dos [alertas de consumo](abastecimento-e-combustivel.md#alertas-de-consumo).
- **Grupo** organiza a frota — veja [Grupos e organização](grupos-e-organizacao.md).

> **Atenção:** **Data de ativação** e **Válido até** só podem ser alterados pelo **Administrador**. A chave **Veículo desativado** aparece só para **Administrador** e **Gerente** — com ela ligada, o painel passa a ignorar os dados desse rastreador.

<a id="ler-pelo-celular"></a>
## Ler o IMEI e o chip com o celular

No cadastro de um veículo novo, o painel lê a etiqueta do rastreador e o chip pela câmera do celular e preenche os campos sozinho.

1. Em **Novo Veículo**, clique em **Ler IMEI e chip com o celular**. Aparece um QR.
2. Aponte a câmera do celular para o QR. Abre a tela de leitura no celular.
3. Passo **1. Dispositivo**: toque em **Fotografar IMEI do dispositivo** e fotografe a linha de números abaixo do código de barras da etiqueta.
4. Passo **2. Chip**: toque em **Fotografar ICCID do chip** e fotografe a numeração do chip.
5. No computador, os campos **IMEI / identificador** e **Contato / ICCID** já estão preenchidos. Confira e clique em **Criar veículo**.

Outras formas de leitura no celular:

- **Digitar manualmente** — o IMEI tem 15 dígitos; o ICCID, 19 ou 20;
- **Leitor QR ao vivo** — lê um QR com a câmera aberta;
- **Selecionar ou tirar foto** — envia uma foto que já está no celular.

> **Dica:** centralize só o número na foto. Não tente pegar a etiqueta ou o chip inteiro.

> **Atenção:** o QR vale por 2 minutos. Passou do tempo, clique em **Gerar novo QR**. A leitura pelo celular só existe no cadastro novo, não na edição.

## Editar um veículo

1. Na lista, abra o menu da linha e clique em **Editar veículo**.
2. Altere o que precisar.
3. Clique em **Salvar alterações**.

O mesmo formulário abre pelo mapa. Veja [Mapa em tempo real](mapa-em-tempo-real.md).

## Hodômetro e horas de motor

Na edição, o bloco **Hodômetro e horas de motor** traz:

- **Hodômetro (km)** — a quilometragem que o painel conta para o veículo;
- **Horas de motor (h)** — o horímetro.

Para acertar com o painel do veículo:

1. Abra **Editar veículo**.
2. Digite o valor certo em **Hodômetro (km)** ou **Horas de motor (h)**.
3. Clique em **Salvar alterações**.

Só o campo que você alterou é gravado.

> **Atenção:** o ajuste só aparece depois que o rastreador enviou pelo menos uma posição. Sem posição gravada, o bloco avisa e não deixa ajustar.

## Remover um veículo

1. No menu da linha, clique em **Remover veículo**.
2. Confira o nome e o IMEI na janela e clique em **Remover**.

> **Atenção:** remover apaga junto o histórico do rastreador, como posições e eventos. Não dá para desfazer. Para só parar de receber os dados, use **Veículo desativado**.

## A ficha do veículo

**Ver detalhes** abre a ficha, que se atualiza sozinha. No topo: nome, status, placa, modelo e os botões **Ver no Mapa** e **Replay**.

| Parte | O que mostra |
|---|---|
| **Última comunicação** e **GPS** | quando o rastreador falou com o painel e a hora da posição |
| **Velocidade** | a velocidade agora, o limite e o aviso **EXCEDIDO** |
| **Distância Total** | o hodômetro, em km |
| **Sensores** | movendo ou parado, ignição, bateria e satélites |
| **Localização** | o endereço, as coordenadas, a altitude e a precisão. Dá para copiar e abrir num mapa externo |
| **Informações do Veículo** | categoria, modelo, ano, cor, IMEI, placa, chip e contato |
| **Ações Rápidas** | **Replay**, **Vídeo**, **Street View**, **Ligar**, **Enviar Comando** e **Ver Eventos** |
| **Dados do Servidor** | protocolo, horários, curso, precisão, altitude e dados da rede celular |
| **Atributos do Rastreador** | tudo o que o rastreador mandou na última posição (clique para abrir) |
| **Eventos Recentes (7 dias)** | os últimos eventos, como **Ativo** ou **Resolvido** |
| **Comandos Enviados** | os últimos comandos e a situação: Enviado, Entregue, Falhou ou Pendente |

- **Vídeo** abre a VideoTelemetria.
- **Ligar** só aparece com o campo **Contato / ICCID** preenchido, e disca o que estiver nele.
- **Enviar Comando** só aparece para quem tem a tela **Comandos** liberada.
- A ficha não tem botão de editar: volte à lista e use **Editar veículo**.

Para rever o caminho do dia, veja [Histórico e replay](historico-e-replay.md).