> 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 mudanças no nível de combustível ao longo de um período selecionado, incluindo eventos de reabastecimento e drenagem, detalhamentos diários de consumo e uma avaliação da qualidade dos dados do sensor. Toda a detecção de eventos é baseada em valores de limite que você configura 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 sua principal preocupação for detectar roubo de combustível ou drenagens sem explicação junto com eventos de reabastecimento, e se você quiser controle direto sobre como o ruído do sensor é tratado. Ele exige mais configuração inicial (tabela de calibração, limites de drenagem, parâmetros do sensor), mas oferece visibilidade total nos dois sentidos do movimento de combustível.

Para uma alternativa mais simples, sem configuração, que se concentra em eventos de reabastecimento e usa processamento automatizado 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/f46849d7b43dd5df3d0f22bbd88c722a0a2a620c" 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 reabastecimento e drenagem marcados numericamente. Também pode mostrar a velocidade se **Mostrar velocidade** estiver ativado.
2. **Abastecimentos e drenagens**: Lista de todos os eventos de reabastecimento e drenagem registrados durante o período selecionado, incluindo volume, horário e localização.
3. **Tabela detalhada por datas:** Um detalhamento diário do movimento de combustível, da quilometragem e dos valores de consumo.
4. **Dados estatísticos**: Níveis mínimo, máximo e médio diários e totais de combustível.
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**: Os eventos de drenagem podem ser cruzados com os dados de localização e velocidade do veículo. As drenagens registradas enquanto o veículo está se deslocando em alta velocidade quase certamente são 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 com base nas leituras do sensor. Para veículos com uma taxa de consumo nominal configurada no perfil do veículo, ele também mostra como o consumo real se compara ao valor nominal do fabricante.
* **Cálculos de depreciação e logística**: Os dados diários de consumo por veículo suportam cálculos de custo por trajeto, auxílios 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, em que o consumo baseado no 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ária recalibração ou inspeção de 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 dispositivo GPS e transmitindo dados continuamente. Lacunas na transmissão de dados aparecem como áreas sombreadas no gráfico.
* O sensor deve ser configurado com unidades definidas como litros ou galões. Sensores com unidades definidas como **Personalizado** não são suportados e geram uma mensagem de erro no lugar do relatório.
* Para 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 limite de erro e 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

* **Ocultar abas vazias:** Omite abas de dispositivos que não tenham viagens em nenhum turno configurado durante o período selecionado.
* **Mostrar segundos:** Mostra as durações com precisão de segundos (`hh:mm:ss`) em vez de `hh:mm`.
* **Incluir POI no endereço do local:** Se o endereço no relatório corresponder a um POI, exibe o nome do POI antes do endereço.
* **Incluir geocerca no endereço do local:** Se o endereço no relatório corresponder a uma geocerca, exibe o nome da geocerca antes do endereço.
* **Eixo X:** Determina o que o eixo horizontal do gráfico de combustível representa. A quilometragem constrói o gráfico em função da distância percorrida e o consumo médio é mostrado em l/100 km. O tempo constrói o gráfico em função do relógio e o consumo médio é mostrado em l/h.
* **Informações detalhadas (por datas)**: Adiciona uma tabela de detalhamento diário mostrando volumes iniciais e finais de combustível, consumo e totais de abastecimentos e drenagens para 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 resumo**: Mostra apenas a página de resumo agregado sem abas individuais de dispositivo. Requer pelo menos dois dispositivos selecionados.
* **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.
* **Mostrar 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 mudanças de combustível com a atividade de condução.
* **Mostrar velocidade**: Adiciona uma sobreposição de velocidade ao gráfico. Útil para distinguir eventos de drenagem genuínos de anomalias do sensor: uma queda brusca em alta velocidade provavelmente é um falso alarme.
* **Usar filtro inteligente**: Exclui viagens curtas ou inválidas do relatório. Uma viagem regular é excluída se tiver menos de 3 pontos de dados, cobrir menos de 100 metros ou permanecer dentro de um diâmetro de 200 metros. Além disso, pontos individuais da trajetória com padrões suspeitos de quilometragem (por exemplo, velocidades implausivelmente altas ou baixas) são removidos.
* **Suavizar dados:** Aplique 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 regula o quão agressivamente ele filtra: 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, somente os dados do sensor agregado serão exibidos. Os sensores componentes individuais não são mostrados separadamente.

Os eventos de reabastecimento e drenagem detectados durante o período são numerados e marcados no gráfico. O marcador aparece no fim do evento, quando o reabastecimento ou a drenagem é concluído, e não no início. Os marcadores de reabastecimento 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. Em gráficos baseados em quilometragem, a distância percorrida desde o início do período também é exibida.

### Tabela de abastecimentos e drenagens

Esta tabela lista todos os eventos de reabastecimento 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>Tempo</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 fim 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 o local estiver dentro de uma geocerca ou POI, o nome dele é exibido antes do endereço.</td></tr></tbody></table>

Um abastecimento é detectado quando o nível de combustível aumenta mais do que o limite de erro absoluto definido nas configurações do sensor. Uma drenagem é detectada quando o nível de combustível diminui mais rápido do que o limite de drenagem baseado em tempo ou em quilometragem especificado nas configurações do sensor. Se qualquer um dos limites for excedido, o evento é registrado.

Se a opção Ignorar reabastecimentos/drenagens em movimento estiver configurada nas configurações do sensor, os eventos que começam 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) são excluídos da tabela.

### Detalhes por datas

Esta tabela só aparece quando **Informações detalhadas (por datas)** estiver ativado. Ela fornece um resumo diário linha a linha dos dados de combustível para todo o período do relatório, tanto pelo GPS e pela taxa de consumo quanto pelos 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 naquele dia, calculada com base nos dados do GPS.</td></tr><tr><td>Consumo pela norma</td><td>Quantidade estimada de combustível que teria sido usada com base na taxa de consumo nominal do veículo, definida em seu perfil do veículo. Exibido somente quando um veículo com uma taxa nominal configurada estiver vinculado ao dispositivo GPS.</td></tr><tr><td>Taxa de consumo pela norma</td><td>A própria taxa de consumo nominal (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 fim do dia.</td></tr><tr><td>Consumo</td><td>Consumo real de combustível do 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 reabastecimento e seu volume total no dia.</td></tr><tr><td>Drenagens</td><td>Número de eventos de drenagem e seu volume total 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 reabastecimento e drenagem do período completo.

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

### Dados estatísticos

Esta tabela mostra os níveis mínimo, máximo e médio 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 das 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 estado 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 ocorrer 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 relatar dados insuficientes para avaliação, as causas mais prováveis são: o período do relatório é mais curto que o mínimo recomendado de 14 dias de operação ativa do veículo, o intervalo de aquisição de dados é muito pouco frequente ou a qualidade da tabela de calibração do sensor é ruim.

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


---

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