12. Combustível¶

📍 Onde fica: Combustível (menu próprio, com o ícone de bomba de combustível). O relatório fica em Relatórios → Combustível. 👤 Quem pode: o cabeçalho das páginas mostra os perfis conforme o RBAC da sua DZ, no formato "Gerenciam: … · Visualizam: … · Veem custos: …". Padrão: Administrador e Operacional gerenciam; Financeiro visualiza e vê os custos. Ver Permissões. 🔗 Pré-requisito: Aeronaves cadastradas (para abastecer os aviões da DZ).

O módulo Combustível é o "posto" da DZ: os tanques com saldo em tempo real, as compras de combustível, os abastecimentos dos aviões (da casa e de terceiros) e um relatório completo de consumo, custo e margem.

O conceito: o posto da DZ¶

Muitas dropzones compram combustível em volume, guardam em tanque próprio e abastecem o avião ali mesmo — às vezes abastecendo também aeronaves de terceiros. O AiroDZ trata isso como um pequeno posto:

Cada tanque guarda um tipo de combustível (um catálogo da própria DZ — veja abaixo) e tem capacidade e saldo.
Cada compra sobe o estoque e vira um lote com o preço daquela compra.
Cada abastecimento desce o estoque consumindo os lotes mais antigos primeiro (custeio FIFO) — o custo registrado é o custo real do combustível que estava no tanque.
O saldo é sempre derivado dos movimentos: compras e entradas somam, abastecimentos e saídas subtraem. Não existe "editar o saldo na mão" — para corrigir, use Ajuste de estoque.

Tipos de combustível — o catálogo da DZ¶

Os tipos de combustível são um catálogo da própria DZ — cada dropzone cadastra os seus (toda DZ já começa com "Querosene (QAV-1)" cadastrado). Dois jeitos de gerenciar:

Na hora, pelo formulário do tanque: no campo Tipo de combustível, escolha ➕ Criar novo tipo… e dê o nome (ex: Jet A).
Pelo menu ⋮ do painel → Tipos de combustível: crie (Novo tipo), renomeie, ative/inative e exclua tipos.

Regras do catálogo:

Renomear não altera o histórico — movimentos e relatórios antigos continuam corretos.
Excluir só é possível se o tipo nunca foi usado. Se já tem tanque ou movimento ligado a ele, o botão avisa ("Em uso — inative em vez de excluir") — inative o tipo para tirá-lo das novas escolhas sem mexer no passado.
Não dá para criar dois tipos com o mesmo nome.

Cadastrar tanque¶

Em Combustível, na seção Tanques, clique para criar um Novo tanque:

Campo	O que é
Nome do tanque	Ex: Tanque Principal
Tipo de combustível	Escolha um tipo do catálogo da DZ — ou crie na hora com ➕ Criar novo tipo…
Capacidade	Volume máximo, em litros
Localização	Onde o tanque fica (texto livre)
Tanque principal	Marca o tanque do dia a dia — o que o Portal do Combustível destaca na tela inicial

⭐ Tanque principal: só um por DZ. Se você tem um único tanque, ele já é o principal automaticamente — não precisa marcar nada. Ao marcar outro tanque como principal, o anterior deixa de ser. No painel, o tanque principal aparece com o selo "Principal".

Tanques desativados somem da lista — use Mostrar tanques inativos para revê-los.

🔄 Trocar o tipo de combustível do tanque (situação comum quando um tanque muda de uso): só é possível com o estoque zerado — transfira ou faça um ajuste antes; senão o sistema avisa. Os lançamentos antigos não mudam: cada compra e abastecimento guarda o tipo da época.

O painel do posto¶

A tela Combustível (subtítulo "Painel do posto de combustível da dropzone") mostra um card por tanque com:

Saldo do tanque — litros atuais / capacidade;
Valor do estoque — quanto vale o combustível que está no tanque, a custo FIFO (soma dos lotes ainda não consumidos);
Custo médio do estoque — o custo real por litro do que está naquele tanque (Valor do estoque ÷ saldo). É um valor por tanque: cada tanque mostra o custo do combustível que ele de fato tem;
Custo de reposição — o preço por litro da última compra daquele tipo de combustível (quanto custaria repor agora).

