> 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 **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 abastecimento e drenagem, detalhamentos diários de consumo de combustível 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 nível 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 furto de combustível ou drenagens inexplicadas juntamente com eventos de abastecimento, 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 em ambos os sentidos do movimento de combustível.

Para uma alternativa mais simples, sem configuração, que se concentra em eventos de abastecimento 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>de Volume de combustível</p></figcaption></figure>

O **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 mostrar a velocidade se **Mostrar 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:** Um detalhamento diário do movimento de combustível, da quilometragem e dos valores de consumo.
4. **Dados estatísticos**: Valores mínimos, máximos e médios diários e totais do nível 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 nível 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 furto 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 alta velocidade quase certamente são ruído do sensor, e não furto real.
* **Contabilização de custos**: O relatório calcula o consumo de combustível real por dia e por 100 km com base nas leituras do sensor. Para veículos com uma taxa de consumo normatizada 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 de consumo diário por veículo apoiam cálculos de custo por trajeto, subsídios 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 alto é o ruído do 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 ser 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 exibem uma mensagem de erro no lugar do relatório.
* Para uma detecção precisa de abastecimento e drenagem, 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 limite 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** constrói o gráfico com base na distância percorrida e o consumo médio é exibido em l/100 km. Tempo **constrói** o gráfico com base no relógio e o consumo médio é exibido em l/h.
* **Informações detalhadas (por data)**: Adiciona uma tabela de detalhamento diário que mostra 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 que pelo menos dois dispositivos sejam 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 no 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 trajetos curtos ou inválidos do relatório. Um trajeto regular é excluído 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 de rastreamento 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 visã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 súbitas e isolados nas leituras do sensor pelo valor mediano local. O controle deslizante regula quão agressivamente ele filtra: mova-o em direção a **Fraco** para remover apenas os valores discrepantes mais extremos, e em direção a **Forte** para eliminar também os menores.

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

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

O gráfico exibe 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 é concluído, 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 cursor sobre uma área sombreada.

Ao passar o cursor sobre qualquer ponto do gráfico, são mostrados 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 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>Horário</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 POI, o nome dela é 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 rapidamente 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, eventos que começam longe demais de um período de estacionamento (mais de X minutos antes de uma parada ou após o início de um trajeto) são excluídos da tabela.

### Detalhes por data

Esta tabela só aparece quando **Informações detalhadas (por data)** está ativado. Ela fornece um resumo diário linha a linha dos dados de combustível para todo o período do relatório, tanto por GPS e 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>Consumido pela norma</td><td>Quantidade estimada de combustível que teria sido usada com base na taxa de consumo normatizada do veículo em seu perfil do veículo. Mostrado apenas quando um veículo com taxa normatizada configurada está vinculado ao dispositivo GPS.</td></tr><tr><td>Consumo pela norma</td><td>A própria taxa de consumo normatizada (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 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 abastecimento 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 no final 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 durante 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 mudanças não podem ser consideradas 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 o período completo.

<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édio</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 Nível 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 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 se dever à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 a ruído excessivo no 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 é menor que o mínimo recomendado de 14 dias de operação ativa do veículo, o intervalo de coleta de dados é pouco frequente demais ou a qualidade da tabela de calibração do sensor é ruim.

Para sensores agregados, 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 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.
