5. Aeronaves¶

📍 Onde fica: Configurações → Aeronaves 👤 Quem pode: Administrador, Operacional, Financeiro 🔗 Pré-requisito: Dropzone configurada. (Organizações, se o avião tiver dono PJ.)

Cadastre a frota que vai voar. Cada decolagem usa uma aeronave, que define quantas vagas existem e ajuda a calcular combustível e horários.

Passo a passo¶

Configurações → Aeronaves.
Clique em Adicionar.
Preencha matrícula, modelo e capacidade (o nº de vagas da decolagem).
(Opcional) Defina o dono — uma Pessoa ou Organização.
(Opcional) Escolha o piloto padrão da aeronave.
(Opcional) Configure o preço de vaga pago ao dono.
Marque uma aeronave como padrão.

Campos¶

Campo	O que é	Por que importa
Matrícula	Prefixo (ex.: `PR-ABC`)	Identifica a aeronave
Modelo	Modelo da aeronave	Informativo
Capacidade máxima	Nº de vagas	Define o limite de slots por decolagem
Consumo de combustível por decolagem	—	Usado no controle de combustível
Tempo para reabastecer (min)	—	Entra no cálculo de horários
Tempo estimado de voo	—	Usado para sugerir horários de decolagem
Intervalo de combustível	Reabastecer a cada N decolagens	Marca automaticamente "precisa abastecer"
Dono	Pessoa ou Organização	Recebe o repasse por vaga
Piloto padrão	Piloto vinculado à aeronave	Ao escolher a aeronave numa decolagem, o piloto já vem preenchido
Padrão	Pré-selecionada na decolagem	—
Ativa	Inativas não aparecem na operação	—

✈️ Piloto padrão: cada aeronave pode ter um piloto associado. Quando você seleciona essa aeronave numa decolagem, o piloto correspondente é preenchido automaticamente (e continua editável). O piloto padrão é opcional e só aparecem na lista pessoas com o papel de piloto.

Modo de repasse (por vaga × por decolagem)¶

Cada aeronave tem um modo de repasse — como a DZ paga o dono:

Por vaga (padrão): paga por assento usado, com preço por vaga e overrides por produto (seções abaixo).
Por decolagem: valor fixo por voo com pelo menos 1 pessoa, independente de quantos assentos foram ocupados. Ex.: R$ 1.000 por decolagem — subir 1 pessoa custa o mesmo que subir o avião cheio. A DZ decide se compensa completar o load.

No modo por decolagem você configura o Valor por decolagem (também versionado por data, com histórico); o preço de vaga e os overrides por produto não se aplicam. O custo aparece na carteira do dono como Decolagem X/Y (pessoas a bordo / capacidade) e no relatório de repasse mantém a composição por produto/tipo de salto, mas sem a coluna de repasse por vaga — o valor é a soma das decolagens.

Faixas por ocupação (decolagem cheia × incompleta)¶

Quando o acordo com o dono muda conforme a lotação — ex.: "avião cheio paga R$ 2.250; com 13 ou 14 pessoas, R$ 2.000; com 8 a 12, R$ 1.800" — configure Faixas por ocupação, logo abaixo do valor por decolagem:

O Valor por decolagem é o valor normal (avião cheio): vale sempre que a decolagem não cair em nenhuma faixa.
Cada faixa tem De (pessoas), Até (pessoas) e o Valor da decolagem. Pessoas = quem embarcou (linhas do manifesto, sem cancelados/no-show), o mesmo número do X/Y na carteira. Vaga complementar conta.
As faixas não podem se sobrepor; buracos são permitidos de propósito. No exemplo, uma decolagem com menos de 8 pessoas não cai em faixa nenhuma e paga o valor cheio.
O "até" de uma faixa não pode passar da capacidade da aeronave (a tela mostra a capacidade como dica).

Valor por decolagem	Faixas	Pessoas a bordo	Repasse
R$ 2.250	13 a 14 → R$ 2.000 · 8 a 12 → R$ 1.800	15/15	R$ 2.250
R$ 2.250	13 a 14 → R$ 2.000 · 8 a 12 → R$ 1.800	13/15	R$ 2.000
R$ 2.250	13 a 14 → R$ 2.000 · 8 a 12 → R$ 1.800	10/15	R$ 1.800
R$ 2.250	13 a 14 → R$ 2.000 · 8 a 12 → R$ 1.800	6/15	R$ 2.250

Como editar. A tabela de faixas é editada direto na tela: altere valores, adicione ou remova linhas e clique em Aplicar a partir de com a data. O conjunto inteiro é gravado de uma vez, valendo a partir dessa data; o conjunto anterior fica no histórico (botão Ver histórico). Mudar o valor de uma faixa ou os limites entre faixas é a mesma operação, sem estado intermediário. Para remover todas as faixas, apague as linhas e aplique.

As faixas só valem para decolagens que pousarem a partir da vigência — decolagens já pousadas só mudam se forem reprocessadas. Na carteira do dono a decolagem que caiu numa faixa aparece com o sufixo Faixa 8-12.

💡 O modo é escolhido no cadastro da aeronave em Modo de repasse. Só afeta como o repasse é calculado ao pousar; a operação (vagas, pilotos, horários) é igual nos dois modos.

Preço de vaga (repasse ao dono)¶

Se a aeronave tem dono e você paga um valor por vaga a ele, configure o preço de vaga:

