Financeiro e Carteiras¶
📍 Onde fica:
Contas👤 Quem pode: Administrador, Financeiro
Cada pessoa e cada organização tem uma carteira (conta) no Airo. É nela que entram as cobranças de saltos, comissões, depósitos e ajustes. O modelo é de saldo + extrato.
Como o dinheiro entra na carteira (automático)¶
Na maior parte do tempo, você não lança nada manualmente. Quando uma decolagem pousa, o motor de cobrança gera as transações automaticamente:
- Atletas → débito do valor do produto.
- Instrutores / câmera / coach → crédito das comissões.
- Donos de avião → crédito do repasse por vaga.
- Agências → crédito da comissão de agência.
- Donos de equipamento → crédito do aluguel de rig.
- Dobradores → crédito das dobras.
Tudo isso vem da configuração de Produtos, Itens e Templates.
Ver saldos e extrato¶
- Lista de contas: todas as carteiras com saldo.
- Extrato (transações): histórico de uma conta — débitos e créditos, cada um com descrição e referência (qual decolagem/produto gerou). O saldo atual fica em destaque no topo da página; o extrato mostra só o crédito ou débito de cada lançamento (sem repetir o saldo linha a linha), pra facilitar a leitura.
- Ajustes ficam junto da transação original. Quando uma cobrança recebe um ajuste, ela não vira uma linha separada no extrato: a linha original passa a mostrar o valor final (já com o ajuste aplicado) e ganha a marca "ajustado". Clique na transação para ver o detalhe — valor original e cada ajuste, com a descrição, quem fez e a data.
Lançamentos manuais¶
Quando você precisa mexer na mão:
Adicionar crédito ou débito¶
- Crédito: ex.: o cliente fez um depósito / pagou adiantado. Ao adicionar crédito você escolhe a forma de pagamento: Dinheiro, PIX, Cartão de Crédito/Débito, Transferência Bancária ou Permuta DZ (crédito dado em troca de produtos/serviços, sem entrada de dinheiro).
- Débito: ex.: uma cobrança avulsa.
Ajuste¶
- Ajuste: correção de uma transação existente (com descrição obrigatória — fica registrado quem fez). O ajuste é sempre vinculado à transação que ele corrige: abra a transação no extrato e use Ajustar. No extrato, a original passa a exibir o valor final e o ajuste aparece no detalhe dela — não como uma linha solta.
Transferência¶
- Transferência: move saldo de uma pessoa para outra.
Tipos de transação¶
| Tipo | O que é |
|---|---|
| Crédito | Entra dinheiro na carteira (depósito, comissão) |
| Débito | Sai da carteira (cobrança de salto) |
| Ajuste | Correção manual |
🔒 Transações são imutáveis. Uma vez criada, uma transação não é editada nem apagada — ela é o registro histórico. Para corrigir, faça um ajuste ou um estorno (transação relacionada). Isso garante a auditabilidade do financeiro.
"Minhas empresas": carteiras de organização no portal¶
Uma pessoa pode estar vinculada a empresas (CNPJ) — o vínculo é feito pela DZ na edição da pessoa, na seção "Empresas (CNPJ)" (Pessoas → (pessoa)). A partir daí:
- A pessoa pode rotear seus repasses para a carteira da empresa, por template de item (ver Roteamento de repasses).
- No Portal do Atleta, a pessoa vê as carteiras das empresas vinculadas na seção "Minhas empresas" — saldo e extrato, igual à carteira pessoal.
🔒 Acesso protegido por vínculo. No portal, a pessoa só enxerga a carteira de uma organização à qual está vinculada. Tentar abrir a carteira de uma org não vinculada retorna acesso negado — o sistema nem revela se a org existe.
Mostrar saldo na operação¶
A DZ pode escolher exibir o saldo na lista de pessoas e no manifesto (configurável na Dropzone) — útil para cobrar quem está no vermelho antes de subir.
Problemas comuns¶
| Sintoma | Causa provável | Solução |
|---|---|---|
| Saldo não bate após decolagem | Decolagem não pousou, ou produto errado | Confira o status e o produto do slot; reprocesse a cobrança |
| Cobrança duplicada | (raro) | O motor é idempotente; verifique se houve dois loads. Use ajuste se necessário |
| "Não consigo editar a transação" | Transações são imutáveis | Faça um ajuste ou estorno |
| Comissão caiu na pessoa errada | Tipo de salto / agência errados no slot | Corrija o slot e reprocesse |
Para a mecânica detalhada do motor de cobrança e idempotência, ver Regras de Negócio.