💡 Por que os dois tanques mostram o mesmo custo de reposição? Porque a reposição é uma característica do tipo de combustível, não do tanque: é o preço da última compra daquele tipo, independente de em qual tanque ela entrou. Ele serve para sugerir o preço de venda (você vende ao preço de repor, não ao preço antigo). Já o custo real do que está em cada tanque é o Custo médio do estoque, calculado pelos lotes FIFO — e esse sim difere entre tanques. Exemplo: comprou 5.500 L a R$ 5,39 no Tanque Principal e depois 1.000 L a R$ 5,42 no Roper 1 → os dois mostram reposição R$ 5,42, mas o custo médio é R$ 5,39 no Principal e R$ 5,42 no Roper 1.

Abaixo dos cards, duas abas:

Movimentos — todos os lançamentos do período (Abastecimento de avião, Abastecimento avulso, Transferência (saída), Transferência (entrada), Ajuste de estoque), com as colunas Custo/L (custo por litro), Decolagem (nº da decolagem, quando o abastecimento está vinculado a uma) e Operador (quem registrou), e as ações Editar e Estornar. A coluna Data é a data do abastecimento; quando o registro foi feito em outro dia, aparece também o "Lançado em" (data em que o lançamento entrou no sistema). Um bloco destacado reúne os três números da venda: Venda (valor total), Venda/L (preço por litro cobrado) e Margem (% sobre o custo real, em vermelho quando negativa) — Venda e Venda/L aparecem para quem vê o módulo; a Margem só para quem tem a permissão financeira;
Compras — as compras registradas no período.

Nos filtros da aba Movimentos há também o Vínculo, que separa os abastecimentos ligados a decolagens dos avulsos: Todos, Só de decolagem ou Só fora de decolagem.

As ações ficam nos botões Abastecer avião, Abastecimento avulso e, em Mais ações: Compra, Transferência e Ajuste de estoque. O menu ⋮ do painel dá acesso a Tipos de combustível e à Política de venda.

Registrar compra¶

Use Mais ações → Compra (diálogo Compra de combustível): informe Litros, Preço por litro (o Total é calculado), Fornecedor e Nota fiscal. O estoque do tanque sobe na hora.

📦 Cada compra vira um lote. O lote guarda os litros e o preço daquela compra — é ele que alimenta o custeio FIFO abaixo.

🚀 Começando a usar com o tanque já cheio? Lance o saldo inicial como Compra (nunca como ajuste, que entraria sem custo): meça o tanque na régua, informe os litros medidos e o preço/litro real da nota original — pode referenciar a NF mesmo que o volume lançado seja parcial, ou anotar "Saldo inicial" nas observações. Se o estoque veio de compras a preços diferentes, lance uma compra por lote, nas datas reais — o FIFO nasce fiel ao que foi pago.

Custeio FIFO — de onde vem o custo¶

Quando um avião é abastecido, o AiroDZ consome os lotes mais antigos primeiro (First In, First Out):

O custo registrado no abastecimento é o custo real do combustível que estava no tanque — se os 200 L saíram parte de um lote a um preço e parte de outro, o custo reflete exatamente essa mistura.
O sistema rastreia qual compra supriu cada litro de cada abastecimento.
O Valor do estoque do card é a soma do que resta em cada lote, ao preço de cada um.
Um estorno devolve os litros aos mesmos lotes de onde saíram — o estoque e o custo voltam a ser o que eram.

Composição do estoque (o que tem dentro do tanque)¶

Quer saber de quanto foi cada compra que ainda está no tanque? No card do tanque, use o menu ⋮ → "Composição do estoque" — ou clique direto na barra de nível do tanque.

O diálogo mostra:

uma barra empilhada com uma faixa por preço pago — bate o olho e você vê quanto do tanque é combustível caro e quanto é barato;
a lista em ordem de consumo (FIFO) — o primeiro da lista é o próximo a ser consumido — com preço por litro, litros, % do tanque, valor, data e o fornecedor / nota fiscal, quando houver;
no rodapé, o total, o custo médio e o custo de reposição.

🔒 Como é informação de custo, o diálogo só aparece para quem tem a permissão financeira do combustível ("Veem custos") — ver Permissões.

⚠️ Não dá para abastecer de um tanque sem compra registrada ("Não há preço de compra registrado para este tanque — registre uma compra antes") nem além do saldo ("Saldo insuficiente no tanque para esta operação"). Uma compra também não pode exceder a capacidade do tanque.

Política de venda¶

Cada tipo de combustível pode ter uma Política de venda, que gera o Preço sugerido nas vendas:

