> For the complete documentation index, see [llms.txt](https://navixy.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://navixy.com/docs/user/pt-br/guide/reports/specific-report-details/fuel-volume-report.md).

# Relatório de volume de combustível

O **Relatório de volume de combustível** fornece uma visão detalhada das variações do nível de combustível em um período selecionado, incluindo eventos de abastecimento e drenagem, detalhamentos de consumo diário e uma avaliação da qualidade dos dados do sensor. Toda a detecção de eventos é baseada nos valores de limiar configurados nas configurações do sensor de combustível, e o relatório oferece várias opções para controlar como os dados brutos do sensor são suavizados e filtrados antes da exibição.

Escolha este tipo de relatório se a sua principal preocupação for detectar roubo de combustível ou drenagens inexplicadas, juntamente com eventos de abastecimento, e se quiser controle direto sobre como o ruído do sensor é tratado. Ele exige mais configuração inicial (tabela de calibração, limiares de drenagem, parâmetros do sensor), mas oferece visibilidade total nos dois sentidos do movimento de combustível.

Para uma alternativa mais simples, sem necessidade de configuração, que se concentra em eventos de abastecimento e usa processamento automático de dados, consulte o [Relatório de volume de combustível 2.0](/docs/user/pt-br/guide/reports/specific-report-details/fuel-volume-2.0-report.md).

<figure><img src="/files/5ae3c25b582c3deb8ba3e993cc9fd354996e3438" alt="Fuel volume report"><figcaption><p>Relatório de volume de combustível</p></figcaption></figure>

O **Relatório de volume de combustível** é composto pelas seguintes seções:

1. **Gráfico de consumo de combustível**: Um gráfico das leituras do sensor de nível de combustível plotadas ao longo do tempo ou da quilometragem, com eventos de abastecimento e drenagem marcados numericamente. Também pode exibir a velocidade se **Exibir velocidade** estiver ativado.
2. **Abastecimentos e drenagens**: Uma lista de todos os eventos de abastecimento e drenagem registrados durante o período selecionado, incluindo volume, horário e localização.
3. **Tabela de detalhes por data:** Uma divisão diária do movimento de combustível, da quilometragem e dos valores de consumo.
4. **Dados estatísticos**: Níveis mínimos, máximos e médios de combustível diários e totais.
5. **Qualidade das leituras do sensor de nível de combustível:** Uma seção experimental que avalia a qualidade do sinal do sensor de combustível e fornece uma pontuação numérica e recomendações.

## Casos de uso do relatório de volume de combustível

* **Detecção de roubo de combustível**: Eventos de drenagem podem ser cruzados com os dados de localização e velocidade do veículo. Drenagens registradas enquanto o veículo está em movimento em velocidade são quase certamente ruído do sensor, e não roubo real.
* **Contabilização de custos**: O relatório calcula o consumo real de combustível por dia e por 100 km a partir das leituras do sensor. Para veículos com uma taxa de consumo normativa configurada no perfil do veículo, ele também mostra como o consumo real se compara à norma do fabricante.
* **Cálculos de depreciação e logística**: Os dados diários de consumo por veículo oferecem suporte a cálculos de custo por viagem, auxílio de combustível para motoristas que usam seus próprios veículos ou custos de combustível por unidade de trabalho.
* **Monitoramento de equipamentos:** O relatório funciona igualmente bem para equipamentos estacionários, como geradores, nos quais o consumo baseado em tempo é mais relevante do que métricas baseadas em quilometragem.
* **Monitoramento do desempenho do sensor**: A seção de qualidade fornece uma avaliação quantitativa de quão ruidoso é o sinal do sensor, ajudando a decidir se é necessário recalibrar ou inspecionar o hardware.

## Pré-requisitos para gerar o relatório de volume de combustível

Para que o relatório produza dados precisos, o seguinte deve estar configurado:

* Um sensor de nível de combustível deve estar conectado ao rastreador e transmitindo dados continuamente. Lacunas na transmissão de dados aparecerão como áreas sombreadas no gráfico.
* O sensor deve estar configurado com unidades definidas como litros ou galões. Sensores com unidades definidas como **Personalizado** não são compatíveis e exibirão uma mensagem de erro no lugar do relatório.
* Para uma detecção precisa de abastecimentos e drenagens, a tabela de calibração do sensor deve ser preenchida de acordo com as recomendações do fabricante, e os parâmetros de erro e de limiar de drenagem devem ser definidos nas configurações Avançadas do sensor.
* Para veículos com vários tanques, cada sensor físico deve ser calibrado individualmente e combinado em um sensor agregado com unidades de volume definidas como litros ou galões.

## Parâmetros do relatório de volume de combustível

* **Eixo X:** Determina o que o eixo horizontal do gráfico de combustível representa. **Quilometragem** traça o gráfico com base na distância percorrida e o consumo médio é exibido em l/100 km. Tempo **traça** o gráfico com base no tempo e o consumo médio é exibido em l/h.
* **Informações detalhadas (por data)**: Adiciona uma tabela de detalhamento diário mostrando os volumes iniciais e finais de combustível, o consumo e os totais de abastecimento e drenagem de cada dia do período do relatório.
* **Exibir resumo:** Alterna a visibilidade de uma página de resumo que mostra dados agregados de todos os dispositivos selecionados.
* **Exibir apenas o resumo**: Mostra apenas a página de resumo agregado, sem planilhas individuais dos dispositivos. Requer a seleção de pelo menos dois dispositivos.
* **Consumo baseado na ignição**: Usa dados do sensor de ignição em vez do tempo de movimento para calcular o consumo médio. Recomendado para equipamentos que ficam frequentemente em marcha lenta com o motor ligado, como escavadeiras ou tratores.
* **Exibir quilometragem**: Disponível apenas para relatórios baseados em tempo. Adiciona uma sobreposição de quilometragem ao gráfico de nível de combustível, o que ajuda a correlacionar as variações de combustível com a atividade de condução.
* **Exibir velocidade**: Adiciona uma sobreposição de velocidade ao gráfico. Útil para distinguir eventos reais de drenagem de anomalias do sensor: uma queda brusca em alta velocidade provavelmente é um falso alarme.
* **Usar filtro inteligente**: Exclui do relatório viagens curtas ou inválidas. Uma viagem regular é excluída se tiver menos de 3 pontos de dados, percorrer menos de 100 metros ou permanecer dentro de um diâmetro de 200 metros. Além disso, pontos individuais do trajeto com padrões de quilometragem suspeitos (por exemplo, velocidades implausivelmente altas ou baixas) são removidos.
* **Suavizar dados:** Aplica suavização às leituras médias do sensor no gráfico, proporcionando uma visualização mais limpa das tendências.

{% hint style="warning" %}
A suavização reduz a precisão dos cálculos de volume de abastecimento e drenagem.
{% endhint %}

* **Ignorar picos**: Aplica um filtro de mediana móvel que detecta e substitui picos ou quedas bruscas e isoladas nas leituras do sensor pelo valor mediano local. O controle deslizante define a intensidade da filtragem: mova para **Fraco** para remover apenas os outliers mais extremos, e para **Forte** para também eliminar os menores.

## Como ler o relatório de volume de combustível

### Gráfico de consumo de combustível

O gráfico exibe as leituras de nível de combustível de cada sensor plotadas ao longo do eixo selecionado. Cada sensor é mostrado como um gráfico separado. Se um sensor agregado (composto) estiver configurado, apenas os dados do sensor agregado são exibidos; os sensores componentes individuais não são mostrados separadamente.

Os eventos de abastecimento e drenagem detectados durante o período são numerados e marcados no gráfico. O marcador aparece no final do evento — quando o abastecimento ou a drenagem termina — e não no início. Os marcadores de abastecimento são exibidos em verde; os marcadores de drenagem são exibidos em vermelho. Os mesmos números aparecem na **Abastecimentos e drenagens** tabela para referência cruzada.

As áreas sombreadas no gráfico indicam intervalos em que nenhum dado foi recebido do sensor. Isso pode significar que o sensor parou de transmitir, que o dispositivo estava desligado ou que as leituras foram filtradas pela configuração Ignorar valores do sensor. Uma dica de ferramenta é exibida ao passar o mouse sobre uma área sombreada.

Ao passar o mouse sobre qualquer ponto do gráfico, são exibidos o nível exato de combustível, o status da ignição e a velocidade naquele momento. Nos gráficos baseados em quilometragem, também é exibida a distância percorrida desde o início do período.

### Tabela de abastecimentos e drenagens

Esta tabela lista todos os eventos de abastecimento e drenagem detectados durante o período do relatório.

<table><thead><tr><th width="196.22216796875">Coluna</th><th>Descrição</th></tr></thead><tbody><tr><td>Número</td><td>Número sequencial do evento, correspondente ao rótulo no gráfico.</td></tr><tr><td>Hora</td><td>Data e hora em que o evento foi registrado.</td></tr><tr><td>Abastecimento / drenagem</td><td>Tipo de evento.</td></tr><tr><td>Volume</td><td>Volume de combustível envolvido no evento, em litros ou galões.</td></tr><tr><td>Volume inicial</td><td>Nível de combustível no início do evento.</td></tr><tr><td>Volume final</td><td>Nível de combustível no final do evento.</td></tr><tr><td>Desde o início</td><td>Distância percorrida desde o início do período do relatório até este evento.</td></tr><tr><td>Endereço</td><td>Local onde o evento ocorreu. Clicar no endereço o abre no mapa. Se a localização estiver dentro de uma geocerca ou de um POI, o nome é exibido antes do endereço.</td></tr></tbody></table>

Um abastecimento é detectado quando o nível de combustível aumenta mais do que o limiar de erro absoluto definido nas configurações do sensor. Uma drenagem é detectada quando o nível de combustível diminui mais rapidamente do que o limiar de drenagem baseado em tempo ou em quilometragem especificado nas configurações do sensor — se qualquer um dos limiares for excedido, o evento é registrado.

Se a opção Ignorar reabastecimentos/drenagens em movimento estiver configurada nas definições do sensor, os eventos que começarem muito longe de um período de estacionamento (mais de X minutos antes de uma parada ou após o início de uma viagem) serão excluídos da tabela.

### Detalhes por data

Esta tabela só aparece quando **Informações detalhadas (por data)** estiver ativado. Ela fornece um resumo diário, linha por linha, dos dados de combustível para todo o período do relatório, tanto por GPS e taxa de consumo quanto por dados dos sensores de combustível.

<table><thead><tr><th width="262.888916015625">Coluna</th><th>Descrição</th></tr></thead><tbody><tr><td>Data</td><td>O dia do calendário.</td></tr><tr><td>Quilometragem</td><td>Distância percorrida nesse dia, calculada com base nos dados de GPS.</td></tr><tr><td>Consumido conforme a norma</td><td>Quantidade estimada de combustível que teria sido usada com base na taxa de consumo normativa do veículo, obtida do seu perfil de veículo. Exibido apenas quando um veículo com taxa normativa configurada está vinculado ao rastreador.</td></tr><tr><td>Consumo conforme a norma</td><td>A própria taxa de consumo normativa (por exemplo, l/100 km), obtida do perfil do veículo.</td></tr><tr><td>Volume inicial</td><td>Nível de combustível no início do dia.</td></tr><tr><td>Volume final</td><td>Nível de combustível no final do dia.</td></tr><tr><td>Consumo</td><td>Consumo real de combustível no dia: volume inicial + total abastecido − total drenado − volume final.</td></tr><tr><td>Consumo por 100 unidades (km/milhas/etc.)</td><td>Consumo real dividido pela quilometragem diária, multiplicado por 100.</td></tr><tr><td>Abastecimentos</td><td>Número de eventos de abastecimento e o volume total deles no dia.</td></tr><tr><td>Drenagens</td><td>Número de eventos de drenagem e o volume total deles no dia.</td></tr></tbody></table>

O **No total** a linha na parte inferior usa o volume inicial do primeiro dia e o volume final do último dia do período, combinados com a quilometragem total e todos os volumes de abastecimento e drenagem do período completo.

Se nenhum dado do sensor foi recebido em parte de um dia, essa lacuna é marcada com um traço. Se o nível de combustível mudou durante uma lacuna de dados, essas alterações não podem ser contabilizadas nos valores de consumo.

### Dados estatísticos

Esta tabela mostra os níveis mínimos, máximos e médios de combustível por dia e para todo o período.

<table><thead><tr><th width="153.5555419921875">Coluna</th><th>Descrição</th></tr></thead><tbody><tr><td>Data</td><td>O dia do calendário.</td></tr><tr><td>Mínimo</td><td>Menor nível de combustível registrado naquele dia.</td></tr><tr><td>Máximo</td><td>Maior nível de combustível registrado naquele dia.</td></tr><tr><td>Média</td><td>Média de todas as leituras do sensor naquele dia.</td></tr></tbody></table>

### Qualidade das leituras do sensor de nível de combustível

Esta seção experimental avalia a qualidade do sinal do sensor de nível de combustível analisando o ruído nas leituras brutas. Ela produz um Índice de Qualidade do Sensor de Combustível (FSQI), uma pontuação numérica de 1,0 a 10,0.

A pontuação se enquadra em uma de três categorias:

* **Alta (8,0–10,0)**: As leituras são altamente precisas. Os relatórios baseados nesse sensor são os mais confiáveis e fornecem informações detalhadas sobre o status do combustível.
* **Moderada (acima de 3,0 a 8,0)**: As leituras têm precisão aceitável, mas o sinal é um pouco ruidoso. Isso pode ser devido às condições de operação ou a outros fatores ambientais. Os relatórios são razoavelmente confiáveis.
* **Baixa (1,0–3,0):** As leituras têm baixa precisão devido ao ruído excessivo do sinal, o que pode indicar defeitos no sensor ou problemas de instalação. Os relatórios baseados nessas leituras apresentam um grau significativo de erro.

Se a seção informar dados insuficientes para a avaliação, as causas mais prováveis são: o período do relatório é menor que o mínimo recomendado de 14 dias de operação ativa do veículo, o intervalo de aquisição de dados é muito esparso ou a qualidade da tabela de calibração do sensor é ruim.

Para sensores compostos, a pontuação de qualidade reflete o componente com a pior pontuação, já que a precisão da leitura agregada é limitada pela sua fonte mais ruidosa.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://navixy.com/docs/user/pt-br/guide/reports/specific-report-details/fuel-volume-report.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
