Receita e Financeiro

Resumo

Painel consolidado de receita da plataforma: MRR (receita recorrente mensal), ARR, churn, LTV, cupons de desconto, reembolsos, carteira (wallet), relatórios de assinaturas, trials ativos e detalhamento por plano/tenant. Fonte única de verdade financeira para decisões estratégicas.

Para quem é (papel/role)

• super-admin - vê receita consolidada de toda a plataforma.
• tenant-admin - vê receita apenas do próprio tenant.

O que você pode fazer

Dashboard

• MRR / ARR: receita recorrente em tempo real.
• Churn rate: taxa de cancelamento por período.
• LTV: valor de vida do cliente estimado.
• New MRR / Expansion MRR / Contraction MRR: decomposição.
• Previsão de receita: projeção com base em assinaturas ativas.
• Top planos e top tenants: ranking por receita.

Cupons

• Criar cupom: código, percentual ou valor fixo, validade, limite de uso.
• Editar cupom: ajustar regras, pausar ou reativar.
• Excluir cupom.
• Listar cupons: uso, conversão, receita gerada.

Reembolsos

• Lista de reembolsos: solicitados, aprovados, pagos.
• Aprovar reembolso: integrado ao gateway correspondente.

Wallet (carteira global)

• Saldos por usuário/tenant.
• Movimentações: auditoria source-aware (ledger separado).
• Relatórios de créditos emitidos e consumidos.

Faturas e pagamentos (visão financeira)

• Faturas: emitidas, pagas, atrasadas, canceladas (ver billing-gateways.md para operação).
• Pagamentos: entradas por gateway, método, moeda.

Como acessar

1. /admin.
2. Settings → Receita ou /admin/settings/revenue.
3. Aba Dashboard para visão executiva; demais abas para detalhamento.

Tutoriais

Gerar um cupom promocional de 20% off por 30 dias

1. Acesse /admin/settings/promotions/coupons/create.
2. Código: PROMO20, tipo: percentual, valor: 20.
3. Defina validade: hoje + 30 dias, limite: 500 usos.
4. Salve e publique na página de checkout.

Analisar churn do mês

1. Acesse /admin/settings/revenue/dashboard.
2. Filtre por mês atual.
3. Observe Churn rate, Cancellations e compare com o mês anterior.
4. Cruze com Top tenants em churn para investigar.

Aprovar um reembolso

1. Em /admin/settings/revenue/refunds, selecione a solicitação.
2. Verifique motivo e valor.
3. Clique em Aprovar - o estorno é disparado ao gateway.

Monitorar saldo em carteira

1. /admin/settings/revenue/wallet mostra créditos emitidos e consumidos.
2. Use filtros por tenant/usuário para auditoria.

Integrações

• Planos - base de cálculo do MRR (planos-e-pacotes.md).
• Gateways de pagamento - origem de pagamentos e reembolsos (billing-gateways.md).
• Afiliados - comissões deduzidas do MRR (afiliados-admin.md).
• Observabilidade - alertas de queda de receita.
• Eventos: invoice.paid, invoice.overdue, invoice.created.

Perguntas frequentes

MRR inclui trials? Não. Apenas assinaturas pagas ativas compõem o MRR.

LTV é calculado como? Receita média por cliente x duração média esperada, com base em histórico.

Posso exportar os dados? Sim, o dashboard oferece exportação em CSV por período.

Cupons podem ser restritos a um plano? Sim, ao criar o cupom vincule o(s) plano(s) elegível(eis).

Reembolso parcial é possível? Depende do gateway. Para os que suportam, informe o valor parcial.

Wallet é por tenant ou por usuário? Ambos. Cada usuário tem sua wallet; o agregado por tenant também está disponível.

Como fica a receita em multimoedas? Conversão em tempo real para a moeda base da plataforma; original é preservado.

Dashboard atualiza em tempo real? Cache curto (minutos) com invalidação por eventos de pagamento.

Limitações, políticas e avisos

• Cupons não acumulam com outros cupons, salvo regra explícita.
• Reembolso acima de X dias pode exigir aprovação adicional (super-admin).
• Alterações em planos não recalculam MRR retroativamente.
• Tenant-admin nunca vê dados consolidados da plataforma.

Relacionados

• plans-and-packages.md
• billing-gateways.md
• affiliates-admin.md
• observability-logs-metrics.md