Modo	Como calcula
Markup (%)	Percentual sobre o preço da última compra — o sugerido acompanha o custo de reposição
Preço fixo	Valor fixo por litro, independente do custo

Fica no menu ⋮ do painel → Política de venda — acessível apenas para quem tem a permissão financeira do combustível (por padrão, Administrador e Financeiro): a lista mostra cada tipo com o modo, o valor e o "Preço sugerido hoje: R$ X/L", com edição por tipo. No Abastecimento avulso o preço sugerido continua vindo preenchido para quem opera (sem expor a política em si).

Abastecer avião (aeronave da DZ)¶

O diálogo Abastecer avião pede o tanque, a aeronave, os Litros, o Horímetro (leitura opcional, melhora o relatório de horas voadas), uma Observação (opcional) e o Preço de venda — que é opcional e abre sempre em branco (não há sugestão aqui):

💡 "Deixe em branco para precificar depois, no fechamento do mês." — o abastecimento fica marcado como "A precificar" e entra no Fechamento do mês, que é onde a precificação do avião da DZ acontece (lá sim, com preço sugerido). A sugestão automática na hora de abastecer existe só no Abastecimento avulso, que é venda imediata a terceiros.

Há três caminhos para registrar:

1. Pelo painel do posto¶

Botão Abastecer avião na tela Combustível — escolha a decolagem (opcional) para vincular o abastecimento ao voo.

🗓️ Data do abastecimento × data do lançamento. Se o abastecimento estiver vinculado a uma decolagem e você não informar data/hora, ele assume o horário da decolagem menos 3 minutos (o abastecimento acontece pouco antes de decolar) — mesmo que o lançamento seja feito no dia seguinte. O campo é editável, então dá para ajustar para o horário real. A data em que o registro entrou no sistema fica guardada à parte ("Lançado em").

2. Pelo card da decolagem no manifesto¶

Cada card de decolagem no manifesto tem o botão Abastecer avião. Depois de registrado, o card mostra um selo com os litros ao lado do ícone de bomba (ex: "120 L") — ao passar o mouse, o tooltip detalha ("Abastecido: 120 L"). Pelo mesmo card dá para Editar abastecimento se o registro saiu errado.

3. Pelo diálogo "Abastecidas do dia" (várias de uma vez)¶

No manifesto, o diálogo Abastecidas do dia lista as decolagens do dia com aeronave definida. É só digitar os litros nas linhas abastecidas — a linha que recebe um valor fica ativa para o lançamento (o campo mostra o consumo médio do avião como dica, ex.: "ex.: 120"). Desmarcar uma linha limpa os litros; o botão Limpar zera o grupo do avião. Confirme tudo de uma vez com Aplicar. Dá para incluir também uma linha avulsa (sem decolagem) com Adicionar linha avulsa, para um abastecimento que não pertence a nenhum voo.

🔁 Planejado × realizado. A flag "Precisa abastecer" da decolagem (usada no planejamento do dia e no cálculo de turnaround) continua independente do registro de abastecimento. O card pode mostrar os dois lado a lado: o planejado ("Precisa abastecer") e o realizado (o selo com os litros).

🧑‍🔧 Tem alguém dedicado ao abastecimento no pátio? Existe também o Portal do Combustível — um portal de celular onde a pessoa com a função Abastecedor registra os litros de cada decolagem em dois toques, sem ver custos nem preços. Ver Portal do Combustível.

Sem aeronave? Registre mesmo assim e atribua depois¶

Fora do contexto de uma decolagem, a aeronave é opcional: escolha "Sem aeronave (avulso)" quando o avião não está no cadastro ou quando só interessa registrar os litros que saíram do tanque — o horímetro some (ele é do avião). O abastecimento entra na fila "A precificar" como qualquer outro e aparece na lista de Movimentos como Sem aeronave · A atribuir.

Depois, o administrador diz quem paga: a ação Atribuir a pessoa/empresa (ícone de pessoa com +) está na tabela de Movimentos e na tela de Fechamento do mês (coluna Cliente). Escolha a pessoa ou organização; a cobrança acontece no fechamento, na carteira dela. A atribuição pode ser trocada ou removida enquanto o abastecimento ainda está "A precificar"; depois de precificado, a correção é por estorno + relançamento, como sempre. Dá para atribuir também um abastecimento com aeronave — nesse caso o cliente atribuído tem prioridade sobre o dono do avião na hora de cobrar.

