A receber e como cobrar bem

Onde a conta a receber nasce

Toda comanda paga depois (fiado, parcelado, faturamento mensal) gera um receivable no A7X. Ele aparece em:

Financeiro → A Receber

Cada linha tem:

• Cliente
• Valor
• Vencimento
• Competência (mês contábil — não é a data do pagamento)
• Status: pending, paid, partially_paid, overdue, cancelled

Competência ≠ pagamento

O A7X separa rigorosamente:

Conceito	O que é	Onde aparece
Competência	Mês contábil em que a receita é “ganha” (entrega)	DRE, indicadores
Vencimento	Quando o cliente deve pagar	Cobrança, alertas
Pagamento	Quando o dinheiro caiu	Conciliação bancária, fluxo de caixa

Cliente recebeu peça em 25/04, vence em 15/05, pagou em 18/05? Compete a abril. Vence em maio. Caiu em maio. Tudo registrado separado.

Disparar cobrança por e-mail

Cada receivable tem um botão Enviar e-mail. O A7X então:

1. Monta e-mail profissional (template HTML A7) com:
   • Detalhes da fatura
   • Anexo PDF (se houver)
   • Botão verde 🔓 Acessar Portal do Cliente
2. Gera magic link Supabase Auth vinculado ao e-mail do cliente
3. Envia via Resend de financeiro@a7lavanderia.com.br
4. Registra envio em email_dispatch_log
5. Webhook do Resend atualiza status: sent → delivered → opened → clicked

A mágica do magic link

Quando o cliente clica no botão do e-mail, entra direto no Portal do Cliente — sem precisar fazer cadastro, sem digitar OTP, sem senha.

O Supabase Auth valida o link, cria sessão, e o A7X liga o auth user à ficha de cliente automaticamente (RPC bind_portal_client_by_email).

Se o link expirar (1h), o cliente cai na tela de OTP normal — UX um pouco pior, mas funcional.

Tracking automático

O painel mostra pra cada e-mail:

• ✅ Entregue (delivered_at)
• 👁️ Aberto (opened_at)
• 🖱️ Clicado (clicked_at)
• ❌ Bounce (bounced_at + motivo)

Você sabe se o cliente recebeu, abriu e clicou sem perguntar.

Bulk send — cobrança em massa

Selecione múltiplos receivables → Enviar em lote. O sistema dispara um e-mail por cliente com throttle de 200ms (5 req/s, dentro do limite do Resend). Resultado: cobrar 50 clientes em 10 segundos.

Erros comuns

• Cliente sem e-mail cadastrado: o sistema pula com motivo “sem e-mail” no relatório do bulk. Cadastre o e-mail antes ou cobre por WhatsApp.
• Cliente alegou que não recebeu: olhe email_dispatch_log — se status é delivered ou opened, ele recebeu. Pode ter ido pro spam.
• Magic link expirou: cliente clica depois de 1h. Cai em /client-portal/login com OTP. Frustrante, mas seguro.

Insight

A cobrança automatizada do A7X não substitui o time financeiro — libera ele. O time gasta tempo nos casos difíceis (cliente que não respondeu) em vez de mandar e-mail um por um.

Próximo passo

Receita estruturada. Próxima aula: a pagar — categorias, trigger de comprovante e por que > R$ 500 pede atenção extra.