Aeronaves → (aeronave) → Preço de vaga.
O preço é versionado por data (vigente de / vigente até). Você pode agendar mudanças de preço no futuro sem perder o histórico.
Esse repasse só é creditado ao dono quando o produto do salto está marcado como "repassa aeronave" (ver Produtos). É a combinação das duas configurações que gera o crédito.

💡 Como o crédito acontece: ao pousar uma decolagem, para cada vaga paga cujo produto tem "repassa aeronave" ligado, o dono da aeronave recebe o preço de vaga vigente na data do manifesto.

Ajuste de vagas em lote (correção retroativa)¶

Às vezes o valor da vaga muda no meio do mês — tipicamente quando o combustível oscila — e as decolagens que já pousaram ficaram com o valor antigo lançado na carteira do dono. Em vez de corrigir decolagem por decolagem, use o Ajuste de vagas em lote:

Acesse em Aeronaves → Ajuste de vagas em lote (disponível para quem tem a permissão de ajuste em lote — em geral financeiro/admin).
Escolha o avião (um por vez; só entram os que pagam por vaga) e o período:
- Período: informe só a data inicial para uma mudança permanente (a partir dela); ou informe início e fim para uma mudança temporária — os valores voltam aos anteriores depois da data final (útil para oscilação passageira).
Aparece a tabela de rubricas do avião: a Vaga padrão e cada override de produto já cadastrado, cada uma com o valor atual e um campo novo valor. Use + adicionar produto para incluir outro produto (cria/atualiza o override dele no período). Preencha só a Vaga padrão para ajustar todas de uma vez, ou informe valores em vagas específicas. As em branco não são tocadas.
O sistema mostra uma prévia: por dono, quantas decolagens e vagas serão afetadas e o valor da diferença (R$), além de um detalhe por decolagem agrupado por data (dias exatos, com unitário antigo → novo por rubrica, no estilo do relatório de repasse). Nada é gravado até você confirmar.
Ao confirmar, os valores são atualizados no período e as decolagens afetadas são reprocessadas (com uma barra de progresso — o reprocessamento roda em blocos, então períodos grandes não travam) — cada dono recebe apenas a diferença, preservando o histórico.
Toda aplicação fica registrada no Histórico de ajustes (quem, quando, rubricas alteradas, período, e delta total), para consulta.

⚠️ Só corrige decolagens que já tinham repasse lançado (não cria repasse onde nunca existiu) e só vale para aviões por vaga. É a forma correta de tratar oscilação de preço — melhor que "dar um desconto", que bagunçaria as contas. Para reverter um ajuste, rode um novo ajuste com o valor antigo.

Repasses por produto (overrides)¶

O preço de vaga acima é o valor padrão da aeronave. Mas na prática DZs frequentemente cobram valores diferentes dependendo do produto que ocupa a vaga. Exemplos comuns:

Produto	Vende por	Repassa ao avião
Vaga 14k	R$ 250,00	R$ 215,00 (padrão)
Vaga Staff	R$ 180,00	R$ 180,00 (100% — override)
Vaga Treino	R$ 135,00	R$ 135,00 (100% — override)
Vaga praia	R$ 300,00	R$ 265,00 (override)

Pra modelar isso, configure overrides por produto dentro da própria aeronave:

Aeronaves → (aeronave) → Repasses por produto → + Adicionar override.
Para cada override: escolha o produto, o valor de repasse, e a data de início da vigência.
Cada override é versionado igual ao preço padrão — mudar o valor cria nova versão, mantendo o histórico.
Override por (aeronave + produto): se você tem mais de um avião, o mesmo produto pode ter valores diferentes em cada um (ex: Treino R$ 135 no Cessna e R$ 180 no King Air).

Resolução do valor (na hora da cobrança)¶

Quando uma decolagem pousa, para cada vaga paga com produto que "repassa aeronave":

Tem override ativo pra essa (aeronave + produto) na data do manifesto? → usa o valor do override.
Não tem → cai no preço padrão da aeronave (configurado na seção acima).
Nem padrão nem override → não gera repasse (nada é creditado).

📌 O produto precisa estar com "repassa aeronave" ligado para gerar repasse — vale tanto para o padrão quanto para o override. Override em produto sem essa flag não tem efeito.

Onde você vê o detalhamento¶

Manifesto / detalhe da decolagem → seção "Repasse pro avião" mostra cada produto, quantas vagas, valor unitário e subtotal, com um chip "override" quando aplicável.
Carteira do dono da aeronave → a transação aircraft_payback tem no metadata o by_product com o detalhamento completo.
Relatórios financeiros → agrupamento por produto disponível ao expandir a linha do repasse.

Regras importantes¶

Capacidade é o teto de vagas — não dá pra alocar mais pessoas que a capacidade na decolagem.
O preço de vaga é versionado: a cobrança usa o preço vigente na data do manifesto, não na data de hoje. Vale tanto para o padrão quanto para os overrides.
Aeronave sem dono simplesmente não gera repasse — tudo bem se você não trabalha com aviões de terceiros.
Overrides são opcionais. DZs que querem o mesmo valor para tudo continuam usando só o preço padrão.

✅ Pronto quando¶

[ ] Ao menos uma aeronave ativa com capacidade definida e marcada como padrão.
[ ] Preço de vaga configurado para aeronaves de terceiros (se aplicável).

➡️ Próximo: 6. Tipos de Salto