Errou os litros? É só corrigir¶

Digitou errado? Use Editar na tabela de Movimentos do painel, ou Editar abastecimento no card da decolagem do manifesto. A lista mostra uma linha só, com os valores finais e o selo "Alterado" — por baixo, o lançamento original e o estorno ficam preservados no histórico (nada some, nada é sobrescrito).

Abastecimento avulso (aeronave de terceiros)¶

Para vender combustível a uma aeronave que não é da DZ, use Abastecimento avulso: informe o Cliente (pessoa ou organização) e/ou a Matrícula / descrição da aeronave (ex: PR-XYZ) — pelo menos um dos dois — os Litros e o Preço de venda, que aqui é obrigatório (já sugerido pela política de venda). É uma venda na hora: não existe "a precificar" para terceiros.

Transferência, ajuste e estorno¶

Transferência entre tanques — move litros de um Tanque de origem para um Tanque de destino. Só entre tanques com o mesmo tipo de combustível; o custo dos lotes é preservado na mudança.
Ajuste de estoque — corrige o saldo após uma conferência física: Sobra aumenta, Perda reduz (o ajuste não pode ser zero).
Estornar — na aba Movimentos, qualquer lançamento pode ser estornado: um lançamento inverso é criado e, no caso de abastecimento, os litros voltam aos mesmos lotes FIFO. O movimento fica marcado como "Estornado" e não pode ser estornado duas vezes.

Fechamento do mês¶

Muitas DZs acertam o combustível com o dono do avião uma vez por mês. Para isso, os abastecimentos deixados "A precificar" se acumulam e o painel avisa ("N abastecimento(s) aguardando precificação", com o atalho Ir para fechamento do mês).

Na tela Fechamento do mês:

Escolha o período — a tela lista os abastecimentos pendentes de precificação, com as colunas Cliente (a pessoa/empresa atribuída, com a ação Atribuir a pessoa/empresa na própria linha), Custo/L, Load (a decolagem vinculada, quando houver) e Operador (quem registrou). Use o filtro Vínculo para fechar em partes: Todos, Só de decolagem (a operação da DZ) ou Só fora de decolagem (os avulsos) — assim dá para fazer um fechamento da operação e outro dos avulsos, com preços diferentes. No filtro de Aeronave, a opção Sem aeronave isola os abastecimentos registrados sem avião, que normalmente ainda precisam ser atribuídos;
Selecione os movimentos — o campo R$/litro já vem preenchido com o preço sugerido inteligente: um preço único que cobre o custo real (FIFO) de cada abastecida selecionada mais a margem da política de cada tipo (tipos sem política entram pelo custo; o valor é arredondado para cima — misturar combustíveis de custos diferentes nunca sugere prejuízo). O ícone ℹ️ abre o detalhe do cálculo (litros, política, custo e receita-alvo por tipo).
A partir da sugestão, ajuste como preferir — os três campos são ligados e recalculam entre si na hora:
- Margem (%) — percentual sobre o custo real da seleção (ex.: 15%, 20%);
- R$/litro — o preço por litro;
- Valor total — o valor fechado na negociação (ex.: "fechei R$ 5.000").
Confira a Receita prevista e a Margem em R$ e % atualizando ao vivo, e clique em Aplicar preço;
No diálogo de confirmação, escolha o desfecho:
- Gerar receita — aplica o preço e escolhe de quem cobrar:
  - Cliente atribuído ou Dono do avião — vem pré-selecionado quando todos os abastecimentos escolhidos resolvem para a mesma pessoa/empresa (o cliente atribuído tem prioridade; senão, o dono do avião); o total é debitado da carteira dela (o arranjo "o avião recebe repasse por vaga, mas compra o combustível da DZ"). Se a seleção mistura pagadores diferentes, a tela avisa — feche em partes ou escolha uma conta;
  - Outra conta — qualquer pessoa/organização com carteira;
  - DZ (sem cobrança) — registra a precificação, nenhuma carteira é debitada.
- Consumo interno (sem receita) — a DZ consumiu o próprio combustível: nada de receita nem cobrança; fica registrado apenas o custo de cada abastecimento (as linhas saem da fila "A precificar" com o selo Consumo interno).

⚠️ Se o débito na carteira falhar após os preços serem aplicados, o sistema avisa — os abastecimentos ficam precificados e o lançamento na carteira deve ser feito manualmente.

