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 extrato mostra só o crédito ou débito de cada lançamento, sem repetir o saldo linha a linha; o saldo aparece por dia e no resumo do período (abaixo).
Período do extrato¶
- O extrato abre nos últimos 30 dias. Para mudar, use os atalhos Hoje, Ontem, 7 dias, 30 dias, Este mês, Mês passado e Tudo, ou escolha Data Início e Data Fim livremente (escolher uma data desmarca o atalho; Tudo mostra o histórico inteiro). No celular, as datas ficam no painel de filtro (ícone de ajustes ao lado dos atalhos).
- Abaixo, os atalhos de tipo Todos, Entradas e Saídas filtram só a lista: o resumo do período e os saldos continuam mostrando a conta real.
- O período fica no endereço da página: dá para copiar o link e mandar para alguém da equipe abrir o extrato já filtrado.
Resumo do período¶
Com um período escolhido, o bloco Resumo do período mostra a conta fechada:
Saldo anterior (até o dia antes do início, ou "início da conta") + Entradas − Saídas = Saldo em dd/MM (ou Saldo atual, quando o período termina hoje). A soma sempre fecha — é a forma de explicar ao cliente de onde ele veio e aonde chegou, mesmo que ele tenha pago atrasado ou com valores quebrados.
- Quando o período termina antes de hoje, o cartão da pessoa destaca Saldo em dd/MM/yyyy (o saldo no fim daquele dia) e mostra Saldo hoje menor, ao lado.
- Sem nenhum lançamento no período aparece "Nenhum lançamento neste período", e o resumo mostra saldo anterior igual ao saldo final: a pessoa entrou e saiu do período com o mesmo saldo.
Saldo de cada dia¶
A lista é agrupada por dia: cada dia tem uma linha divisória com a data à esquerda (ex.: qui, 29/10/2026) e Saldo à direita — o saldo da carteira no fim daquele dia. Os lançamentos ficam em ordem de data da operação (a Data do pagamento informada no lançamento), não do dia em que foram registrados: um Pix pago no sábado e lançado na terça aparece no sábado, com a marca "lançado em" indicando o registro.
ℹ️ Ajuste conta na data dele. Um salto de 25/10 que recebeu desconto em 05/11 aparece na linha de 25/10 já com o valor final, mas o Saldo de 25/10 ainda conta o valor original: o desconto muda o saldo a partir de 05/11, que foi quando ele de fato aconteceu. Abra o lançamento para ver cada ajuste com a data.
Imprimir e WhatsApp¶
- Imprimir: o extrato em PDF traz o período, o bloco Saldo anterior / Entradas / Saídas / Saldo em dd/MM e as linhas de dia com o Saldo de cada um.
- WhatsApp: com um período que termina antes de hoje, a mensagem diz "Saldo em dd/MM: …" e "Saldo hoje: …"; sem filtro, continua com o Saldo atual.
Exemplo (carteira fictícia): Pix de R$ 500,00 em 20/10; salto de R$ 300,00 em 25/10; salto de R$ 420,00 em 29/10; Pix de R$ 200,00 pago em 29/10 e lançado só em 02/11; salto de R$ 150,00 em 03/11; desconto de R$ 50,00 no salto de 25/10, feito em 05/11.
| Período | Saldo anterior | Entradas | Saídas | Saldo final |
|---|---|---|---|---|
| 29/10 a 29/10 | R$ 200,00 | R$ 200,00 | R$ 420,00 | Saldo em 29/10: −R$ 20,00 |
| 01/11 a 03/11 | −R$ 20,00 | R$ 0,00 | R$ 150,00 | Saldo em 03/11: −R$ 170,00 |
| 25/10 a 25/10 | R$ 500,00 | R$ 0,00 | R$ 300,00 | Saldo em 25/10: R$ 200,00 |
| Tudo | R$ 0,00 | R$ 750,00 | R$ 870,00 | Saldo atual: −R$ 120,00 |
O Pix de R$ 200,00 entra em 29/10 (data do pagamento), mesmo lançado em 02/11. Em 25/10 a linha do salto mostra −R$ 250,00 (valor final, com o desconto), mas o saldo do dia conta −R$ 300,00: o desconto só entra em 05/11.
Ajustes no extrato¶
- 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.
- Data do pagamento: no crédito e no débito, informe o dia em que o dinheiro realmente
entrou ou saiu — por exemplo, o atleta pagou no domingo na DZ e você só lançou na terça.
Já vem preenchida com hoje; dá para escolher até 90 dias para trás (data no futuro
não é aceita). Não precisa mais anotar a data real na descrição.
- No extrato, o lançamento aparece com a data do pagamento; quando ela é de outro dia, aparece também, menor, "lançado em" com o dia e a hora do registro. O extrato é ordenado pela data do pagamento, e o saldo de cada dia a segue.
- No detalhe da transação aparecem os dois: Data do pagamento/operação e Lançado em.
- Com o módulo Financeiro, o lançamento no Financeiro usa a data do pagamento — é ela que a conciliação compara com o extrato do banco. Se o período daquela data já estiver fechado no Financeiro, o lançamento é recusado com o aviso "Período fechado até …".
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.
Crédito pago e o módulo Financeiro¶
Se a DZ tem o módulo Financeiro ativado, o crédito pago registrado na carteira também vira um lançamento no Financeiro, na conta de destino (campo Conta de destino, que aparece para quem tem acesso ao Financeiro). Ver Financeiro → Lançamentos. Sem o módulo, o crédito funciona como sempre.