Histórico Financeiro — Linha do tempo do cliente
Histórico Financeiro é a tela que mostra TUDO que aconteceu financeiramente com um cliente: mensalidades geradas, cobranças, baixas, estornos, renegociações, lançamentos manuais — em ordem cronológica. É a 'memória' financeira do cliente.
Glossário
| Termo |
Significado |
| Histórico Financeiro |
Linha do tempo de eventos do cliente |
| Linha do tempo |
Ordem cronológica de eventos |
| Audit trail |
Histórico completo "quem fez o quê quando" |
| Filtro de período |
Restringir eventos a janela de datas |
| Saldo |
Soma de débitos - pagamentos do cliente |
| Mensalidade criada |
Tipo de evento: geração de débito mensal |
| Pagamento |
Tipo de evento: cliente pagou |
| Juros |
Tipo de evento: acréscimo por atraso |
| Renegociação |
Tipo de evento: início ou ajuste de acordo |
Visão geral
CLIENTE
|
v
+-----------------------------------------+
| HISTORICO FINANCEIRO (linha do tempo) |
| |
| 02/01: + Mensalidade R$ 100 |
| 03/01: + Cobranca gerada (boleto) |
| 10/01: + Boleto pago: R$ 100 |
| 02/02: + Mensalidade R$ 100 |
| 03/02: + Cobranca gerada |
| 15/02: ! Vencimento sem pagamento |
| 18/02: + Juros aplicado R$ 5 |
| 25/02: + Renegociacao iniciada |
| ... |
+-----------------------------------------+
v
Audit trail completo - filtrar por tipo,
data, valor. Cada linha tem link para o
registro original.
Tipos de eventos registrados
| Tipo |
Quando aparece |
| Mensalidade criada |
Cron ou geração manual |
| Cobrança gerada |
Após mensalidade/fatura virar boleto/PIX |
| Pagamento |
Cliente pagou (via retorno CNAB ou webhook gateway) |
| Estorno |
Devolução de valor pago |
| Juros/multa |
Após vencimento sem pagar |
| Renegociação |
Início ou ajuste de acordo |
| Lançamento manual |
Cobrança avulsa (taxa, multa, ajuste) |
| Cancelamento |
Operador anulou registro |
| Reativação |
Registro cancelado reaberto |
| Alteração de valor |
Operador alterou valor original |
Tela principal
Cliente → Histórico Financeiro
Fluxos típicos
Fluxo 1: Cliente reclama 'Não recebi boleto'
| Passo |
Onde |
Ação |
| 1 |
Cliente → Histórico Financeiro |
Filtrar mês corrente |
| 2 |
Conferir |
Mensalidade gerada? Cobrança gerada? Envio email/WhatsApp? |
| 3 |
Se não |
Verificar regra de cobrança + carteira do contrato |
| 4 |
Re-enviar |
Botão 'Reenviar boleto' direto da linha |
Fluxo 2: Investigar pagamento que não baixou
| Passo |
Onde |
Ação |
| 1 |
Cliente afirma que pagou em data X |
Pedir comprovante |
| 2 |
Histórico Financeiro filtra data X |
Não há baixa? |
| 3 |
Verificar Remessa & Retorno |
Houve importação de retorno na data? |
| 4 |
Conciliação Bancária |
Conferir extrato OFX |
| 5 |
Se entrou na conta mas não baixou |
Baixar manualmente apontando o documento original |
Pegadinhas
1. Histórico não mostra eventos cancelados por padrão
Filtrar 'Incluir cancelados' pra ver tudo. Útil em investigação.
2. Eventos automáticos vs manuais
Coluna 'Criador' mostra quem fez. Cron = 'Usuário 1' (sistema), operador = nome real. Diferenciar quando audita.
3. Conta total não bate
Soma das mensalidades + lançamentos - estornos - cancelados = saldo do cliente. Se não bater, há registros 'fantasma' — investigar.
4. LGPD — não exporte histórico de outros clientes
Histórico tem CPF/RG/email/telefone do cliente. Apenas a pessoa do cliente tem direito ao próprio histórico (não familiares, não terceiros). Cuidado com export sem autorização.
5. Histórico longo lento de carregar
Cliente com 10 anos de Quaza pode ter 500+ linhas. Use filtro por período pra acelerar.
Galeria de telas
Hist cliente
Hist historico
Hist listagem
Boas práticas operacionais
Esta seção reúne hábitos que provedores experientes adotam pra evitar problemas recorrentes neste módulo. Aplicação consistente faz diferença grande no longo prazo — diferença entre operação caótica e operação previsível.
Revisão periódica
Reserve 30 minutos por semana pra revisar o estado do módulo: o que rodou, o que falhou, o que ficou pendente. Anomalia detectada cedo custa 10x menos que descoberta tarde.
Documentação de procedimentos
Crie checklists internos pra operações recorrentes — abertura/fechamento do mês, processamento em lote, correção de inconsistências. Não dependa de quem "sabe de cabeça" — funcionário pode sair, ficar doente, ter dia ruim.
Backup antes de operações em massa
Qualquer mudança que afete 100+ registros deve ser precedida de backup ou export. Restaurar uma alteração massiva equivocada é caro; prevenir é simples.
Comunicação com cliente
Mudanças que impactam o cliente (preço, cobrança, regra) devem ser comunicadas com antecedência. Cliente surpreendido reclama; cliente avisado entende.
Indicadores acompanhados
Defina 2-3 indicadores que medem a saúde do módulo. Acompanhe semanalmente. Quando algum sai do range esperado, investigue antes de virar problema visível.
Documentos relacionados
FAQ
Posso editar evento no histórico?
Não diretamente. Tem que cancelar + criar novo. Mantém audit trail.
Cliente pediu certidão negativa — tiro do histórico?
Sim. Filtre 'Em aberto' por cliente. Se zerado, certidão pode ser emitida. Confira saldo total.
Cliente cancelou — preserva histórico?
Sim. Histórico nunca é apagado. Cliente ex-ativo continua tendo histórico acessível por auditoria/contabilidade.
Via API REST do Quaza. Cada endpoint requer autenticação por token. Consulte a equipe técnica para credenciais.
Limites técnicos (volume, taxa) são configuráveis no plano contratado. Pra operações em massa, programe horários de baixa carga.
Cada registro tem timestamp e usuário. Filtro de auditoria permite buscar por período, ação, ou usuário responsável.