Financeiro SaaS: faturas e cobrança

Menu: Super Admin → Financeiro

Esta é a área onde você (dono do Coopop) gerencia o dinheiro que recebe dos tenants. Não confundir com o módulo Financeiro que cada tenant usa para a empresa dele.

Dashboard

Mostra receita do mês, contas a receber, atrasos e gráfico dos últimos 6 meses. Tenants em atraso aparecem em destaque.

Faturas

Como são geradas

Automaticamente (cron financeiro_saas.php) ou manualmente pelo botão Gerar faturas do próximo mês.

Regra da geração automática:

• Para cada tenant com status = 'ativo' e valor_mensal > 0


• Gera a fatura do próximo mês quando faltam dias_gerar_antes ou menos para o vencimento


• Idempotente: nunca duplica (unique key tenant_id, competencia)

Configurável em config/faturamento.php:
BLOCK0

Estados da fatura

BLOCK1

Ações

Na tela de detalhe:

• Receber pagamento — informa valor, data, método, conta e (opcional) comprovante. Cria automaticamente uma entrada em sa_movimentacoes.


• Reverter pagamento — volta para pendente e remove o movimento


• Cancelar fatura — marca como cancelada (com motivo)


• Enviar cobrança por email — manual ou pelos tipos: lembrete, vencimento_hoje, atraso_3d/7d/15d

Notificações automáticas

Configuráveis em config/faturamento.php:

BLOCK2

O cron envia cada tipo uma única vez por fatura (idempotente — verifica na tabela sa_notificacoes).

E-mail destinatário: o primeiro usuário admin ativo do banco do tenant. Fallback: e-mail do responsável do convite original.

Movimentações

Menu Financeiro → Movimentações. Registros de entrada e saída do seu caixa:

Entradas

• Mensalidade (automática ao receber fatura)
• Implantação, Serviços avulsos, Outros

Saídas (manuais)

• Infraestrutura, Serviços de terceiros, Marketing, Impostos, Folha/pró-labore, Outros

Cada movimento pode ser vinculado a:

• Uma conta bancária
• Um tenant (opcional — útil para rastrear despesas por cliente)
• Um anexo (comprovante)

Contas bancárias

Menu Financeiro → Contas. Cadastre todas as contas onde o SaaS recebe/paga. Marque uma como padrão de recebimento — ela fica pré-selecionada ao receber faturas.

Saldo = saldo_inicial + soma(entradas) − soma(saídas) automaticamente.

Relatórios

Menu Financeiro → Relatórios. Filtro por período, mostra:

• Fluxo de caixa (entradas × saídas por categoria)


• Receita paga por segmento de tenant


• Lista de inadimplentes

Cron no servidor

O script scripts/cron/financeiro_saas.php roda diariamente. No crontab:

BLOCK3

Faz três coisas:

1. Marca faturas vencidas como atrasada


2. Gera faturas do próximo mês


3. Dispara notificações conforme regras

Para começar

1. Em Contas, confirme que a conta padrão está configurada
2. Verifique se valor_mensal e dia_vencimento estão corretos nos tenants (menu Tenants)
3. Clique em Gerar faturas do próximo mês uma vez para popular a primeira rodada
4. Configure o cron para automatizar daqui em diante