Pronto: a receita do mês fica calculada de uma vez, espelhando o acerto mensal com o dono do avião. A receita é informativa (aparece no relatório; nada é lançado em carteira ou caixa). Um movimento já precificado não pode ser precificado de novo.

Relatório de Combustível¶

Em Relatórios → Combustível, o relatório Consumo de Combustível mostra, por período, com filtros por tanque, avião e tipo de combustível e agrupamento por Dia, Tanque ou Avião:

Coluna	O que é
Data	Dia do abastecimento
Litros	Volume abastecido
Horas voadas	Horas do avião no dia (ver fonte abaixo)
Média L/H	Litros por hora voada
R$/L (custo)	Custo FIFO por litro
Custo/hora	Custo por hora voada
Custo total	Custo FIFO do abastecimento
R$/L venda · Receita · Margem	Lado da venda (receita − custo)
Margem %	A margem em percentual sobre o custo real do abastecimento (mesma conta do fechamento do mês e da lista de movimentos)

As horas voadas vêm da melhor fonte disponível, nesta ordem: horímetro (diferença entre leituras) → loads voados (tempo de voo das decolagens do mesmo dia do abastecimento) → intervalo no dia (relógio entre o primeiro e o último voo). Nunca gera intervalo negativo, e voos de dias anteriores sem abastecimento registrado não são atribuídos a um abastecimento posterior.
Os totais separam próprio × terceiro (aviões da DZ × abastecimento avulso), e o indicador A precificar mostra o que ainda está sem preço.
A Margem % aparece também nos totais de cada grupo e do período, no card de Margem do topo (o percentual em letra menor, abaixo do valor), no CSV e na impressão/PDF. Nos totais, a base do percentual é o custo apenas dos abastecimentos já precificados — assim o que ainda está "A precificar" não distorce o número.
As colunas de custo e margem (inclusive a Margem %) só aparecem para quem tem a permissão financeira do relatório (ver Permissões); sem ela, o relatório continua mostrando litros, horas e receita.
Exporta CSV e tem Imprimir / PDF.

Permissões¶

O cabeçalho das páginas Combustível e Fechamento do mês mostra quem tem acesso conforme o RBAC da própria DZ — se você ajustar os perfis na tela de Acessos (RBAC), a linha acompanha. O formato é "Gerenciam: … · Visualizam: … · Veem custos: …".

Veem custos é uma permissão à parte — a parte financeira do combustível. É ela que libera o lado do custo: custo por litro (Custo/L), custo total, Valor do estoque, Custo médio do estoque, Custo de reposição, a Composição do estoque e a Margem. Quem não a tem usa o módulo normalmente (registra compras, abastece, fecha o mês), mas sem ver esses valores — nas telas de Combustível e Fechamento do mês e também nas colunas de custo/margem do relatório (que têm permissão própria). O preço de venda continua visível para todo mundo que vê o módulo — quem vende precisa do preço; por isso Venda e Venda/L aparecem para todos, e só a Margem fica restrita.

Padrão de fábrica (ajustável na tela de Acessos):

Perfil	O que pode
Administrador	Tudo, sempre — inclusive custos e margem
Operacional	Opera o posto (tanques, compras, abastecimentos, fechamento) sem ver os custos
Financeiro	Visualiza o painel, vê os custos e o relatório completo
Demais perfis	Não veem o módulo

⚠️ Aviso regulatório (ANP)¶

Abastecer a aeronave própria com combustível comprado pela DZ é consumo próprio. Já vender combustível a aeronaves de terceiros é revenda — atividade regulada pela Resolução ANP 936/2023, com regras próprias de autorização e controle de qualidade.

O AiroDZ separa os dois tipos de operação (abastecimento de avião da DZ × abastecimento avulso) justamente para essa prestação de contas — mas a regularização junto à ANP é responsabilidade da DZ. Se você vende combustível a terceiros, informe-se sobre as exigências aplicáveis.

✅ Pronto quando¶

[ ] Tipos de combustível da DZ cadastrados (além do "Querosene (QAV-1)" que já vem pronto, se usar outros).
[ ] Tanques cadastrados com tipo de combustível e capacidade.
[ ] Primeira compra registrada em cada tanque (sem compra, não dá para abastecer).
[ ] Política de venda definida para os tipos que a DZ vende a terceiros.
[ ] Equipe orientada sobre os três caminhos de registro (painel, card da decolagem, Abastecidas do dia).