v2026.6.14
Data de lançamento: 30 de junho de 2026
✨ Novas Funcionalidades
Lista de Clientes Inadimplentes — Módulo Cobranças
O módulo Cobranças ganhou uma nova tela dedicada para acompanhamento da inadimplência. A aba Inadimplentes exibe todos os clientes com parcelas vencidas e não pagas, agrupados por cliente, com totais financeiros e ações diretas de cobrança.
Para que serve?
- Identificar rapidamente quais clientes estão com pagamentos em atraso
- Visualizar o impacto financeiro total da inadimplência em tempo real
- Registrar pagamentos e acessar contratos diretamente da lista
- Facilitar a operação de cobrança sem precisar abrir cada contrato individualmente
Como acessar?
- Acesse o módulo Cobranças no menu lateral
- Clique na aba Inadimplentes (entre Contratos e Recebedores)
O que a tela exibe?
Cards de resumo:
- Total de clientes com pagamentos em atraso
- Valor total em atraso (soma de todas as parcelas vencidas)
Tabela de clientes:
| Coluna | Descrição |
|---|---|
| Cliente | Nome, foto e e-mail do cliente |
| Contato | WhatsApp principal (quando disponível) ou e-mail |
| Parcelas | Quantidade de parcelas em atraso |
| Valor em atraso | Soma total das parcelas vencidas |
| Venc. mais antigo | Data da parcela mais antiga em atraso (+ dias de atraso) |
| Contratos | Contratos vinculados às parcelas em atraso |
Filtros e ordenação
- Busca por nome, e-mail ou WhatsApp — com debounce automático
- Ordenação clicável pelas colunas: cliente (A–Z), valor em atraso ou vencimento mais antigo
- Paginação com 20 clientes por página
Ações por cliente
- Ver parcelas — expande a linha e exibe todas as parcelas em atraso do cliente, com número da parcela, valor, data de vencimento, dias de atraso e botão "Registrar pagamento" para dar baixa diretamente
- Ver contratos — navega para a aba Contratos já filtrada pelo cliente
Detalhes técnicos
A consulta utiliza uma função RPC no banco de dados (get_overdue_customers) que realiza agrupamento, filtragem, ordenação e paginação inteiramente no PostgreSQL — o contato WhatsApp é buscado diretamente da tabela customer_contacts (tipo whatsapp, marcado como principal por tipo).
A inadimplência é detectada por data (due_date < hoje), sem depender de cron para atualizar status — a lista sempre reflete o estado real no momento da consulta.
🎯 Benefícios
- ✅ Visão consolidada da inadimplência sem precisar abrir contrato por contrato
- ✅ Valor total em atraso visível de imediato no topo da tela
- ✅ Registro de pagamento direto na lista — sem sair da tela de inadimplentes
- ✅ Contato WhatsApp exibido para facilitar a abordagem de cobrança
- ✅ Lista sempre atualizada — sem defasagem de cron