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

> Como registrar abastecimentos no Nativ, ler o comprovante com IA, corrigir o KM, acompanhar o km/L, os alertas de consumo e o cockpit do veículo.

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