Exemplo prático: o produto "Tandem Completo"¶
🎯 Exemplo real, extraído de um ambiente Airo configurado. Mostra o produto Tandem Completo de ponta a ponta: como está montado, como cai no manifesto e o que o sistema lança em cada carteira quando a decolagem pousa.
💡 Este produto é um ótimo modelo porque usa todos os mecanismos do Airo de uma vez: comissões
performer, RTA por vaga, dobrador, equipamento, agência (opcional) e repasse de aeronave — e tudo via Templates de Item.
O produto¶
Configurações → Produtos → Tandem Completo
| Campo | Valor |
|---|---|
| Nome | Tandem Completo |
| Descrição | Tandem + Cam + Edição |
| Código | TANDEM-COMPLETO |
| Tipo | Salto (jump) |
| Preço | R$ 1.700,00 |
| Reservável | ✅ |
| Repassa aeronave | ✅ |
| Ativo | ✅ |
O salto de cliente é o tipo Tandem Completo (
TC), que ocupa 3 vagas na aeronave (passageiro + instrutor + câmera). Por isso os repasses "por vaga" multiplicam por 3.
Os itens (todos via Template)¶
Repare: nenhum item tem valor próprio — cada um aponta para um Template de Item, que define o destinatário, o modo de cálculo e o preço (versionado). Essa é a forma recomendada (ver regra "o template manda").
| Item | Template → Destinatário | Tipo de salto | Cálculo | Valor |
|---|---|---|---|---|
| TANDEM-PILOT | performer (instrutor) |
Tandem Pilot (TPL) |
fixo | R$ 150,00 |
| CAMERA | performer (videomaker) |
Camera (CAM) |
fixo | R$ 120,00 |
| PACK-TANDEM | packer (dobrador) |
— | fixo | R$ 35,00 |
| TANDEM-GEAR | equipment (dono do rig) |
— | fixo | R$ 130,00 |
| RTA | rta (resp. técnico) |
— | por vaga paga | R$ 5,00 / vaga |
| AGENCIA (opcional) | agency (agência) |
— | fixo | R$ 135,00 |
E, como Repassa aeronave está ligado, o dono do avião recebe o preço de vaga da aeronave usada (ex.: PT-PQD, Cessna 195 → R$ 180,00/vaga), multiplicado pelas vagas pagas.
🧩 Por que
performercom tipo de salto? O instrutor (TPL) e a câmera (CAM) entram no grupo como staff, sem produto próprio. O sistema acha cada um pelo tipo de salto do slot dele e credita a comissão. É o modelo pacote (ver Produtos, Itens e Templates).🏷️ AGENCIA é opcional: só dispara quando há uma agência marcada no slot. Sem agência, esse repasse não acontece e o valor fica com a DZ.
Como cai no manifesto¶
No Manifesto, monte um grupo com os três participantes do tandem:
| Slot | Pessoa | Tipo de salto | Produto | Pago pelo grupo? |
|---|---|---|---|---|
| 1 | Maria (passageira) | Tandem Completo (TC) |
Tandem Completo | ❌ (ela paga) |
| 2 | Paulo (instrutor) | Tandem Pilot (TPL) |
— | ✅ |
| 3 | Carla (câmera) | Camera (CAM) |
— | ✅ |
Só a Maria carrega o produto e paga; Paulo e Carla são staff e recebem comissão.
O que o sistema lança quando a decolagem pousa¶
Cálculo real do motor (1 tandem, 3 vagas, sem agência):
| Quem | Tipo | Item / origem | Conta | Valor |
|---|---|---|---|---|
| Maria (passageira) | débito | Tandem Completo | — | − R$ 1.700,00 |
| Paulo (instrutor) | crédito | TANDEM-PILOT | R$ 150 × 1 | + R$ 150,00 |
| Carla (câmera) | crédito | CAMERA | R$ 120 × 1 | + R$ 120,00 |
| Dobrador | crédito | PACK-TANDEM | R$ 35 × 1 | + R$ 35,00 |
| Dono do rig de tandem | crédito | TANDEM-GEAR | R$ 130 × 1 | + R$ 130,00 |
| RTA da decolagem | crédito | RTA | R$ 5 × 3 vagas | + R$ 15,00 |
| Dono do avião (PT-PQD) | crédito | repasse de vaga | R$ 180 × 3 vagas | + R$ 540,00 |
| DZ (o que sobra) | — | margem | — | + R$ 710,00 |
Conferência: 150 + 120 + 35 + 130 + 15 + 540 + 710 = R$ 1.700 ✅
Se a agência estivesse marcada no slot, somaria + R$ 135 à agência e a margem da DZ cairia para R$ 575.
O que esse exemplo ensina¶
- Use Templates para todos os repasses — o produto fica limpo e os valores ficam versionados num só lugar.
performer+ tipo de salto roteia comissões para o staff certo automaticamente.- Repasses "por vaga" (RTA, avião) multiplicam pelas vagas do salto (tandem = 3), não por pessoa.
Repassa aeronavedispensa um item "vaga avião": o dono do avião é creditado pelo preço de vaga configurado na aeronave.- Itens opcionais (agência) só entram quando se aplicam.
Errou algo na operação? Corrija o slot/produto e use Reprocessar cobrança — o motor é idempotente e não duplica lançamentos.
Adicionando complementos ao tandem¶
No diálogo de alocação do tandem (formulário do passageiro principal), você pode adicionar complementos (produtos service ou rental) — ex.: Edição de Vídeo ou Taxa de Parcelamento. Esses complementos ficam vinculados ao slot do passageiro (que é o "leader" do grupo).
Como aparecem depois:
- Resumo do grupo (botão "Editar Grupo" — funciona mesmo em loads finalizadas): cada complemento vira uma sub-linha
+ nome — preçodebaixo do passageiro. - Receita da decolagem (load card): o complemento entra como mais uma linha de produto, com
qtyetotal. - Detalhamento por produto do dia (
Resumo do Manifesto): a tabela "por produto" inclui o complemento como linha própria —qty=1,revenue=preço. - Detalhe da receita da decolagem (
Detalhe da Receita - Load #N): se o produto do complemento tem um item performer, gera uma linha de despesa equivalente (ex.: Edição de Vídeo R$ 125 cobrada da Maria + comissão R$ 75 para o editor).
💡 Complementos são sempre cobrados do dono do slot (Maria, no exemplo) — nunca rateados pelo grupo, mesmo se o slot estivesse marcado
paid_by_group.
📎 Mecânica detalhada (com diagramas): Motor de Cobrança (técnico).