Core, apólices, CRM, relatórios da corretora e planilhas
Documento normalizado, status de ativo por sistema e responsável vigente na data
Uma pessoa, seus contratos e objetos, ativa ou não
Agente de IA, listas, contagem de base e envio a parceiros
O que resolve
- A base ativa tem um número só, igual para diretoria, comercial e financeiro.
- Cada cliente aparece uma vez, com tudo o que contratou em todos os sistemas e a origem de cada contrato.
- Lead que já era cliente para de contar como venda nova.
Perguntas de negócio que responde
Faça estas perguntas ao seu agente quando o caso estiver pronto.
O que você precisa
- Os sistemas onde o cliente vive conectados na Nekt: core, apólices, CRM e relatórios do parceiro
- A definição escrita de cliente ativo, por sistema e por produto
- Um histórico de responsável por conta, se a pergunta for sobre o passado
O que você recebe
- Uma tabela por pessoa com documento normalizado, origem e status ativo
- O detalhe pessoa x contrato x objeto, com data de ativação
- Um vínculo lead para contrato que diz por qual chave casou
- Um agente de IA que conta a base com a regra de ativo já aplicada
Onde ativar
Responde quantos clientes ativos existem e se um documento já é cliente, com a regra de ativo e a origem de cada contrato.
Ativos com placa, produto e dia de vencimento para cobrança, assistência e envio a parceiros, uma linha por pessoa e objeto.
Base ativa por regional, consultor e produto, com ativações do mês e cobertura de documento por fonte.
A normalização é mecânica. O trabalho está em fechar com o negócio o que é cliente ativo em cada sistema e em guardar o histórico de responsável. 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.
O mesmo cooperado está no sistema de proteção, no de apólices, num pipeline do CRM e numa planilha, e em cada um o documento foi digitado de um jeito: com pontuação, sem zero à esquerda, como número com ".0" no fim. Somar as bases conta a mesma pessoa várias vezes. Cada área usa uma definição própria de ativo, e o lead que já era cliente vira conversão no funil.
Como costuma ser feito, e a regra
Cada linha é um erro que já aconteceu na prática.
Remova tudo que não é dígito. CPF tem 11 dígitos e CNPJ 14: complete com zeros à esquerda quando a fonte leu o campo como número. Se vier com mais de 14 dígitos (prefixo de sistema), fique com os 14 últimos. Tire o ".0" de campos que passaram por float antes de remover não-dígitos, senão 8539905.0 vira 85399050. Guarde o documento original ao lado.
Documento com tamanho diferente de 11 ou 14, ou com todos os dígitos iguais (000..., 111...), fica nulo. Telefone: só dígitos, corte o 55 apenas quando tiver 12 ou 13 dígitos, aceite 10 ou 11, o resto é nulo. Placa: maiúscula sem traço, válida no padrão antigo e no Mercosul (3 letras, 1 dígito, 1 letra ou dígito, 2 dígitos). Chassi: pelo menos 8 caracteres e nunca só zeros.
Declare o que conta como ativo em cada fonte: no core, contrato com status ATIVO; no sistema de apólices, apólice active; no produto que só existe no CRM, o negócio na etapa Ativo daquele pipeline. Depois aplique as exclusões combinadas: quem está na lista de cancelados e, se o negócio decidir, quem está inadimplente. Escreva a decisão sobre inadimplente, porque ela muda a contagem.
Empilhe as fontes num formato comum (nome, documento, objeto, contrato, data de ativação) com as colunas fonte e id na origem. Conte contratos por fonte + id na origem, porque o detalhe pode ter uma linha por produto. Só depois consolide por documento.
A data de ativação de um contrato é a menor data de pagamento entre as faturas pagas dele. Na apólice, a data de início de vigência. Data de criação do contrato ou da proposta não é ativação: há contratos criados que nunca pagaram.
Em proteção veicular e seguro, uma pessoa tem vários veículos, implementos ou apólices; em investimento, várias contas em instituições diferentes. O detalhe é pessoa x contrato x objeto, e o objeto pode ser veículo ou implemento, nunca os dois. Conte pessoas pelo documento distinto e objetos pela chave do objeto.
Na base de pessoas e leads, o lead só entra como tipo Lead quando não há cliente ativo ligado a ele. Se os dois existem, fica o cliente. Pessoa sem conta vinculada continua na base, com a conta nula.
Case o lead com contratos pela chave mais forte primeiro: documento, depois placa ou chassi, depois telefone, depois o contato do CRM. Guarde por qual chave casou. Compare a data de registro do contrato com a criação do lead: contrato anterior ao lead é cliente que voltou, não conversão.
Assessor, consultor ou corretor muda com o tempo. Para captação, venda ou comissão, junte com o histórico da carteira onde início da vigência <= data do fato e (fim nulo ou fim > data do fato). O responsável atual só vale para listas de hoje.
No core, filtre registros com deleted verdadeiro em pessoa, contrato, regional e consultor. No CRM, fique com a última versão de cada id (última data de modificação e, no empate, a sincronização mais recente). Em dados de Open Finance, confira se o evento traz o id do usuário da plataforma em vez do id do cliente e traduza antes de juntar.
Chaves de cruzamento e como normalizar
Da mais forte para a mais fraca. Chave inválida vira nulo e não liga cadastros.
Definições
Armadilhas que já aconteceram
CNPJ e CPF lidos como número de planilha ou CSV perderam os zeros iniciais e um CNPJ começado em 00 nunca casava com o core.
Leia documento como texto e complete com zeros até 11 ou 14 dígitos.
O número da apólice veio como float, "8539905.0", e a limpeza de não-dígitos gerou 85399050, que não batia com nada.
Remova o ".0" final antes de tirar não-dígitos.
Somar o core de proteção, o sistema de apólices e o pipeline do CRM contava a mesma pessoa uma vez em cada sistema.
Empilhe com fonte e consolide por documento antes de contar.
Leads de campanha casados por telefone com contratos de anos antes apareciam como conversão do mês.
Compare a data do contrato com a criação do lead e separe cliente que voltou.
A captação de meses anteriores foi atribuída ao assessor atual da conta depois de uma troca de carteira.
Cruze pelo histórico de vigência da carteira na data da captação.
A query validada no editor usava índice de array a partir de 1 e cardinality; virou transformação em Spark, que indexa a partir de 0 e usa size, e passou a pegar o item errado.
Teste a regra no motor em que ela vai rodar antes de publicar a tabela.
Teste de aceitação
O caso está pronto quando todos os itens passam.
- Nenhum documento normalizado aparece em mais de uma linha da tabela de pessoas.
- Toda linha tem documento com 11 ou 14 dígitos ou documento nulo com motivo; nenhuma tem dígitos todos iguais.
- A contagem de clientes ativos por fonte bate com a contagem do próprio sistema na mesma data (core por status ATIVO, apólices active, etapa Ativo do pipeline).
- Contratos ativados no mês = contratos com primeira fatura paga no mês, conferido em 5 contratos escolhidos ao acaso.
- Todo vínculo lead para contrato tem a chave usada e a classificação conversão ou cliente que voltou.
Pacote para o agente
Cole no Claude, ChatGPT ou outro cliente com o MCP da Nekt conectado.
Base única por CPF e CNPJ - A pessoa é identificada pelo documento normalizado: só dígitos, CPF com 11 e CNPJ com 14, zeros à esquerda preservados. Documento com outro tamanho ou com dígitos todos iguais é inválido e não liga cadastros. - Para contar pessoas, use documento distinto. Nunca conte linhas: a tabela de detalhe tem uma linha por contrato, objeto (placa, chassi, apólice, conta) e às vezes por produto. - Cliente ativo: contrato ATIVO no core, apólice active no sistema de apólices, ou negócio na etapa Ativo do pipeline <pipeline> do CRM; e fora da lista de cancelados. Inadimplente: <entra | não entra> na base ativa. - Data de ativação = primeiro pagamento confirmado do contrato. Para apólice, início de vigência. - Cliente prevalece sobre lead. Um lead só é conversão se o contrato foi registrado na criação do lead ou depois; contrato anterior é cliente que voltou. - Diga sempre por qual chave o vínculo foi feito (documento, placa, chassi, telefone, contato do CRM). Telefone sozinho é sinal fraco. - Responsável (assessor, consultor, corretor) em perguntas sobre o passado: use o vigente na data do fato, pelo histórico da carteira. Para listas de hoje, use o atual. - Se a pergunta não disser o produto ou o sistema, responda com o total consolidado e abra por fonte. Exceções por cliente: - <cliente>: produto <produto> existe só no CRM; ativo = etapa <etapa> do pipeline <id>. - <cliente>: inadimplentes há mais de <N> dias saem da base ativa.
Construa no meu workspace Nekt o caso "Base única por CPF e CNPJ" seguindo as regras em https://academy.nekt.com/industrias/financeiros/base-unica-cpf-cnpj.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
A pessoa é o CPF e o objeto é a conta em cada instituição. O assessor vem do histórico da corretora pela data do fato.
Dois níveis: empresa (CNPJ) e colaborador (CPF), com o contato do CRM ligado à empresa pela raiz do CNPJ.
Clientes e leads do planejador numa só base, com saldo por instituição e um histórico diário por cliente, conta e data.