Pular para conteúdo

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.