# Nativ — Guia (versão 0.2.0)

Como usar o Nativ, a plataforma de rastreamento e telemetria: entrar no painel e no app, acompanhar a frota no mapa, histórico, cercas, alertas, comandos de bloqueio, motoristas, manutenção, combustível e relatórios.

---

# Guia do Nativ

Fonte: https://docs.nativ.tec.br/guia/

O **Nativ** é a plataforma de rastreamento e telemetria da sua central. São duas formas de usar:

- **Painel**, no navegador: a frota inteira no mapa, histórico, cercas, alertas, comandos, motoristas, manutenção, combustível e relatórios.
- **App**, no celular: os veículos na palma da mão, com alerta no celular e bloqueio à distância.

O painel e o app mostram o **logo, as cores e o nome da sua central**. Os nomes dos botões e menus são os mesmos.

## Por onde começar

### Sou cliente da central

1. [Primeiro acesso](primeiro-acesso.md): crie a senha pelo link que a central mandou.
2. [Instalar o app](instalar-o-app.md): abra o link ou o QR da central no celular.
3. [Mapa em tempo real](mapa-em-tempo-real.md): onde está cada veículo, agora.
4. [Notificações e alertas](notificacoes-e-alertas.md): escolha o que avisar e por onde.

### Trabalho na central

1. [Conhecer o painel](conhecer-o-painel.md): o Dashboard e cada item do menu.
2. [Rastreadores e portas](rastreadores-e-portas.md): o servidor e a porta de cada protocolo.
3. [Veículos](veiculos.md): cadastre o veículo e o rastreador.
4. [Usuários e permissões](usuarios-e-permissoes.md): crie o acesso do cliente e escolha os veículos dele.
5. [Comandos e bloqueio](comandos-e-bloqueio.md): bloquear e desbloquear com segurança.

## O que você encontra aqui

| Seção | Páginas |
|---|---|
| **Começando** | [primeiro acesso](primeiro-acesso.md) · [conhecer o painel](conhecer-o-painel.md) |
| **Monitorar** | [mapa](mapa-em-tempo-real.md) · [histórico e replay](historico-e-replay.md) · [cercas](cercas-virtuais.md) · [compartilhar](compartilhar-veiculo.md) |
| **Alertas e comandos** | [notificações](notificacoes-e-alertas.md) · [comandos e bloqueio](comandos-e-bloqueio.md) |
| **Frota** | [veículos](veiculos.md) · [motoristas](motoristas.md) · [manutenção](manutencao.md) · [combustível](abastecimento-e-combustivel.md) · [rastreadores e portas](rastreadores-e-portas.md) |
| **Relatórios** | [relatórios e estatísticas](relatorios.md) |
| **No celular** | [instalar o app](instalar-o-app.md) · [usar o app](usar-o-app.md) |
| **Gestão da central** | [usuários](usuarios-e-permissoes.md) · [grupos](grupos-e-organizacao.md) · [configurações](configuracoes.md) |
| **Referência** | [perguntas frequentes](perguntas-frequentes.md) · [glossário](glossario.md) · [novidades](novidades.md) |

> **Dica:** use a busca no topo. Ela procura em todas as páginas, sem precisar de acento.

## Para quem usa IA

O guia também sai em formatos que assistentes de IA leem bem:

- cada página tem uma versão em Markdown;
- o guia inteiro está em [llms-full.txt](https://docs.nativ.tec.br/guia/llms-full.txt);
- os trechos de cada seção, prontos para busca semântica, estão em [indice.json](https://docs.nativ.tec.br/guia/indice.json).

---

# Primeiro acesso ao painel do Nativ — entrar, criar a senha e sair

Fonte: https://docs.nativ.tec.br/guia/primeiro-acesso/

## O endereço do painel

Cada central de rastreamento tem o **próprio endereço**. É por ele que o painel sabe de qual central você é e mostra o logo, as cores e o nome dela.

- Use sempre o endereço que a sua central passou.
- Salve nos favoritos do navegador e do celular.

## O link de primeiro acesso

A conta é criada pela central (veja [Usuários e permissões](usuarios-e-permissoes.md#criar-um-usuario)). Você recebe um link para criar a sua senha de duas formas:

- **por e-mail**, com o assunto **"Defina sua senha de acesso"** e o botão **Definir senha de acesso**;
- **por mensagem**, quando a central copia o link e manda direto para você.

O e-mail diz até quando o link vale. O prazo padrão é de **3 dias**.

Não achou o e-mail? Confira o spam e a aba Promoções.

## Criar a senha

1. Abra o link. A tela **Primeiro acesso** aparece com o nome da sua central.
2. Em **Nova senha**, digite a senha. Mínimo de **6 caracteres**.
3. Repita em **Confirmar senha**.
4. Clique em **Definir senha**.

O que acontece depois:

- **No computador:** você já entra no painel.
- **No celular:** a tela **Acesso salvo com sucesso** oferece **Baixar pela App Store** (ou **Google Play**) ou **Continuar pela web**.

> **Atenção:** o link funciona **uma vez só**. Depois de criar a senha, ele para de funcionar. Se aparecer **Link inválido ou expirado** ou **Este link não pode mais ser usado**, peça um novo link à sua central.

## Entrar no painel

1. Abra o endereço da sua central.
2. Digite o **Email** e a **Senha**.
3. Deixe marcado **Manter-me conectado** para o painel lembrar o seu acesso neste aparelho.
4. Clique em **ENTRAR**.

Uma tela de carregamento aparece por alguns segundos e o painel abre no [Dashboard](conhecer-o-painel.md#o-dashboard).

### Mensagens de erro na entrada

| Mensagem | O que fazer |
|---|---|
| **Credenciais inválidas** | confira o e-mail e a senha; se esqueceu, veja abaixo |
| **Sua conta está desabilitada. Entre em contato com o suporte.** | a central bloqueou a conta; fale com ela |
| **Sua conta expirou. Entre em contato com o suporte.** | a conta tinha data de validade; peça à central para renovar |

> **Dica:** o app no celular usa o mesmo e-mail e a mesma senha. Veja [Instalar o app](instalar-o-app.md).

## Esqueci a senha

1. Na tela de entrada, clique em **Esqueceu sua senha?**.
2. Digite o seu **Email** e clique em **Enviar instruções**.
3. A tela confirma: **"Se o email existir na base, você receberá as instruções de recuperação em instantes."**
4. Abra o e-mail **"Redefinição de senha"** e clique em **Redefinir senha**.
5. Digite a **Nova senha** (mínimo de 6 caracteres), repita em **Confirmar senha** e clique em **Salvar nova senha**.
6. O painel volta para a entrada com o seu e-mail já preenchido. Entre com a senha nova.

> **Atenção:** o link de redefinição vale por **2 horas**. O próprio e-mail mostra o horário limite. Venceu? Peça de novo em **Esqueceu sua senha?**.

Não chegou o e-mail? Confira o spam. Se ainda assim não chegar, a central pode gerar um link novo para você em **Usuários** (veja [Usuários e permissões](usuarios-e-permissoes.md#mandar-um-novo-acesso)).

## Sair do painel

1. Clique na sua foto ou nas suas iniciais, no canto superior direito.
2. Clique em **Sair**.

Ao sair, o painel apaga o acesso salvo neste aparelho. Na próxima vez, entre de novo com e-mail e senha.

> **Dica:** em computador compartilhado, sempre use **Sair** ao terminar.

## Quando o painel fica indisponível

Se aparecer a tela **Plataforma indisponível**, o acesso da sua central está suspenso no momento. A tela mostra a mensagem da central, a previsão de retorno (quando houver) e o botão **Falar com suporte**.

---

# Conhecer o painel do Nativ — Dashboard, menu lateral e topo da tela

Fonte: https://docs.nativ.tec.br/guia/conhecer-o-painel/

## O Dashboard

**Menu › Dashboard** é a tela que abre depois da entrada. Ela resume a frota que a sua conta enxerga e se atualiza sozinha.

Os quadros que aparecem:

| Quadro | O que mostra |
|---|---|
| **Estatísticas Principais** | **Total de Veículos**, **Veículos Online**, **Alertas Ativos** e **Clientes** |
| **Estatísticas Operacionais** | **Em Movimento**, **Parados**, **Bloqueados** e **Eventos Hoje** |
| **Gráfico de Status** | gráfico de pizza com o status dos veículos |
| **Eventos Recentes** | os 10 últimos eventos dos últimos 30 dias |
| **Comandos Recentes** | os últimos comandos enviados aos veículos |
| **Resumo de Manutenções** | manutenções agendadas, atrasadas e em andamento |
| **KPIs da Frota** | utilização, velocidade, distância e alertas |
| **KPIs de Combustível** | consumo, ranking de motoristas e gastos por combustível |
| **KPIs Personalizados** | indicadores criados em [Atributos Computados](configuracoes.md#atributos-computados) |

### Escolher os quadros

1. Clique no botão **⋮**, no canto superior direito do Dashboard.
2. No menu **Personalizar Dashboard**, ligue ou desligue cada quadro.
3. Para voltar ao original, clique em **Restaurar Padrão**.

A escolha fica guardada neste navegador.

### Receber o resumo por e-mail

1. Clique em **⋮** e depois em **Resumo por Email**.
2. Ligue **Receber resumo no meu email**.
3. Escolha a **Frequência**: **Todo final do dia**, **Todo final da semana**, **A cada quinzena** ou **Todo final do mês**.
4. Escolha o **Período do resumo** e a **Hora do envio**. No semanal, escolha também o **Dia do envio semanal**.
5. Para testar, clique em **Enviar agora**.

- O resumo vai só para o e-mail da sua conta.
- Ligar para você não liga para os outros gestores.

> **Atenção:** **Resumo por Email** só aparece para **Administrador** e **Gerente**.

## O menu lateral

No computador, o menu fica recolhido à esquerda, só com os ícones. Passe o mouse por cima para ver os nomes. No celular, abra pelo botão **☰** no canto superior esquerdo.

Os itens aparecem conforme o seu papel. Veja quem vê o quê em [Usuários e permissões](usuarios-e-permissoes.md#o-que-cada-papel-ve-no-menu).

### Principal

| Item | Para quê |
|---|---|
| **Dashboard** | o resumo da frota (acima) |
| **Mapa** | onde cada veículo está agora — [Mapa em tempo real](mapa-em-tempo-real.md) |
| **Simulador de rota** | planejar o percurso a partir da posição atual do veículo e comparar com o que ele está fazendo |
| **Veículos** | cadastro dos veículos e rastreadores — [Veículos](veiculos.md) |
| **Motoristas** | cadastro dos motoristas — [Motoristas](motoristas.md) |

### Monitoramento

| Item | Para quê |
|---|---|
| **Histórico** | o trajeto completo de um período — [Histórico e replay](historico-e-replay.md) |
| **Replay** | rever o trajeto andando no mapa — [Histórico e replay](historico-e-replay.md) |
| **Eventos** | os eventos e alertas dos veículos — [Notificações e alertas](notificacoes-e-alertas.md) |
| **Relatórios** | relatórios de percurso, viagens, paradas e outros — [Relatórios](relatorios.md) |
| **Estatísticas** | análise de uso e desempenho da frota — [Relatórios](relatorios.md) |

### Controle

| Item | Para quê |
|---|---|
| **Comandos** | enviar comandos ao rastreador, como o bloqueio — [Comandos e bloqueio](comandos-e-bloqueio.md) |
| **Comandos Salvos** | comandos prontos para reusar — [Comandos e bloqueio](comandos-e-bloqueio.md) |
| **Cercas Geográficas** | áreas no mapa que avisam entrada e saída — [Cercas virtuais](cercas-virtuais.md) |
| **Notificações** | que alertas você recebe e por onde — [Notificações e alertas](notificacoes-e-alertas.md) |
| **Manutenção** | revisões e trocas por km ou data — [Manutenção](manutencao.md) |

### Abastecimento

Abre um submenu com **Abastecimentos**, **Alertas de Consumo**, **Timeline de KM**, **Tipos de Combustível** e **Categorias de Veículo**. Veja [Abastecimento e combustível](abastecimento-e-combustivel.md) e [Categorias de veículo](grupos-e-organizacao.md#categorias-de-veiculo).

### Recursos Avançados

| Item | Para quê |
|---|---|
| **Rotas** | rotas planejadas para os veículos, vistas no mapa |
| **Grupos** | separar a frota em grupos e subgrupos — [Grupos e organização](grupos-e-organizacao.md#grupos-de-veiculos) |
| **Calendários** | horários de operação por dia da semana — [Configurações](configuracoes.md#calendarios) |
| **Atributos Computados** | fórmulas e KPIs próprios — [Configurações](configuracoes.md#atributos-computados) |
| **Cockpit do Veículo** | painel de um veículo: dados de hoje, luzes, velocidade dos últimos 30 minutos e ocorrências |

### VideoTelemetria

Abre um submenu com **VideoTelemetria**, **Alertas de Vídeo** e **Câmeras**. As telas ainda mostram dados de exemplo. Para a videotelemetria da sua frota, fale com a central.

### Gerenciamento

| Item | Para quê |
|---|---|
| **Parceiros** | clientes e fornecedores — [Grupos e organização](grupos-e-organizacao.md#parceiros) |
| **Usuários** | contas de acesso e veículos de cada uma — [Usuários e permissões](usuarios-e-permissoes.md) |
| **Configurações** | o seu perfil e, para o administrador, o servidor — [Configurações](configuracoes.md) |
| **Config. Servidor** | regras gerais e envio de e-mail — [Configurações](configuracoes.md#config-servidor) |
| **Config. SMS** | o canal de SMS dos comandos — [Configurações](configuracoes.md#config-sms) |
| **Controle de Acesso** | o que cada pessoa vê no menu — [Usuários e permissões](usuarios-e-permissoes.md#controle-de-acesso) |
| **Logs de Auditoria** | quem fez o quê no painel — [Usuários e permissões](usuarios-e-permissoes.md#logs-de-auditoria) |

> **Dica:** não há busca geral no topo. Cada lista (veículos, usuários, grupos e outras) tem o próprio campo de busca.

## O topo da tela

Da esquerda para a direita:

- **o nome da tela** em que você está;
- **Online** ou **Offline**: a conexão do painel com o servidor;
- **sol ou lua**: troca entre o tema claro e o escuro. Na primeira vez, o painel segue o tema do seu aparelho;
- **o sino**: abre as **Notificações**;
- **a sua foto ou as suas iniciais**: abre o menu do perfil.

### As notificações do sino

- O número no sino mostra quantas você ainda não leu (acima de 9, aparece **9+**).
- Clique numa notificação para abrir o veículo no mapa.
- **Marcar todas como lidas** e **Limpar tudo** ficam no topo da lista.
- O botão de som liga ou desliga o aviso sonoro.
- A engrenagem leva para **Notificações**, onde você escolhe os alertas (veja [Notificações e alertas](notificacoes-e-alertas.md)).

### O menu do perfil

Mostra o seu nome, o e-mail e o seu papel (**Administrador**, **Gerente**, **Usuário**, **Somente Leitura** ou **Leit. Dispositivos**).

- **Perfil** e **Configurações** abrem a tela de [Configurações](configuracoes.md).
- **Sair** encerra o acesso (veja [Primeiro acesso](primeiro-acesso.md#sair-do-painel)).

> **Atenção:** **Usuário**, **Somente Leitura** e **Leit. Dispositivos** não têm acesso à tela de Configurações. Ao clicar em **Perfil**, o painel mostra **Acesso Negado**.

## Outros avisos na tela

- **Botão do WhatsApp**: quando a central cadastrou um número, um botão verde no canto da tela abre uma conversa de suporte com ela. A mensagem já vai com o seu nome, e-mail e telefone.
- **Ativar Notificações** e **Ativar Localização**: o painel pede licença ao navegador para avisar alertas e mostrar a sua distância até os veículos.
- **Acesso Negado**: você abriu uma tela que o seu papel não alcança. Use **Voltar** ou **Ir para o Dashboard**.

---

# Mapa em tempo real — acompanhar a frota ao vivo

Fonte: https://docs.nativ.tec.br/guia/mapa-em-tempo-real/

**Menu › Mapa** mostra todos os veículos da sua conta no mapa, com a posição atualizada sozinha.

Ao abrir, o mapa enquadra todos os veículos de uma vez.

## As cores do status

| Cor | Status | Quando aparece |
|---|---|---|
| Azul (pulsando) | **Em movimento** | o rastreador indica movimento, ou a velocidade passa de 2 km/h |
| Verde | **Parado** | comunicou nos últimos 15 minutos e não está andando |
| Cinza | **Offline** | está há mais de 15 minutos sem comunicar |

- No painel do veículo, o verde aparece como **Parado** (ignição ligada) ou **Online** (ignição desligada).
- Um círculo vermelho no canto do ícone indica veículo **Bloqueado**.
- Quando o veículo anda, a velocidade aparece embaixo do ícone.

> **Dica:** a legenda das cores fica na barra de baixo do mapa, junto com o total de veículos.

## A barra de baixo: Real-time ou Polling

- **Real-time**: as posições chegam na hora.
- **Polling**: a conexão ao vivo caiu e o painel busca as posições de tempos em tempos. Não é preciso fazer nada.

## A lista de veículos

A lista fica à esquerda. Para fechar, clique na seta do topo dela. Para abrir de novo, clique na aba **VEÍCULOS**, na borda esquerda do mapa.

Cada linha mostra:

- nome, grupo e placa;
- o status (**Em movimento**, **Parado** ou **Offline**);
- a ignição: raio amarelo é **Ignição ligada**, raio cinza é **Ignição desligada**;
- a bateria, quando o rastreador envia esse dado;
- há quanto tempo o veículo comunicou;
- o endereço da última posição;
- a velocidade atual, quando está andando.

A cor da velocidade avisa:

- **verde**: andando;
- **amarelo**: 80 km/h ou mais;
- **vermelho**: acima do limite de velocidade do cadastro do veículo.

A lista vem em ordem: primeiro os em movimento, depois os parados, por último os offline.

> **Dica:** o botão de engrenagem no topo da lista muda o tamanho dela: **P**, **M** ou **G**. A escolha fica salva neste navegador.

## Buscar e filtrar

1. No campo **Buscar veículo, placa ou grupo...**, digite parte do nome, da placa, do identificador do rastreador ou do grupo.
2. Em **Grupo**, escolha um grupo, **Sem grupo** ou **Todos os grupos**.
3. Nos botões de status, clique em **Todos**, **Movendo**, **Parado** ou **Offline**. Cada botão mostra quantos veículos estão naquele status.

O número ao lado de **Veículos** mostra quantos aparecem com os filtros, sobre o total (por exemplo, 12/40).

## O painel do veículo

Clique no veículo, na lista ou no mapa. O mapa aproxima e o painel abre à direita (no celular, ele sobe da parte de baixo).

O que o painel mostra:

- **Resumo**: **Velocidade**, o **Limite** cadastrado (fica vermelho quando é ultrapassado) e o **Odômetro**;
- se está **Movendo** ou **Parado**, a ignição **Ligada** ou **Desligada** e quantos satélites o GPS vê;
- **Telemetria**: as leituras de sensores que o rastreador envia, como a bateria;
- **Localização atual**: o endereço e as coordenadas, com os botões para copiar o endereço e abrir o ponto num mapa em outra aba;
- **Atividade**: os horários da última posição (**Dispositivo**, **Servidor** e **GPS**) e a distância dos **Últimos 5 min**;
- modelo, ano e cor, se estiverem no cadastro.

Os botões do painel:

| Botão | O que faz |
|---|---|
| **Rastro** | desenha o caminho das últimas horas (veja abaixo) |
| **Telemetria** | abre o Cockpit do Veículo |
| **Replay** | abre o [replay](historico-e-replay.md#replay-reproduzir-o-trajeto) com o veículo já escolhido |
| **Seguir** | mantém o mapa no veículo |
| **Street** | mostra a vista da rua no ponto do veículo |
| **Vídeo** | abre as câmeras do veículo |
| **Editar** | edita o cadastro do veículo |
| **Cercas** | liga ou desliga [cercas](cercas-virtuais.md) neste veículo |
| **Comandos** | envia um [comando](comandos-e-bloqueio.md) ao rastreador |
| **Compartilhar** | gera um [link temporário](compartilhar-veiculo.md) da localização |
| **Contato** | liga para o telefone do cadastro do veículo |
| **Mais Detalhes** | abre a página completa do veículo |

> **Atenção:** os botões dependem do seu perfil. **Comandos** só aparece para o perfil Administrador. **Telemetria** só aparece para quem tem acesso ao Cockpit do Veículo. Veja [usuários e permissões](usuarios-e-permissoes.md).

## Seguir o veículo

1. Clique no veículo.
2. Com o painel aberto, o mapa se move junto com o veículo a cada nova posição.
3. Para parar de seguir, feche o painel no **X**.

## Rastro das últimas horas

1. No painel do veículo, clique em **Rastro**.
2. Escolha o período: **4 h**, **8 h**, **1 dia** ou **5 dias**. O padrão é 8 horas.
3. O caminho aparece no mapa colorido pela velocidade: até 5, de 5 a 30, de 30 a 60, de 60 a 90 e mais de 90 km/h.

O cartão do rastro mostra:

- **Percorrido**, **Em movimento**, **Vel. máxima** e **Paradas**;
- a lista de **Paradas (3 min ou mais)**, com endereço, horário e duração. Clique numa parada para aproximar o mapa nela.

Para apagar, clique em **Ocultar rastro**.

> **Dica:** se aparecer **Nenhum deslocamento registrado neste período**, clique em **Ver 5 dias**. Para um período exato, com data e hora, use o [replay](historico-e-replay.md#replay-reproduzir-o-trajeto).

## Os botões do topo do mapa

- **Estilo do mapa**: troca o fundo. Há mapa de ruas, satélite, híbrido (satélite com os nomes das ruas), escuro e claro. A escolha fica salva neste navegador.
- **Cercas**: mostra ou esconde as cercas no mapa.
- **Excessos**: mostra ou esconde os pontos de excesso de velocidade.
- **Placas**: mostra ou esconde a placa embaixo de cada veículo.

Com o mapa afastado, veículos próximos viram um círculo com o número deles. Clique no círculo para aproximar.

Os veículos que se moveram há pouco deixam uma linha tracejada dos últimos minutos.

---

# Histórico e replay — rever o trajeto de um veículo

Fonte: https://docs.nativ.tec.br/guia/historico-e-replay/

Duas telas mostram o passado de um veículo:

- **Monitoramento › Histórico**: a lista de posições de um período, com números do trajeto.
- **Monitoramento › Replay**: o trajeto no mapa, reproduzido como um vídeo, com paradas, excessos e exportação.

> **Dica:** no [mapa em tempo real](mapa-em-tempo-real.md), o botão **Replay** do painel do veículo já abre esta tela com o veículo escolhido.

## Histórico: a lista de posições

1. Abra **Monitoramento › Histórico**.
2. Em **Veículo**, escolha o veículo.
3. Informe a **Data Inicial** e a **Data Final**.
4. Clique em **Buscar Histórico**.

Aparecem os números do período:

- **Distância Total**;
- **Velocidade Média** e **Velocidade Máxima**;
- **Duração**, da primeira à última posição;
- **Paradas**: quantos registros do período têm velocidade zero.

Embaixo, **Pontos do Trajeto** lista cada posição com horário, velocidade, endereço, ignição e número de satélites.

> **Atenção:** o Histórico filtra só por data, sem hora. Para um intervalo exato, ou para ver o caminho no mapa, use o Replay.

## Replay: reproduzir o trajeto

1. Abra **Monitoramento › Replay**.
2. Em **Selecione o veículo**, escolha o veículo.
3. Informe a data e a hora de início e a data e a hora de fim. O padrão é o dia de hoje, de 00:00 a 23:59.
4. Clique em **Buscar**.

O mapa mostra:

- o ponto **S** (saída) em verde e o ponto **F** (fim) em vermelho;
- o caminho já percorrido, colorido pela velocidade;
- o caminho que falta, em cinza tracejado;
- as paradas, em círculos numerados;
- os excessos de velocidade, em círculos com **!**.

Quando aparece **ajustado às vias**, o traçado foi encaixado nas ruas.

> **Atenção:** a data e a hora de fim precisam ser depois do início. Sem posições no período, aparece **Nenhuma posição encontrada para o período selecionado.**

## Os controles da reprodução

Na barra de baixo:

- o botão do meio inicia e pausa;
- as setas pulam 10 posições para trás ou para frente;
- o quadrado volta ao começo;
- a régua leva a qualquer ponto do trajeto: arraste ou clique.

Na régua, as faixas laranja são paradas e as vermelhas são excessos.

A velocidade da reprodução vai de **0.1x** a **10x**. Durante a reprodução, a barra mostra a velocidade, o horário, a ignição e avisos como **PARADO há** e **EXCESSO**.

## O resumo da rota

O painel **Resumo da Rota**, à esquerda, mostra:

- **quilômetros percorridos**;
- **Duração total**, **Em movimento** e **Tempo parado**;
- **Nº paradas**, **Vel. máxima** e **Vel. média**;
- a lista de **Paradas detectadas** e de **Trechos de excesso**. Clique num item para ir até aquele ponto.

Como o replay conta:

- **parada**: 90 segundos ou mais a até 2 km/h;
- **excesso**: velocidade acima do campo **Limite**, no topo da tela.

O **Limite** vem do limite de velocidade do [cadastro do veículo](veiculos.md). Você pode mudar o número só para esta consulta: clique em **Buscar** de novo para recalcular.

> **Atenção:** sem limite no cadastro, o resumo mostra **Limite de Velocidade — Não configurado no cadastro do veículo** e não aponta excessos.

## Exportar o trajeto

No topo do **Resumo da Rota**, escolha o formato:

- **CSV**: planilha com cada posição (data e hora, coordenadas, velocidade, ignição, odômetro, satélites e bateria);
- **PDF**: relatório com o mapa da rota, o resumo, as paradas e os excessos;
- **TXT**: o mesmo resumo em texto.

Antes de baixar, o painel pergunta **Vincular motorista?**. Escolha o motorista para ele constar no PDF e no TXT, ou deixe **Sem motorista**, e clique em **Continuar**.

> **Dica:** para relatórios de vários veículos ou de um período longo, veja [relatórios](relatorios.md).

---

# Cercas geográficas — criar áreas e receber alerta de entrada e saída

Fonte: https://docs.nativ.tec.br/guia/cercas-virtuais/

Uma cerca é uma área desenhada no mapa. Com ela, o painel avisa quando um veículo entra ou sai daquele lugar: a garagem, um cliente, uma cidade.

Tudo fica em **Controle › Cercas Geográficas**.

> **Atenção:** o perfil Somente Leitura não vê esta tela. Veja [usuários e permissões](usuarios-e-permissoes.md).

## Criar uma cerca

1. Abra **Controle › Cercas Geográficas** e clique em **Nova Cerca**.
2. Em **Nome**, dê um nome único. Exemplo: "Garagem central".
3. Em **Descrição**, anote o que quiser (opcional).
4. Em **Tipo de Cerca**, escolha **Polígono**, **Círculo** ou **Retângulo**.
5. Escolha a **Cor da Cerca**.
6. Desenhe a área no mapa (veja abaixo).
7. Em **Veículos vinculados**, escolha os veículos.
8. Quando aparecer **Área pronta para salvar**, clique em **Criar Cerca**.

> **Dica:** use o campo **Buscar local no mapa...** para achar o endereço antes de desenhar.

## Desenhar no mapa

**Polígono**

1. Clique no mapa para marcar cada canto. São pelo menos 3 pontos.
2. Arraste os pontos para ajustar.
3. Não tem botão de fechar: o polígono já pode ser salvo.

**Círculo**

1. Clique para marcar o centro.
2. Clique de novo para definir o raio. O painel mostra o raio em metros.
3. Arraste o centro para mover, ou a alça de fora para mudar o raio.

**Retângulo**

1. Clique no primeiro canto.
2. Clique no canto oposto.
3. Arraste os cantos para redimensionar.

Errou? Clique em **Limpar desenho** e comece de novo.

> **Atenção:** não há cerca em formato de rota ou corredor. Para acompanhar um trajeto longo, use um polígono que cubra o caminho.

## Vincular aos veículos

A cerca só vale para os veículos vinculados a ela. Em **Veículos vinculados**, escolha:

- **Todos os veículos**;
- **Nenhum veículo**;
- ou marque um por um, em **Ou selecione específicos**.

Também dá para vincular pelo [mapa em tempo real](mapa-em-tempo-real.md):

1. Clique no veículo e, no painel, clique em **Cercas**.
2. A lista mostra cada cerca com **Dentro da área** ou **Fora da área**.
3. Clique em **Vincular** ou **Desvincular**.

## Receber alerta ao entrar ou sair

A cerca sozinha não manda alerta. É preciso uma regra de notificação:

1. Abra **Controle › Notificações**.
2. Crie uma regra do tipo **Entrada em Cerca** e outra do tipo **Saída de Cerca**.
3. Escolha os canais de aviso: na tela, e-mail, SMS ou push no celular.

O passo a passo está em [notificações e alertas](notificacoes-e-alertas.md#criar-uma-regra).

Cada entrada e saída também fica registrada em **Monitoramento › Eventos**, no filtro **Cercas**.

## Ver, editar e remover

A lista à esquerda mostra cada cerca com o tipo, **Ativa** ou **Inativa**, e os **Vínculos** (quantos veículos, sobre o total).

- **Ver**: clique na cerca, na lista ou no mapa. O mapa aproxima nela.
- **Editar**: clique no lápis, ou em **Editar selecionada**. Arraste os pontos e clique em **Atualizar Cerca**.
- **Remover**: clique na lixeira e confirme.

O botão **Cerca ativa**, na edição, marca a cerca como **Ativa** ou **Inativa**.

No [mapa em tempo real](mapa-em-tempo-real.md), o botão **Cercas** do topo mostra ou esconde as cercas.

---

# Compartilhar a localização de um veículo por link temporário

Fonte: https://docs.nativ.tec.br/guia/compartilhar-veiculo/

O link de compartilhamento mostra a localização de **um** veículo, ao vivo, para quem não tem conta no painel. Serve para uma emergência, uma entrega ou um socorro mecânico.

- Quem recebe só vê. Não mexe em nada.
- O link expira sozinho no prazo escolhido.
- Você pode cortar o acesso antes, a qualquer momento.

> **Atenção:** qualquer pessoa com o link vê a localização em tempo real. Mande só para quem precisa e revogue quando não precisar mais.

## Gerar o link

1. Abra **Menu › Mapa** e clique no veículo.
2. No painel do veículo, clique em **Compartilhar**.
3. Em **Duração do novo link**, escolha o prazo: 15 minutos, 30 minutos, 1 hora, 3 horas, 6 horas, 12 horas ou 24 horas. O padrão é 1 hora.
4. Clique em **Gerar Link**.
5. Clique em **Copiar Link** e mande pelo WhatsApp, SMS ou e-mail.

O painel mostra quando o link expira. Para conferir o que a pessoa vai ver, clique em **Abrir em nova aba (testar)**.

> **Dica:** também dá para gerar o link pela tela **Menu › Veículos**: no menu de ações do veículo, clique em **Compartilhar localização**.

## O que quem recebe vê

A pessoa abre o link no navegador, sem senha e sem instalar nada. A tela mostra:

- o veículo no mapa;
- nome, placa e status (**Em Movimento**, **Parado** ou **Offline**);
- **Velocidade**, **Ignição** e **Satélites**;
- o endereço da última posição;
- o tempo que falta para o link expirar;
- o aviso **Modo leitura**.

A posição se atualiza a cada 10 segundos.

Quando o prazo acaba, ou o acesso é revogado, a tela mostra **Link Expirado** e pede um novo link ao responsável pelo veículo.

## Ver os links ativos

- **No painel do veículo**: clique em **Compartilhar**. Em **Links ativos**, cada link mostra quanto tempo falta e a hora em que foi criado.
- **Na tela de veículos**: quando há links ativos, **Menu › Veículos** mostra o quadro **Compartilhamentos Ativos**, com a contagem regressiva de cada um.

## Revogar o acesso

Revogar corta o link na hora: quem tentar abrir vê **Link Expirado**.

**Pelo painel do veículo**

1. No mapa, clique no veículo e em **Compartilhar**.
2. Em **Links ativos**, clique em **Revogar** no link.
3. Para cortar todos os links deste veículo, clique em **Revogar todos**.

**Pela tela de veículos**

1. Abra **Menu › Veículos**.
2. No quadro **Compartilhamentos Ativos**, clique em **Encerrar** no link, ou em **Encerrar todos**.

> **Dica:** precisa de mais tempo? Gere um link novo. O prazo de um link já criado não muda.

---

# Notificações e alertas — escolher o que avisar e por onde

Fonte: https://docs.nativ.tec.br/guia/notificacoes-e-alertas/

O painel avisa quando algo acontece com um veículo: ignição ligada, saída de uma cerca, excesso de velocidade, veículo offline.

- **Controle › Notificações**: você escolhe o que quer receber e por onde.
- **Monitoramento › Eventos**: a lista de tudo o que aconteceu.
- O **sino**, no alto da tela: os alertas que chegaram para você.

> **Atenção:** o perfil Somente Leitura não vê **Notificações**, mas vê **Eventos**. Veja [usuários e permissões](usuarios-e-permissoes.md).

## Os tipos de evento

| Tipo | Quando dispara |
|---|---|
| **Dispositivo Online** / **Dispositivo Offline** | o rastreador volta a comunicar ou para de comunicar |
| **Dispositivo Desconhecido** / **Dispositivo Inativo** | o rastreador fica sem situação conhecida ou sem atividade |
| **Dispositivo em Movimento** / **Dispositivo Parado** | o veículo começa a andar ou para |
| **Excesso de Velocidade** | o veículo passa do limite de velocidade do [cadastro do veículo](veiculos.md) |
| **Ignição Ligada** / **Ignição Desligada** | a chave é ligada ou desligada |
| **Entrada em Cerca** / **Saída de Cerca** | o veículo entra ou sai de uma [cerca](cercas-virtuais.md) |
| **Alarme / SOS** | o rastreador envia um alarme, como o botão de pânico |
| **Manutenção** | vence uma [manutenção](manutencao.md) programada |
| **Mudança de Motorista** | troca o [motorista](motoristas.md) identificado no veículo |
| **Resultado de Comando** | o rastreador responde a um [comando](comandos-e-bloqueio.md) |
| **Mensagem de Texto** | o rastreador envia uma mensagem |
| **Mídia Recebida** | chega uma foto ou um vídeo do veículo |

## Os canais

| Canal | Onde o aviso chega |
|---|---|
| **Web** | no painel: no sino e na tela |
| **Email** | no e-mail do seu usuário |
| **SMS** | por mensagem no celular |
| **Push** | no app, no celular. Veja [instalar o app](instalar-o-app.md) |

> **Atenção:** **Email**, **SMS** e **Push** dependem da configuração da central. Se um aviso não chegar por eles, fale com a central.

## Criar uma regra

1. Abra **Controle › Notificações**.
2. Em **Regras de Notificação (Servidor)**, clique em **Nova Regra**.
3. Em **Tipo de Evento**, escolha o evento.
4. Em **Canais de Entrega**, marque um ou mais canais.
5. Deixe **Todos os dispositivos** ligado para valer em todos os seus veículos. Ou desligue e escolha os veículos em **Dispositivos específicos**.
6. Clique em **Criar Regra**.

Para conferir, clique no avião de papel da regra (**Enviar teste**). Chega um aviso de teste nos canais marcados.

> **Dica:** cada tipo de evento tem uma regra só. Para mudar os canais ou os veículos, edite a regra que já existe.

## Ativação rápida

Em **Ativação Rápida por Evento**, cada tipo tem um botão de ligar e desligar.

- **Ligar** cria a regra com o canal **Web**, para todos os veículos.
- Depois, marque os outros canais direto na lista de regras.

> **Atenção:** **desligar** na ativação rápida apaga a regra daquele tipo, com os canais e os veículos escolhidos.

## Editar ou remover uma regra

Na lista **Regras de Notificação (Servidor)**:

- marque ou desmarque **Web**, **Email**, **SMS** e **Push** direto na linha. Cada regra precisa de pelo menos um canal;
- o raio (**Editar regra**) abre a regra para trocar canais e veículos;
- a lixeira (**Remover regra**) apaga a regra.

## Som e aviso do navegador

Em **Configurações do Navegador**:

- **Som de notificação**: toca um som quando chega um alerta;
- **Notificações desktop**: mostra o alerta como notificação do navegador. O navegador pede a sua permissão na primeira vez.

Essas duas escolhas valem só para o navegador onde você fez a mudança.

## O sino: os alertas que chegaram

Clique no sino, no alto da tela, para ver os alertas recebidos.

- **Marcar todas como lidas** zera o contador.
- **Limpar tudo** apaga a lista.
- O ícone de som liga e desliga o som.
- A engrenagem abre **Controle › Notificações**.

## Alerta de um veículo só

No [mapa em tempo real](mapa-em-tempo-real.md), o painel do veículo tem a seção **Notificações**:

1. Clique em **Criar notificação**.
2. Escolha o tipo de evento.
3. Ligue ou desligue o som e clique em **Criar**.

> **Atenção:** os alertas criados no painel do veículo ficam salvos só neste navegador. Para receber por e-mail, SMS ou push, crie a regra em **Controle › Notificações**.

## Eventos: tudo o que aconteceu

**Monitoramento › Eventos** lista os eventos dos seus veículos, do mais novo para o mais antigo. A lista se atualiza sozinha.

Os cartões do topo filtram por grupo: **Velocidade**, **Cercas**, **Alarmes**, **Online**, **Offline**, **Combustível** e **Comandos**. Clique de novo para tirar o filtro.

Para filtrar mais:

1. Busque pelo nome ou pela placa em **Buscar por veículo ou placa...**.
2. Escolha o status: **Ativos** ou **Resolvidos**.
3. Escolha o tipo de evento e o veículo.
4. Escolha o período: das **Últimas 24 horas** aos **Últimos 90 dias**. O padrão é **Últimos 7 dias**.

Em cada evento:

- **Ver no mapa** abre o mapa no veículo e marca o ponto onde o evento aconteceu;
- **Resolver** marca o evento como tratado.

> **Atenção:** **Resolver** vale só para o navegador onde você clicou. Os colegas continuam vendo o evento como **Ativo**.

---

# Comandos e bloqueio — bloquear e desbloquear o veículo à distância

Fonte: https://docs.nativ.tec.br/guia/comandos-e-bloqueio/

Um comando é uma ordem que o painel manda para o rastreador do veículo. O principal é o bloqueio do motor.

> **Atenção:** só o perfil **Administrador** envia comandos. Para os outros perfis, **Controle › Comandos**, **Controle › Comandos Salvos** e o botão **Comandos** do mapa não aparecem. Veja [usuários e permissões](usuarios-e-permissoes.md).

## Os comandos

| Comando | O que faz |
|---|---|
| **Consultar posição** | pede a posição atual ao rastreador |
| **Bloquear veículo** | envia o bloqueio do motor |
| **Desbloquear veículo** | libera o motor |
| **Reiniciar rastreador** | reinicia o aparelho à distância |
| **Comando personalizado** | envia um texto de comando escrito por você |

Cada modelo de rastreador aceita comandos diferentes. O que o aparelho não aceita fica apagado, com o aviso **Não suportado para este veículo nesse canal**.

## Bloquear pelo mapa

1. Abra **Menu › Mapa** e clique no veículo.
2. No painel do veículo, clique em **Comandos**.
3. Clique em **Bloquear veículo** e em **Enviar Comando**.
4. Leia o aviso **Tem certeza?** e clique em **Confirmar Bloqueio**.

> **Atenção:** o painel avisa: "O comando de bloqueio cortará a alimentação do motor. Certifique-se de que o veículo está em local seguro." O painel não confere a velocidade antes de enviar.

> **Dica:** antes de bloquear, olhe no mapa se o veículo está **Parado** e com velocidade zero. Se estiver andando, combine com o motorista ou com as autoridades o momento do bloqueio.

## Bloquear pela tela de comandos

1. Abra **Controle › Comandos**.
2. Em **Veículo**, busque pelo nome, pela placa ou pelo IMEI e escolha o veículo.
3. Em **Comando**, clique em **Bloquear veículo**.
4. Clique em **Enviar Comando**, leia o aviso e clique em **Confirmar Bloqueio**.

## Desbloquear

Siga os mesmos passos e escolha **Desbloquear veículo**. O desbloqueio não pede confirmação.

## Veículo offline

Se o veículo está **Offline**, aparece o aviso **Veículo offline**: o envio pode falhar. O resultado depende do comando, do canal e do modelo do rastreador.

## Enviar por SMS

Por padrão, o comando vai pela internet do rastreador (GPRS). Quando ela não funciona:

1. Escolha o comando.
2. Ligue **Enviar via SMS**.
3. Clique em **Enviar Comando**.

> **Atenção:** o SMS usa a empresa de envio escolhida em **Gerenciamento › Config. SMS**, e o chip do rastreador precisa aceitar SMS.

## Saber se o comando chegou

- **Comando enviado com sucesso!** quer dizer que o painel mandou a ordem.
- Quando o rastreador responde, aparece o evento **Resultado de comando** em **Monitoramento › Eventos**, no filtro **Comandos**.
- Em **Histórico de Comandos**, na tela **Controle › Comandos**, ficam os últimos envios com veículo, horário e situação: **Enviado** ou **Falhou**.

> **Dica:** para ser avisado quando o rastreador responder, crie uma regra **Resultado de Comando** em [notificações e alertas](notificacoes-e-alertas.md#criar-uma-regra).

## Comandos salvos

Comandos salvos são modelos prontos: o tipo, o canal e o texto já ficam guardados.

**Criar um comando salvo**

1. Abra **Controle › Comandos Salvos** e clique em **Novo Comando**.
2. Em **Descrição**, dê um nome. Exemplo: "Bloqueio padrão".
3. Escolha o **Tipo de comando**.
4. Ligue **Enviar via SMS** se o modelo deve sair por SMS.
5. Para **Comando personalizado**, escreva o texto em **Comando (texto)**. Ele sai exatamente como foi digitado.
6. Clique em **Salvar**.

Em **Comandos Salvos** há mais tipos do que na tela de envio, como **Definir Odômetro**, **Armar Alarme**, **Desarmar Alarme** e **Solicitar Foto**.

**Usar um comando salvo**

1. Abra **Controle › Comandos** e escolha o veículo.
2. Em **Comandos salvos**, clique em:
   - **Usar**, para preencher o formulário e revisar antes de enviar;
   - **Enviar**, para mandar na hora.

> **Atenção:** o botão **Enviar** de um comando salvo dispara na hora, **sem** o aviso **Tem certeza?**. Para um bloqueio salvo, prefira **Usar** e depois **Confirmar Bloqueio**.

Para editar ou excluir um modelo, use o lápis ou a lixeira na lista de **Comandos Salvos**.

---

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

Fonte: https://docs.nativ.tec.br/guia/veiculos/

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).

---

# Motoristas — cadastro, CNH e importação

Fonte: https://docs.nativ.tec.br/guia/motoristas/

A tela **Motoristas** (`Menu › Motoristas`) guarda os condutores da frota e as habilitações.

> **Atenção:** por padrão, a tela aparece só para **Administrador** e **Gerente**. A central muda isso em **Controle de Acesso** — veja [Usuários e permissões](usuarios-e-permissoes.md).

## O topo da tela

Quatro números:

- **Total de Motoristas**;
- **Motoristas Ativos**;
- **Suspensos**;
- **CNH a Vencer** — vence nos próximos 30 dias.

Na tabela, a coluna **Validade CNH** marca:

- **Vencida** — a data já passou;
- **A vencer** — faltam 30 dias ou menos.

Para achar alguém: busque por nome, CPF ou número da CNH, e filtre por **Ativo**, **Suspenso** ou **Inativo**.

## Cadastrar um motorista

1. Abra `Menu › Motoristas` e clique em **Novo Motorista**.
2. Preencha o **Nome Completo** — é o único campo obrigatório.
3. Preencha, se tiver:
   - **CPF**;
   - **Número da CNH**;
   - **Categoria CNH** — A, B, C, D, E, AB, AC, AD ou AE;
   - **Validade CNH**;
   - **Telefone** e **Email (opcional)**.
4. Clique em **Cadastrar Motorista**.

> **Atenção:** o painel não aceita dois motoristas com o mesmo CPF. Aparece o aviso "Já existe um motorista cadastrado com o CPF…".

## Editar, suspender ou excluir

1. No menu da linha, clique em **Editar motorista**.
2. Mude os dados ou o **Status**: **Ativo**, **Suspenso** ou **Inativo**.
3. Clique em **Atualizar Motorista**.

O **Status** só aparece na edição: todo motorista nasce **Ativo**.

Para apagar, use **Excluir motorista** no menu da linha e confirme.

## Importar a lista por planilha

1. Clique em **Modelo** e baixe a planilha de exemplo.
2. Preencha uma linha por motorista, com estas colunas:

| Coluna | Observação |
|---|---|
| **Nome** | obrigatório |
| **CPF** | com ou sem pontos |
| **Número CNH** | só números |
| **Categoria CNH** | A, B, C, D, E, AB, AC, AD ou AE. Outro valor vira B |
| **Validade CNH** | no formato AAAA-MM-DD (2028-12-31) |
| **Telefone** e **Email** | |
| **Status** | ativo, suspenso ou inativo. Vazio vira ativo |

3. Clique em **Importar** e escolha o arquivo (.xlsx, .xls ou .csv).
4. Confira a **Pré-visualização da Importação**.
5. Sem erros, clique em **Importar N motorista(s)**.

> **Atenção:** linha sem **Nome** trava a importação inteira: corrija o arquivo e importe de novo. CPF repetido não entra — o aviso no fim diz quantos falharam.

## Exportar

- **Exportar** baixa todos os motoristas da busca atual numa planilha .xlsx.
- Na tabela, marque as linhas e use **Exportar XLSX** ou **Exportar PDF**.

<a id="identificacao"></a>
## Vínculo com o veículo e identificação do motorista

O cadastro de motorista no painel **não tem** campo para escolher o veículo nem para registrar o código do cartão ou chaveiro de identificação.

Quando o rastreador identifica quem está dirigindo, o painel mostra:

- o evento **Motorista alterado**, com o código lido — veja [Notificações e alertas](notificacoes-e-alertas.md);
- as colunas **Motorista** e **Identificação do motorista** no relatório de **Viagens** — veja [Relatórios](relatorios.md#os-tipos-de-relatorio);
- o motorista já escolhido no [registro de abastecimento](abastecimento-e-combustivel.md#registrar-um-abastecimento), quando há vínculo com o veículo.

## Motorista no relatório

Nos [Relatórios](relatorios.md#filtros) e na exportação do [replay](historico-e-replay.md), dá para escolher um motorista para sair no PDF. É só um destaque no documento: não muda o cadastro.

---

# Manutenção — agendar e acompanhar a manutenção da frota

Fonte: https://docs.nativ.tec.br/guia/manutencao/

A tela **Manutenção** (`Controle › Manutenção`) agenda e registra a manutenção de cada veículo.

> **Atenção:** por padrão, a tela aparece só para **Administrador** e **Gerente**. Veja [Usuários e permissões](usuarios-e-permissoes.md).

## O topo da tela

- **Total**;
- **Agendadas**;
- **Em Andamento**;
- **Atrasadas**;
- **Custo Total** — soma o custo só das manutenções **Concluídas**.

Filtre por **status** e por **tipo**, ou busque pela descrição e pelo veículo.

## Agendar uma manutenção

1. Abra `Controle › Manutenção` e clique em **Nova Manutenção**.
2. Escolha o **Veículo** — é obrigatório.
3. Escolha o **Tipo de Manutenção**.
4. Preencha, se tiver:
   - **Data Agendada**;
   - **Descrição** (ex.: Troca de óleo e filtro);
   - **Custo (R$)**;
   - **KM Atual**;
   - **Próxima Manutenção (KM)**;
   - **Observações**.
5. Clique em **Agendar Manutenção**.

A manutenção nasce **Agendada**.

## Os tipos

O **Tipo de Manutenção** diz o que vai ser feito:

- **Troca de Óleo**;
- **Rodízio de Pneus**;
- **Freios**;
- **Revisão Geral**;
- **Outro**.

## O intervalo em km

O painel controla a manutenção **por quilometragem**:

- o ponto de partida é o **KM Atual**;
- o intervalo é a diferença até a **Próxima Manutenção (KM)**;
- sem próxima, ou com próxima menor que o KM atual, o intervalo fica em **10.000 km**.

Exemplo: KM Atual 40.000 e Próxima Manutenção 50.000 = intervalo de 10.000 km.

> **Atenção:** o formulário não tem manutenção por tempo nem por horas de motor. A **Data Agendada** serve só para marcar atraso — veja abaixo.

> **Dica:** confira o hodômetro do veículo antes de agendar. Ele é acertado em [Veículos](veiculos.md#hodometro-e-horas-de-motor).

<a id="aviso"></a>
## O aviso de manutenção

Ao salvar, a manutenção fica ligada ao veículo. Quando a manutenção vence, o painel gera o evento **Manutenção necessária**.

Para ser avisado, crie uma notificação do tipo **Manutenção**. Veja [Notificações e alertas](notificacoes-e-alertas.md).

O evento também aparece em `Monitoramento › Eventos` e no relatório de **Eventos** — veja [Relatórios](relatorios.md).

## Os status

| Status | Quando |
|---|---|
| **Agendada** | ao criar |
| **Em Andamento** | você muda na edição |
| **Concluída** | você muda na edição. Entra no **Custo Total** |
| **Atrasada** | o painel marca sozinho quando a **Data Agendada** passou e a manutenção ainda estava **Agendada** |

## Registrar o que foi feito

1. Clique no lápis (**Editar manutenção**) da linha.
2. Acerte o **Custo (R$)** e as **Observações**.
3. Mude o **Status** para **Concluída**.
4. Clique em **Atualizar**.

Para apagar, use a lixeira (**Excluir manutenção**) e confirme.

## Exportar

Marque **Selecionar todos**, acima da tabela, e clique em **Exportar XLSX** ou **Exportar PDF**. Sem a marcação, os botões ficam desligados.

---

# Abastecimento e combustível — registro, consumo e alertas

Fonte: https://docs.nativ.tec.br/guia/abastecimento-e-combustivel/

O menu **Abastecimento** abre em cinco telas:

| Tela | Para quê |
|---|---|
| **Abastecimentos** | registrar e consultar cada abastecimento |
| **Alertas de Consumo** | o km/L fora do esperado |
| **Timeline de KM** | os registros e as correções de quilometragem |
| **Tipos de Combustível** | os combustíveis e lubrificantes que aparecem no registro |
| **Categorias de Veículo** | a faixa de km/L esperada para cada tipo de veículo |

> **Atenção:** por padrão, o menu **Abastecimento** aparece só para **Administrador** e **Gerente**. **Alertas de Consumo** aparece no menu só para o **Administrador**. Veja [Usuários e permissões](usuarios-e-permissoes.md).

## Antes do primeiro registro

1. Em `Abastecimento › Tipos de Combustível`, clique em **Novo Tipo**.
2. Dê o **Nome** (ex.: Diesel S10) e escolha o **Tipo**: **Combustão** ou **Lubrificante**.
3. Clique em **Salvar**.

- **Combustão** aparece em **Tipo de Combustível** no registro.
- **Lubrificante** aparece em **Tipo de Arla**.
- A chave na coluna **Status** desliga um tipo sem apagá-lo.
- Tipo já usado num abastecimento não pode ser apagado.

## Registrar um abastecimento

1. Abra `Abastecimento › Abastecimentos` e clique em **Novo Abastecimento**.
2. Em **Veículo e Data**:
   - escolha o **Veículo**;
   - informe **Data e Hora** e **KM**.
3. Em **Combustível Principal**: **Tipo de Combustível**, **Quantidade (L)** e **Valor Unit.**. O **Valor Total** é calculado.
4. Clique em **Salvar Abastecimento**.

Campos obrigatórios (marcados com *): **Veículo**, **Data e Hora**, **KM**, **Tipo de Combustível**, **Quantidade (L)** e **Valor Unit.**.

Opcionais:

- **Motorista** — se o veículo tiver um motorista vinculado, o painel já escolhe e avisa "Motorista detectado";
- **Arla / Lubrificante** — marque **Incluir** e preencha tipo, quantidade e valor;
- **Fornecedor**, **Nota Fiscal** e **Observação**.

> **Dica:** motorista ou fornecedor que ainda não existe pode ser criado ali mesmo, pela opção **Criar novo motorista** ou **Criar novo fornecedor** da lista.

### Ler o comprovante com IA

No registro novo, o bloco **Importar via IA** lê o comprovante e preenche o formulário.

1. Arraste o comprovante (foto ou PDF) ou clique para escolher.
2. Espere o painel ler o documento.
3. Em **Revisar dados extraídos**, confira e clique em **Confirmar e salvar**. Os dados vão para o formulário.
4. Revise o formulário e clique em **Salvar Abastecimento**.

> **Atenção:** a IA pode errar. Com poucos dados lidos, o painel avisa "Poucos dados extraídos. Revise com cuidado."

### O KM do abastecimento

- Ao escolher o veículo e a data, aparece a **Sugestão GPS**: o hodômetro do rastreador naquele momento. **Usar** copia o valor para o campo **KM**.
- Se o KM digitado ficar mais de 5 km longe do GPS, o campo fica laranja e mostra a diferença.

> **Atenção:** o KM do GPS pode não ser o KM certo do abastecimento. Confira com o painel do veículo.

### Corrigir o KM

Quando o KM digitado é **menor** que o do último abastecimento do veículo, o painel avisa e mostra **Corrigir KM**.

1. Clique em **Corrigir KM**.
2. Em **Correção de KM**, confira o **KM Correto** do último abastecimento.
3. Escreva a **Justificativa** — é obrigatória.
4. Deixe ligado **Recomputar KM rodado dos abastecimentos seguintes**.
5. Clique em **Salvar Correção**.

A correção fica gravada na [Timeline de KM](#timeline-de-km).

## A lista de abastecimentos

No topo:

- **Total Abastecimentos**;
- **Total Valor**;
- **Total Litros**;
- **Média Consumo** (km/L).

Em **Filtros**: **Veículo**, **Tipo Combustível**, **Data Início** e **Data Fim**. Os números do topo seguem os filtros.

Em cada linha:

- o lápis abre o abastecimento para **editar**;
- a lixeira apaga.

**Exportar XLSX** e **Exportar PDF** baixam todos os abastecimentos da lista filtrada. O PDF sai como **Relatório de Abastecimentos**, com o período dos filtros.

## Como o painel calcula o km/L

- **KM rodado** = KM deste abastecimento − KM do abastecimento anterior do mesmo veículo.
- **km/L** = KM rodado ÷ litros abastecidos agora.

Com KM menor que o anterior, o painel salva, mas não calcula o KM rodado desse registro.

> **Dica:** registre todos os abastecimentos, na ordem. Um registro faltando junta dois tanques num só e distorce o km/L.

## Alertas de consumo

A cada abastecimento salvo, o painel compara o km/L de duas formas:

| Regra | Quando alerta |
|---|---|
| **Faixa da categoria** | o km/L ficou abaixo do **Consumo Mínimo** ou acima do **Consumo Máximo** da categoria do veículo |
| **Média do veículo** | o km/L ficou mais de 30% acima ou abaixo da média dos últimos abastecimentos do próprio veículo (são precisos ao menos 3) |

Para ligar a regra da faixa:

1. Em `Abastecimento › Categorias de Veículo`, crie a categoria: **Nome**, **Descrição**, **Consumo Mínimo** e **Consumo Máximo** (km/L).
2. Em [Veículos](veiculos.md#cadastrar-veiculo-e-rastreador), escolha essa categoria no campo **Categoria de consumo** do veículo.

Os alertas ficam em `Abastecimento › Alertas de Consumo`:

- cada linha traz **Severidade**, **Tipo** (Consumo alto ou Consumo baixo), **Veículo**, **km/L observado**, **Faixa esperada**, **Mensagem** e **Data**;
- filtre por **Status** (Em aberto, Resolvidos, Todos) e **Severidade** (Crítico, Atenção, Info);
- **Resolver** fecha o alerta; **Reabrir** volta com ele.

> **Dica:** leia a **Mensagem**: ela diz o km/L medido e com o que foi comparado. Um alerta isolado costuma ser KM digitado errado — confira a [Timeline de KM](#timeline-de-km) antes de tirar conclusão.

## Timeline de KM

`Abastecimento › Timeline de KM` mostra, em ordem, cada quilometragem gravada:

- **Registro** — o KM de um abastecimento, com o KM rodado;
- **Correção** — o KM antes e depois, com a **Justificativa**.

Filtre por **Veículo**, **Data Início** e **Data Fim**. No topo, o total de registros, de correções e o **KM Total Rodado**.

O resumo de abastecimento do **Dashboard** também leva a esta tela.

<a id="cockpit-do-veiculo"></a>
## Cockpit do Veículo (telemetria)

`Recursos Avançados › Cockpit do Veículo` é o painel ao vivo de um veículo. Também abre pelo mapa.

> **Atenção:** por padrão, aparece só para **Administrador** e **Gerente**.

1. Em **Escolher veículo**, selecione o veículo.
2. A tela se atualiza sozinha. No topo aparece **AO VIVO** ou há quanto tempo veio o último dado.

| Parte | O que mostra |
|---|---|
| Topo | ignição, tensão da alimentação, satélites, **Bloqueado**, e os botões **Ver no mapa** e **Replay do dia** |
| **Hoje** | a nota de condução do dia e **Percorrido**, **Dirigindo**, **Marcha lenta** e **Vel. máxima** |
| **Painel de luzes** | Ignição, Alarme, Bloqueio, Alimentação, Bateria, Temperatura, Combustível, Injeção, Porta, GPS, Sinal e Limite — cada uma acende quando o dado sai do normal |
| Força G | a força da última aceleração, frenagem ou curva |
| **Velocidade — últimos 30 min** | o gráfico da velocidade |
| **Ocorrências de hoje** | frenagem e aceleração bruscas, curva acentuada, excesso de velocidade, rotação elevada, marcha lenta prolongada, direção contínua e alarmes, com o link **Relatório de condução** |
| **Instrumentos e sensores** | todos os sensores que o rastreador envia |

- Só aparecem as luzes e os sensores que o rastreador do veículo envia.
- Sem comunicação há mais de 30 minutos, o cockpit avisa que os valores são da última posição recebida.

Para o histórico de condução de vários dias e de vários veículos, use o relatório **Condução** em [Relatórios](relatorios.md#os-tipos-de-relatorio).

---

# Rastreadores compatíveis e portas do servidor

Fonte: https://docs.nativ.tec.br/guia/rastreadores-e-portas/

O Nativ aceita rastreadores de **266 protocolos**. Cada protocolo tem uma **porta própria** no servidor. Para o rastreador aparecer no painel, ele precisa de três coisas:

1. o **endereço do servidor**;
2. a **porta do protocolo** dele;
3. o cadastro no painel com o **IMEI** (veja [Veículos](veiculos.md#cadastrar-veiculo-e-rastreador)).

## Endereço do servidor

| Campo no rastreador | Valor |
|---|---|
| Servidor (domínio) | **sv01.rastrear.app.br** |
| Servidor (IP), se o rastreador não aceitar domínio | **177.85.77.177** |
| Porta | a do protocolo, nas tabelas abaixo |

> **Dica:** prefira o domínio. Se o servidor mudar de IP um dia, quem configurou pelo domínio não precisa reprogramar nada.

## As marcas mais usadas

| Marca | Modelos (exemplos) | Protocolo | Porta |
|---|---|---|---|
| Teltonika | FMB, FMC, FMM, FMT | `teltonika` | **5027** |
| Queclink | GL, GV | `gl200` | **5004** |
| Suntech | ST | `suntech` | **5011** |
| Concox / Jimi IoT | GT06 e compatíveis | `gt06` | **5023** |
| Jimi IoT | linha JT808 (JC, VL) | `jt808` | **5015** |
| Jimi IoT, câmeras | vídeo e fotos | `jt1078` · `jimiphoto` | **5263** · **5267** |
| Coban | TK103, GPS-103 | `gps103` | **5001** |
| Sinotrack e compatíveis H02 | ST-901 | `h02` | **5013** |
| Maxtrack | MXT | `mxt` | **5087** |
| Ruptela | FM | `ruptela` | **5046** |
| Meitrack | MT, T | `meitrack` | **5020** |
| GalileoSky | 7.0, 10 | `galileo` | **5034** |
| TopFlyTech | T8 | `topflytech` | **5047** |
| ATrack | AK, AX | `atrack` | **5044** |
| Cellocator | CR | `cellocator` | **5033** |
| CalAmp | LMU | `calamp` | **5082** (UDP) |
| Celular como rastreador | apps no padrão OsmAnd | `osmand` | **5055** |

> **Atenção:** a mesma marca pode ter modelos em protocolos diferentes. Na dúvida, confira no manual do rastreador qual protocolo ele usa, ou fale com a central antes de programar a frota toda.

## Configurar o rastreador

1. Descubra o **protocolo** do modelo (manual do fabricante ou tabela acima).
2. Programe o rastreador com o **servidor** e a **porta** do protocolo. Isso costuma ser feito por SMS ou pelo programa do fabricante.
3. Confira o **APN do chip**. Sem internet no chip, o rastreador não chega ao servidor.
4. Cadastre o veículo no painel com o **IMEI** do rastreador.
5. Em alguns minutos, o veículo aparece no [mapa](mapa-em-tempo-real.md).

> **Dica:** teste com **um** rastreador antes de reprogramar a frota toda. Se ele não aparecer, confira IMEI, porta e APN, nessa ordem.

## Veio de outra plataforma?

Basta mandar a cada rastreador o comando de **troca de servidor**, com o endereço e a porta desta página. A Rastrear dá suporte à central nessa etapa.

## Todos os protocolos

Use **Ctrl+F** (ou **⌘+F** no Mac) para achar o protocolo. **TCP** e **UDP** dizem como o rastreador se conecta. A maioria usa TCP, e alguns aceitam os dois.

<!-- protocolos:inicio -->
| Protocolo | Porta | Transporte |
|---|---|---|
| `gps103` | **5001** | TCP e UDP |
| `tk103` | **5002** | TCP e UDP |
| `gl100` | **5003** | TCP e UDP |
| `gl200` | **5004** | TCP e UDP |
| `t55` | **5005** | TCP e UDP |
| `xexun` | **5006** | TCP |
| `totem` | **5007** | TCP |
| `enfora` | **5008** | TCP e UDP |
| `meiligao` | **5009** | TCP e UDP |
| `trv` | **5010** | TCP |
| `suntech` | **5011** | TCP |
| `progress` | **5012** | TCP |
| `h02` | **5013** | TCP e UDP |
| `jt600` | **5014** | TCP |
| `jt808` | **5015** | TCP |
| `v680` | **5016** | TCP e UDP |
| `pt502` | **5017** | TCP |
| `tr20` | **5018** | TCP e UDP |
| `navis` | **5019** | TCP |
| `meitrack` | **5020** | TCP e UDP |
| `skypatrol` | **5021** | UDP |
| `gt02` | **5022** | TCP |
| `gt06` | **5023** | TCP |
| `megastek` | **5024** | TCP |
| `navigil` | **5025** | TCP |
| `gpsgate` | **5026** | TCP |
| `teltonika` | **5027** | TCP e UDP |
| `mta6` | **5028** | TCP |
| `tzone` | **5029** | TCP |
| `tlt2h` | **5030** | TCP e UDP |
| `taip` | **5031** | TCP e UDP |
| `wondex` | **5032** | TCP e UDP |
| `cellocator` | **5033** | TCP e UDP |
| `galileo` | **5034** | TCP |
| `ywt` | **5035** | TCP |
| `tk102` | **5036** | TCP |
| `intellitrac` | **5037** | TCP |
| `gpsmta` | **5038** | UDP |
| `wialon` | **5039** | TCP e UDP |
| `carscop` | **5040** | TCP |
| `apel` | **5041** | TCP |
| `manpower` | **5042** | TCP |
| `globalsat` | **5043** | TCP |
| `atrack` | **5044** | TCP e UDP |
| `pt3000` | **5045** | TCP |
| `ruptela` | **5046** | TCP |
| `topflytech` | **5047** | TCP |
| `laipac` | **5048** | TCP |
| `aplicom` | **5049** | TCP |
| `gotop` | **5050** | TCP |
| `sanav` | **5051** | TCP e UDP |
| `gator` | **5052** | TCP e UDP |
| `noran` | **5053** | UDP |
| `m2m` | **5054** | TCP |
| `osmand` | **5055** | TCP |
| `easytrack` | **5056** | TCP |
| `gpsmarker` | **5057** | TCP |
| `khd` | **5058** | TCP |
| `piligrim` | **5059** | TCP |
| `stl060` | **5060** | TCP |
| `cartrack` | **5061** | TCP |
| `minifinder` | **5062** | TCP |
| `haicom` | **5063** | TCP |
| `eelink` | **5064** | TCP e UDP |
| `box` | **5065** | TCP |
| `freedom` | **5066** | TCP |
| `telic` | **5067** | TCP |
| `trackbox` | **5068** | TCP |
| `visiontek` | **5069** | TCP |
| `orion` | **5070** | TCP |
| `riti` | **5071** | TCP |
| `ulbotech` | **5072** | TCP |
| `tramigo` | **5073** | TCP |
| `tr900` | **5074** | TCP e UDP |
| `ardi01` | **5075** | TCP |
| `xt013` | **5076** | TCP |
| `autofon` | **5077** | TCP |
| `gosafe` | **5078** | TCP e UDP |
| `tt8850` | **5079** | TCP |
| `bce` | **5080** | TCP |
| `xirgo` | **5081** | TCP e UDP |
| `calamp` | **5082** | UDP |
| `mtx` | **5083** | TCP |
| `tytan` | **5084** | UDP |
| `avl301` | **5085** | TCP |
| `castel` | **5086** | TCP e UDP |
| `mxt` | **5087** | TCP |
| `cityeasy` | **5088** | TCP |
| `aquila` | **5089** | TCP |
| `flextrack` | **5090** | TCP |
| `blackkite` | **5091** | TCP |
| `adm` | **5092** | TCP |
| `watch` | **5093** | TCP |
| `t800x` | **5094** | TCP e UDP |
| `upro` | **5095** | TCP |
| `auro` | **5096** | TCP |
| `disha` | **5097** | TCP |
| `thinkrace` | **5098** | TCP |
| `pathaway` | **5099** | TCP |
| `arnavi` | **5100** | TCP |
| `nvs` | **5101** | TCP |
| `kenji` | **5102** | TCP |
| `astra` | **5103** | TCP e UDP |
| `homtecs` | **5104** | UDP |
| `fox` | **5105** | TCP |
| `gnx` | **5106** | TCP |
| `arknav` | **5107** | TCP e UDP |
| `supermate` | **5108** | TCP |
| `appello` | **5109** | TCP |
| `idpl` | **5110** | TCP |
| `huasheng` | **5111** | TCP |
| `l100` | **5112** | TCP |
| `granit` | **5113** | TCP |
| `carcell` | **5114** | TCP |
| `obddongle` | **5115** | TCP |
| `hunterpro` | **5116** | TCP |
| `raveon` | **5117** | TCP |
| `cradlepoint` | **5118** | TCP |
| `arknavx8` | **5119** | TCP |
| `autograde` | **5120** | TCP |
| `oigo` | **5121** | UDP |
| `jpkorjar` | **5122** | TCP |
| `cguard` | **5123** | TCP |
| `fifotrack` | **5124** | TCP |
| `smokey` | **5125** | UDP |
| `extremtrac` | **5126** | TCP |
| `trakmate` | **5127** | TCP |
| `at2000` | **5128** | TCP |
| `maestro` | **5129** | TCP |
| `ais` | **5130** | TCP |
| `gt30` | **5131** | TCP |
| `tmg` | **5132** | TCP |
| `pretrace` | **5133** | TCP |
| `pricol` | **5134** | TCP e UDP |
| `siwi` | **5135** | TCP |
| `starlink` | **5136** | TCP |
| `dmt` | **5137** | TCP |
| `xt2400` | **5138** | UDP |
| `dmthttp` | **5139** | TCP |
| `alematics` | **5140** | TCP |
| `gps056` | **5141** | TCP |
| `flexcomm` | **5142** | TCP |
| `vt200` | **5143** | TCP |
| `owntracks` | **5144** | TCP |
| `vtfms` | **5145** | TCP e UDP |
| `tlv` | **5146** | TCP |
| `esky` | **5147** | TCP e UDP |
| `genx` | **5148** | TCP |
| `flespi` | **5149** | TCP |
| `dway` | **5150** | TCP |
| `recoda` | **5151** | TCP |
| `oko` | **5152** | TCP |
| `ivt401` | **5153** | TCP |
| `sigfox` | **5154** | TCP |
| `t57` | **5155** | TCP |
| `spot` | **5156** | TCP |
| `m2c` | **5157** | TCP |
| `austinnb` | **5158** | UDP |
| `opengts` | **5159** | TCP |
| `cautela` | **5160** | TCP |
| `continental` | **5161** | TCP |
| `egts` | **5162** | TCP |
| `robotrack` | **5163** | TCP |
| `pt60` | **5164** | TCP |
| `telemax` | **5165** | TCP |
| `sabertek` | **5166** | TCP |
| `retranslator` | **5167** | TCP |
| `svias` | **5168** | TCP |
| `eseal` | **5169** | TCP |
| `freematics` | **5170** | UDP |
| `avema` | **5171** | TCP |
| `autotrack` | **5172** | TCP |
| `tek` | **5173** | TCP |
| `wristband` | **5174** | TCP |
| `milesmate` | **5176** | TCP |
| `anytrek` | **5177** | TCP |
| `smartsole` | **5178** | TCP |
| `its` | **5179** | TCP |
| `xrb28` | **5180** | TCP |
| `c2stek` | **5181** | TCP |
| `nyitech` | **5182** | TCP |
| `neos` | **5183** | UDP |
| `satsol` | **5184** | TCP |
| `globalstar` | **5185** | TCP |
| `sanul` | **5186** | TCP |
| `minifinder2` | **5187** | TCP |
| `radar` | **5188** | TCP |
| `techtlt` | **5189** | UDP |
| `starcom` | **5190** | UDP |
| `mictrack` | **5191** | TCP e UDP |
| `plugin` | **5192** | TCP |
| `leafspy` | **5193** | TCP |
| `naviset` | **5194** | TCP |
| `racedynamics` | **5195** | TCP |
| `rst` | **5196** | UDP |
| `pt215` | **5197** | TCP |
| `pacifictrack` | **5198** | UDP |
| `topin` | **5199** | TCP |
| `outsafe` | **5200** | TCP |
| `solarpowered` | **5201** | TCP |
| `motor` | **5202** | TCP |
| `omnicomm` | **5203** | TCP |
| `s168` | **5204** | TCP |
| `vnet` | **5205** | TCP |
| `blue` | **5206** | TCP |
| `pst` | **5207** | TCP e UDP |
| `dingtek` | **5208** | TCP |
| `wli` | **5209** | TCP |
| `niot` | **5210** | TCP |
| `portman` | **5211** | TCP |
| `moovbox` | **5212** | TCP |
| `futureway` | **5213** | TCP |
| `polte` | **5214** | TCP |
| `net` | **5215** | TCP |
| `mobilogix` | **5216** | TCP |
| `swiftech` | **5217** | TCP |
| `iotm` | **5218** | TCP |
| `dolphin` | **5219** | TCP |
| `ennfu` | **5220** | TCP |
| `maxpb` | **5221** | TCP |
| `startek` | **5222** | TCP |
| `gs100` | **5223** | TCP |
| `mavlink2` | **5224** | UDP |
| `uux` | **5225** | TCP |
| `r12w` | **5226** | TCP |
| `flexiblereport` | **5227** | UDP |
| `thinkpower` | **5228** | TCP |
| `stb` | **5229** | TCP |
| `b2316` | **5230** | UDP |
| `hoopo` | **5231** | TCP |
| `dualcam` | **5232** | TCP |
| `xexun2` | **5233** | TCP |
| `techtocruz` | **5234** | TCP |
| `flexapi` | **5235** | TCP |
| `dsf22` | **5236** | TCP e UDP |
| `jido` | **5237** | TCP |
| `armoli` | **5238** | TCP |
| `teratrack` | **5239** | TCP |
| `envotech` | **5240** | TCP |
| `bstpl` | **5241** | TCP |
| `thuraya` | **5242** | TCP |
| `ndtpv6` | **5243** | TCP |
| `g1rus` | **5244** | TCP |
| `rftrack` | **5245** | TCP |
| `vlt` | **5246** | TCP |
| `transync` | **5247** | TCP |
| `t622iridium` | **5248** | TCP |
| `pui` | **5249** | TCP |
| `nto` | **5250** | TCP |
| `ramac` | **5251** | TCP |
| `positrex` | **5252** | UDP |
| `dragino` | **5253** | TCP |
| `fleetguide` | **5254** | UDP |
| `valtrack` | **5255** | TCP |
| `snapper` | **5256** | TCP |
| `gl601` | **5257** | TCP |
| `hyn600` | **5258** | TCP |
| `jmak` | **5259** | TCP |
| `bws` | **5260** | UDP |
| `ttnhttp` | **5261** | TCP |
| `smartcar` | **5262** | TCP |
| `jt1078` | **5263** | TCP |
| `xexun3` | **5264** | TCP |
| `radshid` | **5265** | TCP |
| `r16h` | **5266** | TCP |
| `jimiphoto` | **5267** | TCP |
<!-- protocolos:fim -->

---

# Relatórios — viagens, paradas, eventos, condução e resumo da frota

Fonte: https://docs.nativ.tec.br/guia/relatorios/

A tela **Relatórios** (`Monitoramento › Relatórios`) monta o relatório em 3 passos, na barra da esquerda:

1. **Qual veículo?** — um ou vários.
2. **Qual período?**
3. **O que você quer ver?** — o tipo de relatório.

Depois, clique em **Gerar relatório**.

> **Dica:** na dúvida, comece por **Posições**.

## Montar um relatório

1. Abra `Monitoramento › Relatórios`.
2. Em **Qual veículo?**, escolha um ou mais veículos.
3. Em **Qual período?**, escolha o período.
4. Em **O que você quer ver?**, clique no tipo de relatório.
5. Clique em **Gerar relatório**.

Acima do resultado aparecem o período, os veículos e o motorista escolhidos.

## Filtros

**Período:**

- **Hoje**, **Ontem**;
- **Esta Semana**, **Semana Anterior** (a semana começa na segunda);
- **Este Mês**, **Mês Anterior**;
- **Escolher datas** — **De** e **Até**, o dia inteiro.

**Veículos:**

- **Posições** e **Gráfico** olham um veículo por vez: com vários escolhidos, vale o primeiro da lista.
- **Condução** analisa até 30 veículos de uma vez.

**Motorista no PDF (opcional):** escolhe um motorista para sair no PDF. Só aparece quando há motoristas cadastrados. Veja [Motoristas](motoristas.md).

## Os tipos de relatório

| Grupo | Relatório | O que mostra |
|---|---|---|
| Trajeto | **Posições** | cada posição enviada: mapa, velocidade, sensores e todos os atributos |
| Trajeto | **Viagens** | cada saída e chegada: origem, destino, distância, duração e velocidade máxima. Em **Colunas**, o motorista e a identificação dele |
| Trajeto | **Paradas** | onde e por quanto tempo ficou parado, e quanto tempo com motor ligado |
| Motorista | **Condução** | a nota de 0 a 100 de cada veículo: freadas, acelerações, curvas e excessos |
| Ocorrências | **Eventos** | alarmes e avisos do rastreador, por gravidade |
| Ocorrências | **Cercas** | entradas e saídas das [cercas virtuais](cercas-virtuais.md) |
| Ocorrências | **Ignição** | quando ligou e desligou o motor |
| Ocorrências | **Combustível** | quedas e aumentos do nível de combustível que o rastreador mede |
| Visão geral | **Resumo** | por veículo: distância, velocidades, horas de motor, combustível, hodômetro e horímetro do início e do fim |
| Visão geral | **Gráfico** | a velocidade e a altitude ao longo do período |
| Visão geral | **Tudo junto** | Resumo, Posições, Viagens, Paradas, Eventos e Gráfico, em abas |

> **Atenção:** **Cercas**, **Ignição** e **Combustível** saem dos eventos que o rastreador e o painel geram. Sem cerca cadastrada ou sem sensor de combustível no veículo, o relatório vem vazio.

### Condução

- Mostra a **Nota da frota** (média pelos km de cada veículo), **Distância analisada**, **Tempo dirigindo**, **Ocorrências** e **Marcha lenta**.
- **Ocorrências por tipo** e **Horário das ocorrências** mostram onde e quando a frota exagera.
- O excesso de velocidade usa o **Limite de velocidade** do cadastro do veículo. Veja [Veículos](veiculos.md#cadastrar-veiculo-e-rastreador).

### Eventos

Os cartões do topo filtram a lista: **Eventos**, **Críticos**, **Atenção** e **Informativos**.

## Colunas e exportação

Nos relatórios em tabela (**Posições**, **Viagens**, **Paradas**, **Eventos** e **Resumo**), a barra da tabela tem:

- **Colunas** — marque o que quer ver. Em **Posições**, dá para ligar cada atributo que o rastreador envia. A escolha fica lembrada neste navegador.
- **Excel** e **CSV** — baixam todas as linhas, com as colunas que estão visíveis.

No topo da tela, depois de gerar:

| Botão | O que faz |
|---|---|
| **Excel** | baixa o relatório numa planilha .xlsx |
| **PDF** | abre o relatório numa nova aba, pronto para imprimir. Use Ctrl+P e escolha **Salvar como PDF** |

> **Atenção:** **Condução** exporta só em **PDF**. No PDF de **Posições**, saem as mesmas colunas escolhidas na tela.

> **Dica:** o CSV usa ponto e vírgula e abre direto no Excel com os acentos certos.

## Relatório agendado

A tela **Relatórios** não agenda envio automático: o relatório é gerado na hora, por quem está no painel.

## Estatísticas

`Monitoramento › Estatísticas` resume a frota num período: **Hoje**, **Semana** (últimos 7 dias) ou **Mês** (último mês).

- **Distância Total**;
- **Veículos com Dados**;
- **Combustível Gasto**;
- **Horas de Motor**;
- em **Métricas Detalhadas**: **Velocidade Média**, **Velocidade Máxima** e **Eficiência** (km/L).

Distância, combustível e horas de motor vêm comparados com o período anterior do mesmo tamanho ("vs período anterior").

## Rotas planejadas

`Recursos Avançados › Rotas` guarda o caminho que um veículo deve fazer.

1. Clique em **Nova rota**.
2. Dê o **Nome da rota** e escolha o **Veículo**.
3. Em **Waypoints (mín. 2)**, informe nome, latitude e longitude de cada ponto, em graus decimais (ex.: -23.55, -46.63). Os dois primeiros são **Início** e **Fim**; **Adicionar** inclui mais pontos.
4. Clique em **Criar rota**.

Cada rota mostra o veículo, o número de pontos e a data de criação. **Ver no mapa** desenha a rota no [mapa](mapa-em-tempo-real.md), do início (verde) ao fim.

> **Atenção:** a rota é só desenhada no mapa. O painel não compara o caminho feito com o planejado nem avisa desvio.

## Logs de Auditoria

`Gerenciamento › Logs de Auditoria` mostra quem fez o quê no painel.

> **Atenção:** por padrão, só o **Administrador** vê esta tela.

- No topo: **Total de Eventos**, **Eventos Hoje**, **Logins Falhos** e **Usuários Ativos**.
- Cada item traz a ação (Criação, Atualização, Exclusão, Login, Logout…), o usuário, o recurso, a hora, o detalhe, o IP e o navegador.
- Busque por usuário, ação ou IP, e filtre por **Ação**, **Recurso** e período (**Hoje**, **Ontem**, **Últimos 7 dias**, **Últimos 30 dias**, **Tudo**).
- **Anterior** e **Próxima** passam as páginas.

## Quem vê cada tela

> **Atenção:** por padrão, **Relatórios**, **Estatísticas** e **Rotas** aparecem para todas as funções; **Logs de Auditoria**, só para o **Administrador**. A central muda isso em **Controle de Acesso** — veja [Usuários e permissões](usuarios-e-permissoes.md).

---

# Instalar o app no celular e entrar

Fonte: https://docs.nativ.tec.br/guia/instalar-o-app/

O app no celular é o mesmo para todas as centrais: ao ser configurado, ele recebe o **logo**, as **cores** e os **contatos de suporte** da sua central. Neste guia ele é chamado de "app da sua central" (ou app Nativ).

## Baixar o app

- **Android:** [Google Play](https://play.google.com/store/apps/details?id=com.gps.rastrear)
- **iPhone:** [App Store](https://apps.apple.com/br/app/id6698845713)

> **Dica:** se a central mandou um link, comece por ele (veja abaixo). O link leva à loja certa do seu celular e já deixa o app configurado.

## Configurar com o link da central

A central envia um link por WhatsApp, e-mail ou SMS. Abra o link **no celular**:

- **App já instalado:** o app abre sozinho, carrega o logo e as cores da central e reinicia.
- **Android, app ainda não instalado:** o link leva à Google Play. Instale e abra: o app já abre configurado.
- **iPhone, app ainda não instalado:** o link leva à App Store. Instale e abra: o app lê o link copiado e mostra **Configuração Detectada!**.

> **Dica:** no iPhone, o sistema pode avisar que o app leu a área de transferência. É normal: é assim que o app pega o link da central.

Copiou o link e o app não configurou? Na tela de entrada, toque no botão de **colar** ao lado do campo **Servidor** e confirme em **Aplicar**.

## Configurar com o QR Code

Na primeira abertura, o app mostra **Configurar Servidor**.

1. Toque em **Escanear QR Code** (a opção marcada como **RECOMENDADO**).
2. Permita o uso da câmera.
3. Aponte para o QR Code que a central enviou.
4. Confira o nome em **Empresa identificada** e toque em **Configurar**.
5. O app mostra **Configurações aplicadas! Reiniciando app...** e volta pronto para entrar.

Já passou dessa tela? Na tela de entrada, use o botão de **QR Code** ao lado do campo **Servidor**.

## Digitar o endereço do servidor

Sem link e sem QR Code? Peça à central o endereço do servidor.

1. Em **Configurar Servidor**, vá até **ou digite manualmente**.
2. Digite o endereço em **URL do Servidor** (por exemplo, `rastreio.suacentral.com.br`).
3. Toque em **Conectar**.

> **Atenção:** esse campo não é o seu e-mail. O e-mail e a senha são pedidos na tela seguinte.

> **Atenção:** o app não tem campo de "código da empresa". Ele se configura pelo link, pelo QR Code ou pelo endereço do servidor. A opção **Usar** seguida de um nome de empresa liga o app ao servidor padrão: use só se a sua central pedir.

Se a central tiver mais de um visual, o app mostra **Escolha seu tema**. Escolha e toque em **Confirmar**.

## Entrar

1. Confira em **Servidor** se aparece o endereço da sua central.
2. Digite o **E-mail** e a **Senha** que a central cadastrou.
3. Toque em **Entrar**.

- O ícone de olho mostra a senha digitada.
- O app guarda o acesso: na próxima vez, ele abre direto na lista de veículos.
- O ícone de engrenagem no topo abre **Configurações**: **Idioma** (Português ou English) e **Servidor**.
- **Ajuda?** abre a página de ajuda da central, quando ela tem uma.

> **Atenção:** o celular é usado por outras pessoas? Saia da conta ao terminar (veja [Sair da conta](#sair-da-conta)).

## Esqueci a senha

Toque em **Esqueceu a senha?** na tela de entrada. Abre no navegador a página para criar uma senha nova.

- O link só aparece se a central oferecer essa opção.
- Não aparece? Peça uma senha nova à central.

## As permissões que o app pede

| Permissão | Para quê |
|---|---|
| **Notificações** | receber no celular os alertas dos veículos, como ignição ligada ou saída de cerca |
| **Localização** | mostrar onde você está no mapa e centralizar o mapa em você ao desenhar uma cerca |
| **Câmera** | ler o QR Code da central |
| **Ignorar otimização de bateria** (só Android) | manter o app funcionando em segundo plano |

No Android, o app pede as permissões na primeira abertura. Se você negar, aparece **Permissões Necessárias**:

- **Tentar Novamente** pede de novo.
- **Continuar Assim** segue sem elas.

Negou de vez? O app mostra **Permissão Necessária** com o botão **Abrir Configurações**, que leva às configurações do celular.

> **Atenção:** sem a permissão de **Notificações**, os alertas não chegam no celular. Os veículos continuam aparecendo no mapa normalmente.

## Trocar a senha

1. Abra **Menu › Conta › Trocar Senha**.
2. Digite a **Nova Senha** (mínimo de 6 caracteres) e repita em **Digite a senha novamente**.
3. Toque em **OK**.

## Sair da conta

Abra **Menu** e toque em **Sair da conta**, no fim da tela.

- O app volta para a tela de entrada.
- Ele continua com o logo, as cores e o servidor da central. Para entrar com outro usuário da mesma central, é só digitar o outro e-mail e senha.

## Trocar de central

Você é cliente de outra central, ou mudou de central?

- Abra o link ou leia o QR Code da nova central. O app encerra a sessão atual, aplica o novo visual e reinicia.
- Ou, na tela de entrada, toque na engrenagem e escolha outro servidor em **Servidor**.

## Problemas comuns

| A tela mostra | O que fazer |
|---|---|
| **Sem Conexão** | confira a internet do celular e toque em **Tentar Novamente** |
| **Empresa não encontrada** | confira o link ou leia o QR Code de novo; se continuar, peça um link novo à central |
| **Servidor não está respondendo** | espere um pouco e tente de novo |
| **Servidor Indisponível** | o app da central está fora do ar no momento; leia o aviso abaixo do título e fale com a central |
| **Email ou senha incorretos** | confira os dados ou use **Esqueceu a senha?** |

Depois de entrar, veja [o que dá para fazer no app](usar-o-app.md).

---

# Usar o app de rastreamento no celular

Fonte: https://docs.nativ.tec.br/guia/usar-o-app/

Ainda não entrou no app? Veja [Instalar o app](instalar-o-app.md).

O app tem 5 abas na parte de baixo da tela:

| Aba | Para quê |
|---|---|
| **Veículos** | a lista da frota e as ações de cada veículo |
| **Mapa** | todos os veículos no mapa |
| **Telemetria** | a situação de cada veículo ao vivo e a nota de condução |
| **Alertas** | os eventos da frota, em tempo real |
| **Menu** | cadastros, relatórios, conta e suporte |

O que aparece depende do seu tipo de acesso. Ele fica no topo do **Menu**, abaixo do seu nome: **Administrador**, **Gerente**, **Usuário** ou **Somente Leitura**. Veja [Usuários e permissões](usuarios-e-permissoes.md).

> **Dica:** no Android, o botão voltar leva para a aba **Veículos** antes de fechar o app.

## Lista de veículos

Abra a aba **Veículos**.

- No topo, os totais: **Total**, **Online**, **Offline** e **Inativos**.
- Os veículos online vêm primeiro.
- Cada cartão mostra o nome, a última comunicação (**Agora**, **Há 5 min**…) e os ícones de alarme, ignição e bateria, quando o rastreador envia esses dados.
- **Buscar...** acha pelo nome, identificador, telefone, modelo ou contato.
- Os filtros separam por **Status**, **Categoria** e **Grupo**. **Mostrar Desativados** inclui os veículos desativados.

Toque num veículo para abrir as ações dele.

## Ações do veículo

Toque no veículo na aba **Veículos**. Abre um painel com o nome, o endereço e uma grade de ações:

| Ação | O que faz |
|---|---|
| **Rastreamento ao vivo** | segue o veículo no mapa |
| **Bloquear** | bloqueia ou desbloqueia o veículo |
| **Telemetria** | abre o painel do veículo |
| **Relatório** | abre os relatórios do veículo |
| **Playback** | reproduz o trajeto de um período |
| **Resumo 24h** | o resumo das últimas 24 horas |
| **Informação** | todos os dados da última posição |

O ícone de compartilhar, no topo do painel, gera um link da localização (veja [Compartilhar a localização](#compartilhar-a-localizacao)).

> **Atenção:** só **Administrador** e **Gerente** veem também **Ajustes**, **Comandos**, **Alertas**, **Manutenção**, **Cerca Geográfica**, **Motoristas** e os botões **Conexões** e **Editar**.

## Mapa

Abra a aba **Mapa**.

- Com o mapa afastado, os veículos próximos aparecem agrupados. Aproxime para separar.
- **Buscar** acha um veículo pelo nome.
- Toque num veículo para ver o cartão: status, ignição, bateria, endereço e hora da última posição.
- No cartão, **Navegar** abre o app de mapas do celular com a posição do veículo.

Os botões do lado do mapa:

| Botão | O que faz |
|---|---|
| mapa | alterna entre mapa e satélite com ruas |
| semáforo | mostra o trânsito |
| atualizar | recarrega o mapa |
| alvo | vai até onde você está |
| sol e lua | liga o modo noturno; segure o botão para o modo automático |

Com um veículo selecionado, aparecem também o **Street View** e o botão de comandos salvos do veículo.

Mais detalhes em [Mapa em tempo real](mapa-em-tempo-real.md).

## Rastreamento ao vivo

**Veículos ›** toque no veículo **› Rastreamento ao vivo**.

O mapa acompanha o veículo enquanto ele se move. No topo:

- **Tipo do mapa** e **Trânsito**;
- **Street View** do local;
- **Navegar**, para ir até o veículo;
- **Playback**, para rever o trajeto.

## Playback (histórico do trajeto)

1. **Veículos ›** toque no veículo **› Playback**.
2. No **Filtro de Relatório**, confira o **Veículo Selecionado** e escolha a **Data Inicial** e a **Data Final**.
3. Toque em **Filtrar**.

Na tela do trajeto:

- o botão play/pausa toca o trajeto; no fim, ele vira **repetir**;
- a velocidade vai de **0.5x** a **4x**;
- a barra deslizante pula para qualquer ponto;
- o cartão mostra a hora, a **Velocidade** e o endereço de cada ponto;
- os ícones de parada mostram **Parada:** e a duração.

> **Atenção:** o período vai até **30 dias**. Acima de 7 dias, o app avisa que a consulta pode ficar lenta.

Mais em [Histórico e playback](historico-e-replay.md).

## Bloquear e desbloquear

**Veículos ›** toque no veículo **› Bloquear**.

1. O app mostra **Bloquear Veículo** (ou **Desbloquear Veículo**, se o veículo já estiver bloqueado).
2. Toque em **Bloquear** (ou **Desbloquear**) para confirmar. **Cancelar** desiste.
3. O app mostra **Comando enviado com sucesso** ou **Erro ao enviar comando**.

Pelo **Mapa**, o ícone de cadeado no cartão do veículo abre **Corte de Combustível**:

- **Desbloquear** envia o desbloqueio direto, sem segunda confirmação;
- **Bloquear** pede uma segunda confirmação (**Se você cortar o veículo será bloqueado!**). Toque em **Cortar agora** ou em **Voltar**.

Regras do app:

- Se a central desligou o corte para aquele veículo, o app mostra **O corte de combustível está desativado para este dispositivo.** e não envia nada.
- "Comando enviado" quer dizer que o comando saiu. O veículo bloqueia quando o rastreador recebe o comando.
- O cadeado do cartão no mapa fica vermelho quando o rastreador informa que o veículo está bloqueado.

> **Atenção:** o app não confere a velocidade antes de enviar. Bloqueie com o veículo em local seguro: antes, veja no mapa se ele está parado. Se estiver andando, combine o momento do bloqueio com o motorista ou com as autoridades.

Mais em [Comandos e bloqueio](comandos-e-bloqueio.md).

## Comandos

**Veículos ›** toque no veículo **› Comandos**.

- **Comandos Rápidos**: **Bloquear Motor** e **Desbloquear Motor**. O app pede **Confirmar Envio** antes de mandar.
- **Outros Comandos**: os que o rastreador do veículo aceita.
- O botão **+** abre o **Comando Personalizado**.
- O ícone de relógio abre o **Histórico de Comandos**: **Todos**, **Enviados** e **Respostas**. As respostas novas aparecem sozinhas.

> **Atenção:** a tela **Comandos** é só de **Administrador** e **Gerente**.

## Compartilhar a localização

Gera um link para alguém ver o veículo em tempo real, sem login.

1. **Veículos ›** toque no veículo e toque no ícone de compartilhar, no topo do painel.
2. Toque em **OK** para continuar.
3. Em **Data de Expiração**, escolha até quando o link vale (até 7 dias a partir de hoje).
4. Toque em **Gerar Link**.
5. Copie o **Link de Compartilhamento** ou toque em **Compartilhar** para mandar por WhatsApp, e-mail etc.

- Quando o veículo já está compartilhado, o ícone fica verde e mostra quanto falta para expirar.
- O link deixa de funcionar sozinho na data escolhida.

> **Atenção:** **Remover** tira o link do seu celular, mas não cancela o link que você já mandou. Ele vale até a data de expiração.

Mais em [Compartilhar veículo](compartilhar-veiculo.md).

## Telemetria

Abra a aba **Telemetria** (ou **Menu › Telemetria › Situação da frota ao vivo**).

- No topo, os totais: **Rodando**, **Marcha lenta**, **Parados** e **Alertas**.
- O filtro **Situação** separa por **Em movimento**, **Marcha lenta**, **Estacionado**, **Sem sinal**, **Sem posição** ou **Com alerta**.

Toque num veículo para abrir o painel dele (também em **Veículos ›** veículo **› Telemetria**):

- a situação agora (por exemplo, **Condução tranquila**, **Frenagem brusca**, **Estacionado**), a ignição e o **Bloqueado**, quando houver;
- **Condução de hoje**: quilômetros, tempo dirigindo, velocidade máxima e ocorrências;
- **Instrumentos**: rotação, temperatura, combustível, tensão, odômetro, horímetro e outros, quando o rastreador envia;
- **Luzes do painel**: motor, energia, velocidade, bloqueio, porta, freio e alarme;
- **Forças G**: arrancada, frenagem e curva, com os limites do veículo.

> **Dica:** o rastreador não envia dados do motor? O painel avisa, e velocidade, ignição e posição continuam ao vivo.

## Análise e ranking de condução

- **Análise de condução:** no painel do veículo, toque em **Ver análise**. Escolha **Hoje**, **Ontem**, **24 h**, **Esta semana** ou **7 dias**. Mostra o **Resumo**, o **Trajeto por velocidade**, as **Ocorrências** e a **Linha do tempo**.
- **Ranking de condução:** o troféu no topo da aba **Telemetria** (ou **Menu › Telemetria › Ranking de condução**). Dá a nota de cada veículo e a **Nota da frota**, para **Hoje**, **Ontem** ou **7 dias**.

> **Dica:** em frotas grandes, o ranking analisa só os veículos com atividade mais recente. A tela avisa quando isso acontece.

## Alertas

Abra a aba **Alertas**. O número vermelho no ícone conta os alertas não lidos.

- **Eventos**: os eventos das últimas 24 horas e os novos, em tempo real.
- **Filtrar por tipo** mostra só um tipo de evento. **Limpar** tira o filtro.
- Toque num evento para ver no mapa onde ele aconteceu.
- **Estatísticas**: o estado dos veículos da frota.

Para eventos mais antigos, use **Relatórios › Eventos** (veja [Relatórios](#relatorios)).

## Notificações no celular

O alerta chega como notificação mesmo com o app fechado. Tocar nela abre a tela **Notificação**, com **Título**, **Descrição** e a hora em que chegou. **Entendi** fecha.

Para receber:

1. Entre no app neste celular. É ao entrar que o celular passa a receber os alertas da sua conta.
2. Libere a permissão de **Notificações** (veja [as permissões](instalar-o-app.md#as-permissoes-que-o-app-pede)).
3. Tenha uma regra de alerta com o canal **Push** (veja abaixo).

## Regras de alerta

**Menu › Gerenciamento › Regras de alerta.**

Cada regra diz qual evento avisa e por onde:

- **Tipo de Evento**: por exemplo, **Ignição Ligada**, **Excesso de Velocidade**, **Entrada em Geocerca**, **Saída de Geocerca**, **Dispositivo Offline**, **Alarme**, **Manutenção Necessária**.
- **Tipos de Alarme**: quando o tipo é **Alarme**, escolha quais (SOS, bateria baixa, remoção e outros).
- **Canais de Notificação**: **Web**, **E-mail** e **Push** (o celular).
- **Notificar Todos os Dispositivos**: vale para todos os veículos da conta.
- **Descrição** e **Alta Prioridade** são opcionais.

> **Atenção:** usuários **Somente Leitura** não veem este item.

Mais em [Notificações e alertas](notificacoes-e-alertas.md).

## Cercas virtuais

**Menu › Gerenciamento › Cercas virtuais.**

A lista mostra as cercas e os totais de **Círculos**, **Polígonos** e **Linhas**. Para criar:

1. Toque em **+**. Abre o mapa **Adicionar Cerca**.
2. Escolha o formato: círculo, polígono ou linha.
3. Toque no mapa para marcar. A busca no topo acha um endereço, e o alvo leva até onde você está.
4. No círculo, ajuste o raio na barra (de 100 m a 10.000 m).
5. Digite o **Nome da Cerca** e toque em **Adicionar**.
6. Em **Cerca Criada!**, toque em **Sim, configurar** para calendário, limite de velocidade e veículos, ou em **Não, obrigado**.

- O polígono precisa de pelo menos 3 pontos; a linha, de 2.
- Para editar, toque na cerca: **Editar no Mapa** ou **Editar Detalhes**.

> **Atenção:** usuários **Somente Leitura** não veem este item.

Para ser avisado quando o veículo entra ou sai, crie uma [regra de alerta](#regras-de-alerta). Mais em [Cercas virtuais](cercas-virtuais.md).

## Relatórios

**Menu › Relatórios › Relatórios** (ou **Veículos ›** veículo **› Relatório**).

Escolha em **Tipos de relatórios**:

- **Rotas**
- **Playback**
- **Viagens e Paradas**
- **Eventos**
- **Resumo**
- **Arquivos** (os relatórios que você exportou)

Depois, escolha o veículo e o período no **Filtro de Relatório** e toque em **Filtrar**. O limite é o mesmo do playback: até 30 dias.

- O ícone de compartilhar, no topo do relatório, abre **Compartilhar relatório**: **Exportar para PDF** ou **Exportar para Excel**.
- **Menu › Relatórios › Rota e eventos no mapa** junta o trajeto e os eventos num mapa só.

> **Atenção:** **Agendamento de relatórios** aparece só para **Administrador** e **Gerente**. Se a central desligou os relatórios no servidor, os itens de relatório somem do **Menu**.

Mais em [Relatórios](relatorios.md).

## Manutenções

**Menu › Gerenciamento › Manutenções.**

Cada manutenção tem:

- **Nome**: por exemplo, troca de óleo ou revisão geral;
- **Tipo**: o que conta para a manutenção, como odômetro ou horas do motor;
- **Início** e **Período**: a partir de quando e de quanto em quanto ela vence.

O app não liga a manutenção a um veículo. Isso é feito no painel, em [Manutenção](manutencao.md), onde o veículo é obrigatório.

> **Atenção:** usuários **Somente Leitura** não veem este item.

Para ser avisado do vencimento, crie uma [regra de alerta](#regras-de-alerta) do tipo **Manutenção Necessária**. Mais em [Manutenção](manutencao.md).

## Motoristas

**Veículos ›** toque no veículo **› Motoristas.** Abre **Gerenciamento de Motoristas**.

- **Buscar motorista...** acha pelo nome.
- O **+** cadastra: **Nome Completo**, **ID Único (CPF/Biometria)**, data de nascimento, CNH (número, **Categoria** e vencimento), contato e endereço.
- Para ligar o motorista ao veículo: **Ajustes ›** aba **Motorista › Vincular Motorista**.

> **Atenção:** só **Administrador** e **Gerente** chegam a esta tela.

Mais em [Motoristas](motoristas.md).

## Ajustes do veículo

**Veículos ›** toque no veículo **› Ajustes** (ou **Editar**, no rodapé do painel).

- Aba **Configurações**: **Limite de Velocidade**, **Odômetro Total** e **Horímetro Total**.
- Aba **Veículo**: placa, cor, dados técnicos e dados do chip e do rastreador.
- Aba **Motorista**: o motorista do veículo.

> **Atenção:** só **Administrador** e **Gerente** veem **Ajustes**.

Mais em [Veículos](veiculos.md).

## Preferências e conta

- **Menu › Conta › Preferências** (ou toque no seu nome, no topo do **Menu**) abre **Minhas Preferências**: nome, e-mail, telefone, preferências do mapa, formato de coordenadas e localização padrão. Toque em **Salvar Preferências**.
- **Menu › Conta › Trocar Senha** muda a senha (mínimo de 6 caracteres).
- O topo do **Menu** mostra a **Expiração** da sua conta (ou **Sem expiração**).
- **Sair da conta** fica no fim do **Menu**.

> **Dica:** apareceu **Atualização Disponível** no **Menu**? A central mudou o visual ou os dados do app. Toque e escolha **Atualizar Agora**.

## Sobre e suporte

**Menu › Conta › Sobre e suporte.**

Mostra os contatos da sua central: **E-mail**, **Telefone** e **WhatsApp**, além da **Base de Conhecimento**, dos **Termos e Condições** e da **Política de Privacidade**, quando a central tem.

## Funções da gestão da central

O **Menu** também tem itens que só alguns acessos veem:

| Item | Quem vê |
|---|---|
| **Cadastro de dispositivos**, **Usuários**, **Comandos Salvos**, **Avisos aos usuários** | **Administrador** e **Gerente** |
| **Grupos**, **Calendários** | quem não é **Somente Leitura** |
| **Atributos Calculados**, **Servidor**, **Log de Auditoria** | só **Administrador** |

Veja [Usuários e permissões](usuarios-e-permissoes.md), [Grupos e organização](grupos-e-organizacao.md) e [Configurações](configuracoes.md).

---

# Usuários e permissões no Nativ — criar acessos, papéis e veículos de cada um

Fonte: https://docs.nativ.tec.br/guia/usuarios-e-permissoes/

Tudo começa em **Menu › Gerenciamento › Usuários**.

> **Atenção:** só **Administrador** e **Gerente** abrem **Usuários**. O **Gerente** vê e cria apenas os usuários dele, e só vincula os veículos que ele mesmo enxerga.

## Os papéis

O papel aparece na tela como **Função**.

| Função | Para quem | O que pode |
|---|---|---|
| **Administrador** | a equipe da central | tudo, em todas as contas |
| **Gerente** | o gestor de frota do cliente | cria e cuida dos próprios usuários e veículos |
| **Usuário** | quem acompanha a frota no dia a dia | monitora, cria cercas e alertas |
| **Somente Leitura** | quem só precisa olhar | vê, mas não altera nada |
| **Leit. Dispositivos** | quem opera sem mexer no cadastro | usa o painel, mas não edita veículos |

> **Atenção:** só o **Administrador** cria outro **Administrador** ou **Gerente**. Para o Gerente, a lista de funções mostra só **Usuário**, **Somente Leitura** e **Leit. Dispositivos**.

## O que cada papel vê no menu

Este é o padrão. O administrador pode mudar com [Presets](#presets-de-permissao).

| Itens do menu | Adm. | Gerente | Usuário | Somente Leitura | Leit. Dispositivos |
|---|---|---|---|---|---|
| Dashboard, Mapa, Simulador de rota, Veículos | sim | sim | sim | sim | sim |
| Histórico, Replay, Eventos, Relatórios, Estatísticas | sim | sim | sim | sim | sim |
| VideoTelemetria, Alertas de Vídeo, Rotas | sim | sim | sim | sim | sim |
| Câmeras, Cercas Geográficas, Notificações | sim | sim | sim | não | sim |
| Parceiros | sim | sim | não | sim | sim |
| Motoristas, Manutenção | sim | sim | não | não | não |
| Grupos, Calendários, Atributos Computados, Cockpit do Veículo | sim | sim | não | não | não |
| Abastecimento (exceto Alertas de Consumo) | sim | sim | não | não | não |
| Usuários, Configurações | sim | sim | não | não | não |
| Comandos, Comandos Salvos, Alertas de Consumo | sim | não | não | não | não |
| Config. Servidor, Config. SMS, Controle de Acesso, Logs de Auditoria | sim | não | não | não | não |

> **Atenção:** **Comandos** e **Comandos Salvos** ficam só com o **Administrador**, mesmo que um preset tente liberar.

## Criar um usuário

1. Em **Usuários**, clique em **Novo Usuário**.
2. Em **Dados Pessoais**, preencha **Nome Completo** e **Email** (obrigatórios) e o **Telefone**.
3. Em **Acesso**, deixe ligado **Definir senha no primeiro acesso**. O painel gera um link para a pessoa criar a própria senha.
4. Escolha a **Função**.
5. Se quiser, preencha o resto (veja abaixo).
6. Clique em **Criar usuário**.

A janela **Link de primeiro acesso** abre com o link e a data em que ele expira. Clique em **Copiar link** e mande para a pessoa.

> **Dica:** prefere criar a senha você mesmo? Desligue **Definir senha no primeiro acesso** e preencha **Senha** (mínimo de 6 caracteres).

### Os outros campos do cadastro

- **Válido até**: data em que a conta para de entrar. Vazio = sem validade.
- **Bloquear envio de comandos**: a pessoa não manda comandos aos rastreadores.
- **Bloquear relatórios**: a pessoa não gera relatórios.
- **E-mail fixo**: a pessoa não troca o próprio e-mail.
- **Conta Desativada**: impede a entrada.
- **Atributos adicionais**: campos livres de nome e valor.

> **Atenção:** a seção **Limites** só aparece para o **Administrador**:
> - **Limite de veículos**: `-1` = ilimitado, `0` = não pode cadastrar.
> - **Limite de usuários**: `-1` = ilimitado, `0` = não é gerente.
>
> Escolher **Gerente** muda o limite de usuários para ilimitado. Pôr `0` volta a pessoa para **Usuário**.

## Mandar um novo acesso

Use quando a pessoa perdeu o link, ele venceu ou ela esqueceu a senha.

1. Na linha do usuário, abra o menu de **Ações**.
2. Escolha:
   - **Enviar novo acesso por e-mail**: o link vai direto para o e-mail da pessoa;
   - **Gerar novo link de acesso**: o link aparece na tela para você copiar.
3. Confirme em **Trocar senha e enviar** ou **Trocar senha e gerar link**.

> **Atenção:** a senha atual da pessoa **para de funcionar na hora**. Ela só volta a entrar criando a senha nova pelo link.

Se o e-mail falhar, o painel mostra o link na tela para você mandar por outro meio.

## A lista de usuários

- Busque por nome, e-mail ou telefone e filtre por **Função**.
- Os quadros do topo contam **Total de Usuários**, **Admins / Gerentes**, **Usuários**, **Somente Leitura** e **Desabilitados**.
- A coluna **Último acesso** mostra:
  - **Acesso pendente**: o link foi gerado e ainda não foi usado;
  - **Convite expirado**: o link passou da data; mande um novo;
  - **Nunca conectado**;
  - **Há menos de 1h**, **Há 5h**, **Há 3d** e assim por diante.

## As ações de cada usuário

No menu de **Ações** da linha:

| Ação | O que faz |
|---|---|
| **Editar usuário** | muda os dados, a função e os campos do cadastro |
| **Bloquear usuário** / **Desbloquear usuário** | impede ou libera a entrada |
| **Alterar senha** | define uma senha nova (mínimo de 6 caracteres) |
| **Gerenciar veículos** | escolhe os veículos que a pessoa vê (abaixo) |
| **Excluir usuário** | apaga a conta |

Você não bloqueia nem exclui a própria conta.

## Vincular veículos a um usuário

O usuário só vê os veículos vinculados a ele, direto ou por [grupo](grupos-e-organizacao.md#grupos-de-veiculos).

1. Na linha do usuário, abra **Ações › Gerenciar veículos**.
2. Espere a lista carregar os veículos que ele já tem.
3. Busque por nome, placa ou ID e marque os veículos.
4. Para tirar um veículo, desmarque ou clique no **×** dele em **Selecionados**.
5. Clique em **Salvar — N veículo(s)**.

> **Atenção:** o que estiver desmarcado ao salvar sai da conta da pessoa.

## Entrar como usuário

O **Administrador** vê o painel exatamente como o cliente vê, sem pedir a senha dele.

1. Na linha do usuário, abra **Ações › Entrar como usuário**.
2. Confirme em **Entrar como**.
3. Uma faixa amarela no topo avisa **Você está visualizando como**.
4. Para voltar, clique em **Voltar ao Admin**.

> **Atenção:** só o **Administrador** tem essa opção, e ela não aparece para outro administrador.

## Presets de permissão

Um preset é um conjunto pronto de itens do menu liberados. Ao aplicar, ele vale para a conta da pessoa em qualquer aparelho.

### Criar um preset

1. Em **Usuários**, clique em **Presets**.
2. Abra a aba **Criar Preset**.
3. Dê um **Nome do Preset** e, se quiser, uma **Descrição**.
4. Ligue ou desligue os itens. **Liberar tudo** e **Bloquear tudo** ajudam a começar.
5. Clique em **Salvar Preset**.

### Aplicar a vários usuários

1. Marque os usuários na caixa da primeira coluna da lista.
2. Na faixa que aparece, clique em **Aplicar Preset**.
3. Em **Presets Salvos**, clique em **Aplicar a N** no preset escolhido.

A coluna **Permissões** passa a mostrar o nome do preset. **Padrão** quer dizer que a pessoa segue o papel dela.

> **Atenção:** **Presets** e **Permissões** só aparecem para o **Administrador**.

## Controle de Acesso

**Menu › Gerenciamento › Controle de Acesso** mostra as permissões em duas abas, **Empresas** e **Usuários**, com a regra:

1. **Super Admin**: acesso irrestrito a tudo;
2. **Empresa**: define o teto máximo de acesso;
3. **Usuário**: herda da empresa ou tem permissões próprias, nunca acima da empresa.

Na aba **Usuários**, escolha a pessoa, desligue **Herdar permissões da empresa** e ligue ou desligue cada item.

> **Atenção:** só o **Administrador** abre esta tela. Para que as permissões acompanhem a pessoa em qualquer aparelho, aplique-as por [Presets](#presets-de-permissao).

## Logs de Auditoria

**Menu › Gerenciamento › Logs de Auditoria** registra o que acontece no painel, como cada entrada (**Login**), saída (**Logout**) e tentativa com senha errada (**Login Falho**).

- Os quadros do topo contam **Total de Eventos**, **Eventos Hoje**, **Logins Falhos** e **Usuários Ativos**.
- Busque por usuário, ação ou IP e filtre por **Ação**, **Recurso** e período (**Hoje**, **Ontem**, **Últimos 7 dias**, **Últimos 30 dias** ou **Tudo**).

> **Atenção:** só o **Administrador** vê os Logs de Auditoria.

---

# Grupos, parceiros e categorias no Nativ — organizar a frota e os cadastros

Fonte: https://docs.nativ.tec.br/guia/grupos-e-organizacao/

Três telas organizam a central:

- **Grupos**: separar os veículos em frotas e subfrotas.
- **Parceiros**: os clientes e os fornecedores.
- **Categorias de Veículo**: o consumo esperado de cada tipo de veículo.

## Grupos de veículos

**Menu › Recursos Avançados › Grupos** mostra a **Hierarquia de Grupos**: cada grupo com os subgrupos embaixo dele.

Os quadros do topo contam **Total de Grupos**, **Grupos Raiz**, **Subgrupos** e **Veículos em Grupos**.

> **Atenção:** **Grupos** aparece para **Administrador** e **Gerente**.

### Criar um grupo

1. Clique em **Novo Grupo**.
2. Preencha o **Nome** (por exemplo, "Frota Sul").
3. Em **Grupo Pai**, deixe **Nenhum (Grupo Raiz)** ou escolha o grupo de cima, para criar um subgrupo.
4. Se quiser, escreva uma **Descrição**.
5. Clique em **Salvar**.

### Pôr um veículo no grupo

O veículo entra no grupo pelo cadastro dele:

1. Abra **Menu › Veículos** e edite o veículo.
2. Em **Detalhes**, escolha o **Grupo**.
3. Salve.

Veja mais em [Veículos](veiculos.md).

> **Dica:** passe o mouse sobre o grupo e clique no ícone de carro (**Gerenciar veículos**) para ver quais veículos estão nele.

### Dar acesso a um grupo inteiro

Em vez de vincular veículo por veículo, vincule a pessoa ao grupo:

1. Passe o mouse sobre o grupo e clique no ícone de pessoas (**Gerenciar usuários**).
2. Marque os usuários. Cada marcação já fica salva e mostra **Vinculado**.

A pessoa passa a ver todos os veículos do grupo. Para vincular veículos soltos, veja [Usuários e permissões](usuarios-e-permissoes.md#vincular-veiculos-a-um-usuario).

### Editar ou excluir

Passe o mouse sobre o grupo e use o lápis (editar) ou a lixeira (excluir).

> **Atenção:** um grupo com subgrupos não é excluído. Exclua ou mova os subgrupos antes.

## Parceiros

**Menu › Gerenciamento › Parceiros** junta **clientes** e **fornecedores** num só lugar. Os postos de combustível usados nos [abastecimentos](abastecimento-e-combustivel.md) entram aqui como fornecedores.

Os quadros do topo contam o **Total**, os **Clientes** e os **Fornecedores**.

### Cadastrar um parceiro

1. Clique em **Novo Parceiro**.
2. Escolha o **Tipo**: **Cliente** ou **Fornecedor**.
3. Preencha o **Nome** (obrigatório), o **Documento** (CPF ou CNPJ), o **Telefone** e o **Email**.
4. Em **Endereço**, digite o **CEP**: rua, bairro, cidade e UF são preenchidos sozinhos.
5. Confira o **Número** e clique em **Salvar**.

### Encontrar e cuidar dos parceiros

- Filtre por **Todos**, **Clientes** ou **Fornecedores**.
- Em **Buscar**, digite nome, documento ou e-mail.
- A chave da coluna **Status** ativa ou desativa o parceiro.
- Nos fornecedores, o ícone **Ver lançamentos** mostra os abastecimentos feitos ali: data, nota fiscal, combustível, litros, valor total, veículo e motorista.

### Quem vê cada parceiro

- O **Administrador** vê todos os parceiros da central.
- Os outros veem os que eles cadastraram e os dos usuários que gerenciam.
- Um fornecedor já usado num veículo seu também aparece, mas só para consulta: sem editar nem excluir.

> **Atenção:** **Parceiros** aparece para **Administrador**, **Gerente**, **Somente Leitura** e **Leit. Dispositivos**, e não aparece para **Usuário**. Quem é **Somente Leitura** vê, mas não altera.

## Categorias de veículo

**Menu › Abastecimento › Categorias de Veículo** define o **consumo esperado (km/L)** de cada tipo de veículo. É essa faixa que gera os **Alertas de Consumo**.

### Criar uma categoria

1. Clique em **Nova Categoria**.
2. Preencha o **Nome** (por exemplo, "Caminhão") e, se quiser, a **Descrição**.
3. Em **Parâmetros de Consumo (km/L)**:
   - **Consumo Mínimo**: abaixo disso, alerta de consumo alto;
   - **Consumo Máximo**: acima disso, alerta de economia anormal.
4. Clique em **Salvar**.

Categoria sem os dois valores aparece como **Sem limites**.

### Ligar o veículo à categoria

1. Edite o veículo em **Menu › Veículos**.
2. Em **Detalhes**, escolha a **Categoria de consumo**.
3. Salve.

O campo **Categoria de consumo** só aparece depois que existe pelo menos uma categoria.

> **Dica:** não confunda com o campo **Categoria** do cadastro do veículo: aquele escolhe o tipo (carro, caminhão, moto e outros). A **Categoria de consumo** é a desta tela.

> **Atenção:** **Categorias de Veículo** aparece para **Administrador** e **Gerente**.

Os alertas gerados por essas faixas estão em [Abastecimento e combustível](abastecimento-e-combustivel.md).

---

# Configurações do Nativ — perfil, servidor, e-mail, SMS, calendários e atributos computados

Fonte: https://docs.nativ.tec.br/guia/configuracoes/

Quem vê cada tela:

| Tela | Quem abre |
|---|---|
| **Configurações** | **Administrador** e **Gerente** |
| **Calendários** e **Atributos Computados** | **Administrador** e **Gerente** |
| **Config. Servidor** e **Config. SMS** | só o **Administrador** |

## A tela Configurações

**Menu › Gerenciamento › Configurações** (ou **Perfil** no menu da sua foto) tem duas abas:

- **Preferências**: o seu perfil, com nome, e-mail e função;
- **Servidor**: as regras gerais da central. Só aparece para o **Administrador** e traz os mesmos ajustes de [Config. Servidor](#config-servidor), mais os campos de notificações push e de SMS.

> **Dica:** para trocar entre o tema claro e o escuro, use o botão de sol ou lua no topo da tela. Veja [Conhecer o painel](conhecer-o-painel.md#o-topo-da-tela).

> **Atenção:** o e-mail de entrada não muda por aqui. Peça à central para trocar em **Usuários** (veja [Usuários e permissões](usuarios-e-permissoes.md#as-acoes-de-cada-usuario)).

## A marca da central

O painel abre com o logo, as cores e o nome da central, conforme o endereço usado (veja [Primeiro acesso](primeiro-acesso.md#o-endereco-do-painel)). O tema claro e o escuro usam as cores da marca.

O painel não tem tela para trocar a marca. Para mudar logo, cores, nome ou WhatsApp de suporte, a central fala com a Rastrear.

## Config. Servidor

**Menu › Gerenciamento › Config. Servidor** guarda as regras que valem para toda a central. Mude o que precisar e clique em **Salvar Alterações**.

### Segurança & Registro

| Opção | O que faz |
|---|---|
| **Registro Aberto** | permite a criação de novas contas |
| **Somente Leitura (Global)** | bloqueia alterações em todo o sistema |
| **Dispositivos Somente Leitura** | impede alterações nos veículos |
| **Limitar Comandos** | restringe o envio de comandos |
| **Forçar Configurações** | impede que os usuários mudem as próprias configurações |

> **Atenção:** **Somente Leitura (Global)** trava todo mundo de uma vez. Para limitar uma pessoa só, use a função dela em [Usuários e permissões](usuarios-e-permissoes.md#os-papeis).

> **Dica:** o painel não tem tela de cadastro aberto. As contas nascem em **Usuários**.

### Mapa Padrão

- **Provedor do Mapa**: o mapa que abre por padrão.
- **Latitude Padrão**, **Longitude Padrão** e **Zoom Padrão**: onde o mapa começa.
- **URL do Mapa Customizado**: endereço de um mapa próprio, quando houver.

### Email (SMTP)

É a conta de e-mail que envia as mensagens do painel, como o link de primeiro acesso e a redefinição de senha.

1. Preencha **Servidor SMTP**, **Porta SMTP** e **Segurança**.
2. Preencha **Usuário SMTP** e **Senha SMTP**.
3. Em **Remetente (From)**, o endereço que aparece para quem recebe.
4. Clique em **Salvar Alterações**.

### Forward / Webhook

Encaminha posições e eventos para outro sistema, por uma **URL de Forward**. Deixe **Formato JSON** ligado, salvo pedido do sistema que vai receber.

O mesmo cartão tem **SMS Gateway URL** e **SMS Template**. São os mesmos campos de [Config. SMS](#config-sms): prefira configurar por lá, que tem o passo a passo e o teste.

### Formato & Exibição

- **Formato 12 Horas**: mostra as horas com AM e PM.
- **Formato de Coordenadas**: **Graus Decimais (DD)**, **Graus e Minutos (DDM)** ou **Graus, Minutos e Segundos (DMS)**.

## Config. SMS

**Menu › Gerenciamento › Config. SMS** define por qual empresa de SMS saem os comandos enviados por mensagem. A mesma escolha vale nas telas **Comandos** e **Comandos Salvos** (veja [Comandos e bloqueio](comandos-e-bloqueio.md)).

1. Em **Passo 1: escolha a empresa de envio**, clique na empresa contratada pela central.
2. Leia as **Instruções** que aparecem para ela.
3. Em **Credenciais e Endpoint**, preencha o que a empresa pede: a chave, a **URL do Gateway SMS**, o **Template do Body (POST)** e o **Authorization Header**.
4. Clique em **Salvar Configuração**. O topo passa a mostrar **Configurado**.
5. Em **Validar a empresa escolhida**, digite um **Número de telefone** no formato internacional (com o código do país) e clique em **Enviar SMS de Teste**.

> **Dica:** faça o teste antes de mandar o primeiro comando por SMS. Se ele falhar, a mensagem de erro aparece na tela.

> **Atenção:** só o **Administrador** abre esta tela.

## Calendários

**Menu › Recursos Avançados › Calendários** guarda os horários de operação da frota, como horário comercial e turnos.

### Criar um calendário

1. Clique em **Novo Calendário**.
2. Dê um **Nome** (por exemplo, "Horário Comercial") e, se quiser, uma **Descrição**.
3. Escolha **Horário Início** e **Horário Fim**.
4. Em **Dias da Semana**, marque os dias (pelo menos um).
5. Confira o **Resumo** e clique em **Salvar**.

### Usar o calendário

Ligue o calendário ao veículo:

1. Edite o veículo em **Menu › Veículos**.
2. Em **Detalhes**, escolha o **Calendário**.
3. Salve.

## Atributos Computados

**Menu › Recursos Avançados › Atributos Computados** cria fórmulas próprias calculadas a partir dos dados do rastreador, como consumo médio ou "velocidade acima de 80".

### Criar um atributo

1. Clique em **Novo Atributo**.
2. Preencha **Descrição / Nome** (o nome que aparece, por exemplo "Consumo Médio").
3. Preencha **Nome do Atributo**: um nome técnico, sem espaços.
4. Escolha o **Tipo de Retorno**: **Número**, **Texto** ou **Verdadeiro/Falso**.
5. Escreva a **Expressão de Cálculo** ou clique num dos exemplos prontos: **Consumo (km/l)**, **Velocidade > 80**, **Bateria Baixa** ou **Tempo Parado (min)**.
6. Clique em **Salvar**.

A própria tela lista as **Variáveis disponíveis** e os **Operadores** que a expressão aceita.

> **Atenção:** **Disponibilizar para toda a organização** aparece para **Administrador** e **Gerente**. Desligue para escolher exatamente quais usuários veem o atributo.

### Transformar em KPI

Um atributo vira um indicador no [Dashboard](conhecer-o-painel.md#o-dashboard) e pode ir por e-mail.

1. Na linha do atributo, clique no ícone de gráfico.
2. Na janela **Transformar em KPI**, preencha o **Nome do KPI** e a **Unidade / sufixo** (por exemplo, %, km/h ou alertas).
3. Escolha a **Agregação**: **Contagem**, **Soma**, **Média**, **Mínimo** ou **Máximo**.
4. Deixe ligado **Exibir no dashboard** para o KPI aparecer em **KPIs Personalizados**.
5. Para receber por e-mail, ligue **Relatório automático por email** e escolha **Frequência**, **Período de análise** e **Hora do envio**. Ligue **Anexar PDF** se quiser o relatório também em PDF.
6. Clique em **Salvar KPI**.

- O relatório vai para o e-mail da sua conta.
- Com o envio ligado, o botão **Enviar agora** manda um relatório na hora.

---

# Perguntas frequentes sobre o Nativ

Fonte: https://docs.nativ.tec.br/guia/perguntas-frequentes/

## Acesso

### O link de acesso venceu. E agora?

Peça à central um novo. Em **Usuários › Ações**, ela usa **Enviar novo acesso por e-mail** ou **Gerar novo link de acesso**. Veja [Mandar um novo acesso](usuarios-e-permissoes.md#mandar-um-novo-acesso).

> **Atenção:** a senha atual da pessoa para de funcionar na hora em que o novo acesso é gerado.

### Esqueci a senha.

Na tela de entrada, clique em **Esqueceu sua senha?** e informe o seu e-mail. Chega o e-mail **Redefinição de senha**, com um link que vale por **2 horas**. Veja [Esqueci a senha](primeiro-acesso.md#esqueci-a-senha).

### Aparece "Sua conta está desabilitada" ou "Sua conta expirou".

- **Desabilitada:** a central bloqueou a conta.
- **Expirou:** a conta passou da data em **Válido até**.

Nos dois casos, fale com a sua central.

### O cliente não vê um veículo.

O veículo precisa estar ligado à conta dele de um destes jeitos:

- em **Usuários › Ações › Gerenciar veículos**;
- num grupo do qual o cliente faz parte (**Grupos › Gerenciar usuários**).

Veja [Vincular veículos a um usuário](usuarios-e-permissoes.md#vincular-veiculos-a-um-usuario).

### O suporte precisa ver a tela do cliente.

O administrador usa **Entrar como usuário**: vê o painel como o cliente vê, sem precisar da senha dele. Para sair, clique em **Voltar ao Admin**. Veja [Entrar como usuário](usuarios-e-permissoes.md#entrar-como-usuario).

## Mapa e histórico

### Quando o veículo aparece como Offline?

No painel, depois de **mais de 15 minutos** sem comunicar. Antes disso, ele aparece como **Em movimento** ou **Parado**. Veja [As cores do status](mapa-em-tempo-real.md#as-cores-do-status).

### Até quantos dias o app mostra de histórico?

Até **30 dias** por consulta, no playback e nos relatórios. Acima de 7 dias, o app avisa que pode demorar. A aba **Alertas** mostra as últimas 24 horas.

### Por que o Replay não mostra excessos de velocidade?

Porque o veículo não tem **limite de velocidade** no cadastro. Preencha o limite em [Veículos](veiculos.md#editar-um-veiculo), ou digite um valor no campo **Limite** do Replay e busque de novo.

## Bloqueio

### Quem pode bloquear o veículo pelo painel?

Só o perfil **Administrador**. Para os outros perfis, as telas de comandos e o botão **Comandos** do mapa não aparecem. Veja [Comandos e bloqueio](comandos-e-bloqueio.md).

### Mandei bloquear e apareceu "Comando enviado". Bloqueou?

Não necessariamente. A mensagem quer dizer que o comando saiu; o veículo bloqueia quando o rastreador recebe. Para saber quando o rastreador responder, crie uma regra **Resultado de Comando** em [Notificações e alertas](notificacoes-e-alertas.md#criar-uma-regra).

Se o app mostrar **O corte de combustível está desativado para este dispositivo.**, a central desligou o corte para aquele veículo.

## Alertas

### Não recebo alertas no celular.

Confira as três coisas:

1. Você **entrou no app** nesse celular. O celular passa a receber alertas quando você entra.
2. As **notificações** do app estão liberadas nos ajustes do celular.
3. Existe uma **regra de alerta** com o canal **Push**. Veja [Criar uma regra](notificacoes-e-alertas.md#criar-uma-regra).

### Marquei um evento como resolvido e meu colega ainda o vê ativo.

**Resolver**, na tela Eventos, fica salvo só no navegador de quem clicou. Cada pessoa vê o próprio controle.

## Compartilhar

### Por quanto tempo vale o link de compartilhamento?

Depende de onde ele é gerado:

- **No painel:** de **15 minutos a 24 horas**. O padrão é 1 hora, e dá para revogar antes. Veja [Compartilhar](compartilhar-veiculo.md).
- **No app:** até a data escolhida, no máximo **7 dias**. Veja [Usar o app](usar-o-app.md#compartilhar-a-localizacao).

Quem recebe vê o veículo sem precisar de login.

## Frota e relatórios

### Removi um veículo por engano. Dá para recuperar?

Não. Remover apaga junto as posições e os eventos. Para só parar de receber os dados, use a chave **Veículo desativado**. Veja [Remover um veículo](veiculos.md#remover-um-veiculo).

### Por que não consigo ajustar o hodômetro?

O ajuste só aparece na **edição do veículo**, e só depois que o rastreador mandou pelo menos uma posição. Veja [Hodômetro e horas de motor](veiculos.md#hodometro-e-horas-de-motor).

### Como salvo um relatório em PDF?

O botão **PDF** abre o relatório numa nova aba. Nela, use **Ctrl+P** (ou **⌘+P** no Mac) e escolha **Salvar como PDF**. Veja [Colunas e exportação](relatorios.md#colunas-e-exportacao).

### Por que nenhum alerta de consumo aparece?

O veículo precisa de uma destas duas coisas:

- uma **Categoria de consumo** com faixa de km/L;
- pelo menos **3 abastecimentos** anteriores, para a regra da média.

Veja [Alertas de consumo](abastecimento-e-combustivel.md#alertas-de-consumo).

### O app mostrou "Atualização Disponível". Preciso ir à loja?

Não. São configurações novas da central, como visual ou contatos. Toque em **Atualizar Agora**.

---

# Glossário do Nativ

Fonte: https://docs.nativ.tec.br/guia/glossario/

## Status do veículo

| Termo | O que quer dizer |
|---|---|
| **Em movimento** | o rastreador indica movimento, ou a velocidade passa de 2 km/h |
| **Parado** | comunicou há pouco e não está andando |
| **Online** | comunicando com a plataforma |
| **Offline** | no painel, mais de 15 minutos sem comunicar |
| **Bloqueado** | o rastreador informou que o motor está cortado |
| **Ignição** | se o veículo está ligado (raio amarelo) ou desligado (raio cinza) |
| **Real-time / Polling** | as posições chegam na hora / o painel busca de tempos em tempos, porque a conexão ao vivo caiu |

## Rastreador e chip

| Termo | O que quer dizer |
|---|---|
| **IMEI** | o número de identificação do rastreador |
| **ICCID** | o número do chip (cartão SIM) que fica no rastreador |
| **Telefone do chip** | o número da linha, usado para comandos por SMS |
| **GPRS / SMS** | os dois jeitos de mandar um comando: pela internet do chip ou por mensagem |
| **Satélites** | quantos satélites o rastreador usou na posição; mais satélites, posição mais precisa |

## Monitorar

| Termo | O que quer dizer |
|---|---|
| **Rastro** | a linha das últimas horas do veículo no mapa |
| **Replay / Playback** | a reprodução do trajeto num período, como um vídeo |
| **Parada** | no Replay, 90 segundos ou mais a até 2 km/h; no Rastro, 3 minutos ou mais |
| **Cerca geográfica (cerca virtual)** | uma área desenhada no mapa (polígono, círculo ou retângulo) que avisa quando o veículo entra ou sai |
| **Link de compartilhamento** | um endereço temporário para alguém ver o veículo sem login |
| **Revogar** | cancelar um link de compartilhamento antes de ele vencer |

## Alertas e comandos

| Termo | O que quer dizer |
|---|---|
| **Evento** | algo que o rastreador ou a plataforma registrou: ignição, entrada em cerca, excesso de velocidade… |
| **Regra de notificação (regra de alerta)** | o que avisar, de quais veículos e por qual canal |
| **Canal** | por onde o aviso chega: na tela (Web), Email, SMS ou Push no celular |
| **Excesso de velocidade / Limite** | passar do limite de velocidade do cadastro do veículo |
| **Comando** | uma ordem mandada ao rastreador, como bloquear ou desbloquear |
| **Comando salvo** | um comando pronto, guardado para usar de novo |
| **Corte de combustível** | o bloqueio do motor feito pelo rastreador |

## Frota

| Termo | O que quer dizer |
|---|---|
| **Hodômetro (odômetro)** | a quilometragem total do veículo |
| **Horas de motor (horímetro)** | quanto tempo o motor ficou ligado; usado em máquinas e na manutenção por horas |
| **Veículo desativado** | o veículo continua cadastrado, mas para de receber dados |
| **Válido até** | a data em que um veículo ou uma conta deixa de funcionar |
| **Categoria de consumo** | a faixa de km/L esperada para um tipo de veículo; base dos alertas de consumo |
| **km/L / KM rodado** | quilômetros por litro / quilômetros entre um abastecimento e outro |
| **Arla** | o aditivo dos motores a diesel, registrado como os abastecimentos |
| **Marcha lenta** | motor ligado com o veículo parado |
| **Força G** | as acelerações, freadas e curvas bruscas que o rastreador mede |
| **Nota de condução** | a pontuação do motorista a partir dos eventos de condução |
| **Cockpit do Veículo** | o painel de um veículo: dados de hoje, luzes, velocidade e ocorrências |

## Gestão da central

| Termo | O que quer dizer |
|---|---|
| **Central** | a empresa de rastreamento que atende você e cuida da sua conta |
| **Administrador** | vê e faz tudo, inclusive comandos e configurações da central |
| **Gerente** | o gestor de frota do cliente: cria e cuida dos próprios usuários e veículos |
| **Usuário** | acompanha a frota no dia a dia: monitora, cria cercas e alertas |
| **Somente Leitura** | só vê; não altera nada |
| **Leit. Dispositivos** | usa o painel, mas não edita veículos |
| **Preset** | um conjunto de permissões pronto, aplicado de uma vez a um usuário |
| **Entrar como usuário** | o administrador vê o painel como o cliente vê, sem a senha dele |
| **Grupo** | uma separação da frota (por cliente, filial, região…), com subgrupos |
| **Parceiro** | um cliente ou fornecedor cadastrado para os registros da frota |
| **Logs de Auditoria** | o registro de quem fez o quê no painel |

---

# Novidades do guia

Fonte: https://docs.nativ.tec.br/guia/novidades/

## 0.2.0 — 10/11/2026

- Nova página: [Rastreadores e portas](rastreadores-e-portas.md), com o endereço do servidor, as marcas mais usadas e os 266 protocolos aceitos, cada um com a sua porta.

## 0.1.0 — 10/11/2026

Primeira versão, escrita a partir do painel e do app:

- **Começando:** entrar no painel e conhecer o menu.
- **Monitorar:** mapa em tempo real, histórico e replay, cercas virtuais e compartilhamento.
- **Alertas e comandos:** notificações e bloqueio.
- **Frota:** veículos, motoristas, manutenção e combustível.
- **Relatórios.**
- **No celular:** instalar e usar o app.
- **Gestão da central:** usuários, grupos e configurações.
- **Referência:** perguntas frequentes e glossário.