> 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

Analise mudanças no nível de combustível com o relatório Volume de combustível. Detecte eventos de reabastecimento e drenagem, revise o consumo diário e avalie a qualidade do sensor.

O **relatório de Volume de combustível** fornece uma visão detalhada das alterações do 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 nos 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 roubo de combustível ou drenagens sem explicação, 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 fornece visibilidade total em ambas as direções do movimento de combustível.

Para uma alternativa mais simples, sem configuração, que se concentra nos 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="https://1308974401-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F446mKak1zDrGv70ahuYZ%2Fuploads%2Fgit-blob-3407e54dc3bb08188bf83c676bf8abcb0680b1d7%2Fimage.png?alt=media" 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 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 local.
3. **Tabela de detalhes por data:** Um detalhamento diário do movimento de combustível, quilometragem e 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 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 roubo de combustível**: Eventos de drenagem podem ser cruzados com dados de localização e velocidade do veículo. Drenagens registradas enquanto o veículo está em movimento em alta velocidade são quase certamente ruído do sensor, e não roubo real.
* **Apuraçã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 padrão configurada no perfil do veículo, ele também mostra como o consumo real se compara ao padrão do fabricante.
* **Cálculos de depreciação e logística**: Os dados diários de consumo por veículo dão suporte a 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 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ária recalibração ou inspeção do 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 têm suporte 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 de 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

* **Ocultar abas vazias:** Omite as abas de dispositivos que não têm viagens em nenhum turno configurado durante o período selecionado.
* **Mostrar segundos:** Mostra 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 relação à distância percorrida e o consumo médio é mostrado em l/100 km. O tempo constrói o gráfico em relação ao relógio e o consumo médio é mostrado em l/h.
* **Informações detalhadas (por data)**: 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 somente o resumo**: Mostra apenas a página de resumo agregado, sem as abas individuais dos dispositivos. 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 do nível de combustível, o que ajuda a correlacionar as 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 reais de drenagem de anomalias do sensor: uma queda acentuada 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 de rastreamento individuais com padrões suspeitos de quilometragem (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 súbitos e isolados nas leituras do sensor pelo valor mediano local. O controle deslizante determina quão agressiva é a filtragem: mova-o para **Fraco** para remover apenas os valores discrepantes mais extremos, em direção a **Forte** para também eliminar os menores.

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

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

O gráfico exibe as leituras do 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 abastecimento e drenagem detectados durante o período são numerados e marcados no gráfico. O marcador aparece no fim 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.

Á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 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, correspondendo 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 é 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 abastecimentos/drenagens em movimento estiver configurada nas definiçõ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 um trajeto) sã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 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 de GPS.</td></tr><tr><td>Consumido pela norma</td><td>Combustível estimado que teria sido usado com base na taxa de consumo padrão do veículo em seu perfil de veículo. Exibido somente quando um veículo com uma taxa padrão configurada estiver vinculado ao dispositivo GPS.</td></tr><tr><td>Consumo pela norma</td><td>A própria taxa de consumo padrão (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 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 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 mudanças não podem ser contabilizadas nos cálculos 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>O nível de combustível mais baixo registrado naquele dia.</td></tr><tr><td>Máximo</td><td>O nível de combustível mais alto 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)**: Leituras altamente precisas. Os relatórios baseados neste 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 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 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 informar 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 aquisição de dados é muito espaçado 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 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.