Pagamentos, contratos e cadastro do core e do billing
Safra pelo primeiro pagamento, grade cliente x mês, fim pelo status declarado
Curvas por safra e MoB, permanência e LTV
Comitê, board, painel de retenção e agente de IA
O que resolve
- Cada safra é comparada com as outras na mesma idade, sem misturar safra nova com antiga.
- Receita, ativos e atraso da safra vêm do que foi pago e do que venceu, não do que foi faturado.
- A permanência média deixa de ser puxada para cima por quem ainda está ativo.
Perguntas de negócio que responde
Faça estas perguntas ao seu agente quando o caso estiver pronto.
O que você precisa
- A fonte de pagamentos conectada na Nekt: core de crédito, faturas de assinatura ou do core de proteção
- A regra de entrada e de fim combinada com o negócio: qual pagamento abre a safra e qual status encerra
- A primeira versão do cadastro de cada cliente (score, canal, empregador) ou um histórico desde já
O que você recebe
- Uma tabela cliente x mês com safra, MoB, ativo, receita e atraso
- Curvas por safra prontas para comparar na mesma idade
- Permanência por contrato e LTV realizado por regional e produto
- Um agente de IA que responde sobre safras com a régua de entrada e de fim
Onde ativar
Curvas de ativos, receita e atraso por safra e faixa de risco da entrada, lado a lado no mesmo MoB.
Responde receita, atraso e permanência por safra com a regra de entrada, de fim e de MoB já aplicada.
Permanência dos encerrados, curva de sobrevivência e churn de 30 e 90 dias por regional, consultor e produto.
A grade cliente x mês é simples. O trabalho é fechar a data de entrada e de fim com o negócio e congelar os atributos da entrada. O detalhado traz as regras de negócio, as armadilhas e o teste de aceitação. Ou mande tudo direto para o seu agente com o MCP da Nekt.
A tabela de contratos diz quando cada cliente entrou pelo cadastro, não pelo primeiro pagamento, e o status atual reescreve o score e o canal da entrada. Quem soma por mês de calendário mistura safras de idades diferentes. Quem calcula permanência até hoje para os ativos e até a última atualização para os inativos produz uma média que sobe sozinha e que esquece justamente quem cancelou.
Como costuma ser feito, e a regra
Cada linha é um erro que já aconteceu na prática.
Safra = mês do primeiro pagamento confirmado: primeira fatura de assinatura paga, primeiro adiantamento liberado ou primeira mensalidade paga do contrato. Data de cadastro, de proposta ou de assinatura do contrato não abre safra, porque há quem cadastra e nunca paga. Declare a regra no context document e confira se o código usa a mesma.
Score, faixa de risco, canal, campanha e empregador usados para abrir a curva são os da primeira versão do cadastro (a mais antiga por data de atualização) ou os vigentes na data de entrada no histórico. O cadastro atual muda depois: o score sobe, o canal é corrigido.
Gere uma linha por cliente e por mês de calendário desde a safra, com zero onde não houve pagamento. MoB = meses entre a safra e o mês. Meses antes da safra e clientes com conta excluída ficam marcados (MoB -1) e fora das curvas.
O mesmo cliente pode ter mais de uma conta ou mais de um contrato. A curva é por cliente (id mestre ou documento), somando todas as contas; a conta exibida é a primeira. Assinatura e adiantamento podem ter safras diferentes: guarde um MoB por produto e diga qual a curva usa.
Some só valores efetivamente pagos: fatura com status de sucesso, taxa com pagamento confirmado, valor cobrado do adiantamento. Fatura em aberto não é receita, nem quando o valor pago vem zero e o faturado está preenchido. Na proteção, use só a mensalidade (fatura do tipo mensal), sem canceladas. Fatura repetida no mesmo mês para a mesma assinatura conta uma vez.
No mês de referência, separe o que venceu e não foi pago (data de cobrança antes de hoje com erro ou pagamento parcial) do que está aguardando pagamento (cobrança no futuro). Só o vencido entra no atraso da safra. O atraso da safra no MoB k é o valor vencido e não pago / valor liberado pela safra, e a migração entre faixas de um mês para o outro é o roll rate.
Declare quais status encerram o cliente (por exemplo, inativo, cancelado e cancelado com pendência) e use a data da mudança para esse status. Em assinatura, fim = cancelamento, ou o último mês pago se for posterior. Inadimplente não é fim até virar cancelado. Todo status final entra: deixar o cancelado comum de fora reduz justamente quem saiu.
Quem ainda está ativo tem permanência em aberto. A permanência média é calculada só entre os encerrados, ou por curva de sobrevivência (percentual de ativos em cada mês desde a entrada). Nunca misture encerrados com ativos medidos até hoje.
Compare o MoB 3 de uma safra com o MoB 3 das outras. Só entra no denominador de cada MoB quem já teve tempo de chegar nele. A safra do mês corrente ainda não fechou o primeiro mês. Churn em janela móvel (saídas nos últimos 30 e 90 dias) é outro indicador, recalculado a cada execução, e não substitui a curva.
O que abre e o que fecha a safra, por negócio
Regras que operações reais usaram. Escolha uma por produto e escreva no context document.
Definições
Armadilhas que já aconteceram
O context document definia a safra como o mês do primeiro adiantamento, mas a tabela usava a data de cadastro do usuário, e o agente respondia com a regra errada.
Confira a coluna de safra contra o primeiro pagamento em uma amostra antes de publicar.
A permanência usava hoje como fim para os ativos, e a média crescia um dia a cada dia sem ninguém sair ou entrar.
Permanência só dos encerrados e curva de sobrevivência para a base.
A permanência considerava como fim só inativo e cancelado com pendência; os cancelados comuns ficavam de fora do cálculo.
Lista fechada com todos os status finais.
Quando o valor pago vinha zero, a soma usava o valor faturado, e o LTV contava mensalidades que nunca foram pagas.
Some só faturas com pagamento confirmado.
A safra era aberta pelo score atual do cliente, e a faixa de risco da entrada parecia melhor do que foi.
Use a primeira versão do cadastro ou a vigente na data da entrada.
Deals excluídos do CRM continuavam nas safras da jornada do cliente e criavam churn que não aconteceu.
Filtre excluídos antes de montar a safra.
Teste de aceitação
O caso está pronto quando todos os itens passam.
- Cada cliente tem exatamente uma linha por mês desde a safra, sem buracos e sem meses anteriores a ela nas curvas.
- A safra de 5 clientes escolhidos ao acaso é igual ao mês do primeiro pagamento confirmado deles na fonte.
- A receita total da grade num mês fechado bate com os pagamentos confirmados do billing no mesmo mês (diferença abaixo de 1%).
- Nenhum contrato ativo entra na permanência média; todo contrato com status final entra.
- O denominador de cada MoB só tem clientes de safras que já chegaram a ele.
Pacote para o agente
Cole no Claude, ChatGPT ou outro cliente com o MCP da Nekt conectado.
Safras e permanência - Tabela: <tabela_grade>, uma linha por cliente e mês de calendário, com safra, MoB, ativo, receita paga e valor vencido. - Safra = mês do primeiro pagamento confirmado no produto <produto>. Não use data de cadastro nem de contrato. - Atributos da safra (score, canal, campanha, empregador) são os da entrada, não os atuais. - MoB 0 é o mês da safra. Linhas com MoB -1 (antes da safra ou conta excluída) ficam fora das curvas. - Receita = só pagamentos confirmados. Fatura em aberto, cancelada ou com valor pago zero não é receita. - Atraso da safra = valor vencido e não pago / valor liberado. O que está a vencer não é atraso. - Status finais: <inativo, cancelado, cancelado com pendência>. Data de fim = data da mudança de status. Inadimplente não é fim. - Permanência média só com contratos encerrados. Para ativos, use a curva de sobrevivência. - Compare safras sempre no mesmo MoB e só com safras que já chegaram a ele. Exceções por cliente: - <cliente>: cliente com várias contas consolidado pelo id <id_mestre>; conta exibida é a primeira. - <cliente>: safra de funding por empreendimento, do primeiro aporte à última recompra, só operações contratadas ou realizadas.
Construa no meu workspace Nekt o caso "Safras e permanência" seguindo as regras em https://academy.nekt.com/industrias/financeiros/safras-permanencia.md. 1) Encontre as tabelas de origem e confirme as colunas usadas pelas regras. 2) Crie uma transformação no grão indicado aplicando todas as regras. 3) Rode o teste de aceitação e me mostre o resultado de cada item. 4) Crie o context document do caso no workspace, com as exceções dos meus clientes em aberto para eu preencher.
Variações
Abra a curva pela campanha e pelo parceiro da instalação ou do lead para comparar o retorno de cada canal no mesmo MoB.
Migração do valor entre faixas de atraso de um mês para o outro, aberta por safra, para antecipar a provisão.
Em funding e B2B, a safra é do parceiro (incorporadora, escritório) e mede tempo de casa, primeiro aporte e última recompra.