> 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 no nível de combustível ao longo de um período selecionado, incluindo eventos de abastecimento e drenagem, detalhamentos diários de consumo 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 furto de combustível ou drenagens inexplicadas junto com eventos de abastecimento, e você quiser controle direto sobre como o ruído do sensor é tratado. Ele requer mais configuração inicial (tabela de calibração, limites de drenagem, parâmetros do sensor), mas oferece visibilidade total nos dois sentidos de movimentação 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](https://navixy.com/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 traçadas ao longo do tempo ou da quilometragem, com eventos de abastecimento e drenagem marcados numericamente. Também pode exibir 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 da movimentação 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 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**: Os 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 quase certamente são ruído do sensor, e não furto 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 de referência 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 permitem cálculos de custo por trajeto, auxílio 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 na quilometragem.
* **Monitoramento de 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 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 estar 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 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 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 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 é exibido em l/100 km. O tempo constrói o gráfico em relação ao relógio e o consumo médio é exibido em l/h.
* **Informações detalhadas (por data)**: Adiciona uma tabela de detalhamento diário mostrando os volumes inicial e final 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 resumo**: Mostra apenas a página de resumo agregado, sem as abas 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 em movimento para calcular o consumo médio. Recomendado para equipamentos que frequentemente operam em marcha lenta com o motor ligado, como escavadeiras ou tratores.
* **Mostrar quilometragem**: Disponível apenas para relatórios baseados no tempo. Adiciona uma sobreposição de quilometragem ao gráfico do nível de combustível, o que ajuda a correlacionar as alterações 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, 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 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 súbitos e isolados nas leituras do sensor pelo valor mediano local. O controle deslizante determina o 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 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 sensor 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 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 consulta 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 na 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>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 a localização 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 absoluto de erro 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 no tempo ou na 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 configurações do sensor, eventos que se iniciam muito longe de um período de parada (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 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 consumido com base na taxa de consumo de referência do veículo em seu perfil do veículo. É exibido apenas quando um veículo com taxa de referência configurada está vinculado ao dispositivo GPS.</td></tr><tr><td>Consumo pela norma</td><td>A própria taxa de consumo de referência (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 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 de todo o período.

Se nenhum dado do sensor tiver sido recebido por parte de um dia, essa lacuna é marcada com um traço. Se o nível de combustível tiver mudado 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í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>O menor nível de combustível registrado naquele dia.</td></tr><tr><td>Máximo</td><td>O 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 gera 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 com base 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 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 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 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.
