Artigo
Cadastro de partes e clientes no processo: como padronizar nome, CPF/CNPJ e polo para o relatório por cliente fechar
Publicado em
O relatório por cliente não fecha porque a parte está sendo identificada pelo nome, que é texto variável: a chave é o documento, e o vínculo com o processo é um papel — polo ativo, polo passivo ou terceiro —, não um campo digitado à mão.
Imagem: adicione o arquivo em public/blog/padronizar-dados-cliente-capa.webp
Padronizar dados de cliente no processo jurídico começa por uma decisão de chave. O relatório não fecha porque a mesma pessoa tem mais de um registro na base, e tem mais de um porque está identificada pelo nome, que é texto variável. A chave da parte é o documento normalizado, e o vínculo com o processo é um papel: polo ativo, polo passivo ou terceiro interessado.
- Nome muda de escrita sem mudar de pessoa; CPF e CNPJ têm formato definido e dígito verificador, e por isso servem de chave.
- Parte é cadastro mestre: um registro por pessoa ou empresa, que os processos apontam em vez de redigitar.
- Matriz e filial compartilham a raiz do CNPJ e são registros distintos ligados por grupo econômico — o relatório escolhe o nível de agregação.
- Parte sem documento recebe registro provisório marcado e fila de exceção com dono: nunca placeholder, documento repetido ou nome como chave.
- A conferência de partes entra antes da publicação; no fechamento do mês ela só inventaria o estrago.
Por que o relatório por cliente não fecha: a parte é entidade própria, não campo do processo
Cadastro mestre de partes é um registro único por pessoa ou empresa que os processos apontam em vez de redigitar. Sem ele, cada cadastro cria uma versão nova da mesma pessoa, e a base guarda grafias no lugar de gente.
Somar por nome reparte o total da carteira entre as grafias, e nenhum dos recortes está certo.
Em processo duplicado na base a chave é o número CNJ; aqui a entidade é a pessoa e a chave é o documento.
Nome é texto variável, documento é chave: o que identifica a parte sozinho
O nome muda de escrita sem mudar de pessoa. Chave é o que responde “este registro é a mesma pessoa daquele?” sem depender de alguém lembrar: é propriedade da base, não prática do time.
CPF e CNPJ cumprem esse papel porque têm contagem de posições definida e dígito verificador — um cálculo embutido no próprio número, que permite conferir a consistência do valor antes de aceitá-lo. Documento consistente no formato não prova titularidade — a mesma distinção entre formato e existência descrita em como ler o número CNJ.
A mesma parte chega por origens diferentes — capa, contrato, procuração, planilha do comercial, sistema do cliente —, cada uma com sua convenção:
- Razão social versus nome fantasia. O contrato traz uma, a capa traz outra, e o relatório passa a ter duas empresas.
- Sufixo empresarial abreviado ou por extenso, acento perdido na extração de PDF, preposição em caixa alta vinda de planilha antiga.
- Documento com pontuação em um registro e só dígitos no outro — para o campo de texto são dois valores.
- Mesma parte cadastrada por duas pessoas em canais diferentes — o sintoma que a fila de entrada única reduz, mas não elimina sozinha.
Só o último item é desatenção; nos demais é o sistema que não reconhece dois valores como a mesma pessoa, e isso não se corrige com treinamento.
O que normalizar na entrada para padronizar dados de cliente no processo jurídico
Normalizar é reduzir o valor a uma forma única antes de comparar. No documento, a regra cabe em quatro passos.
- Remover a pontuação: ponto, barra, traço, espaço e quebra de linha. Sem apagar letras — no CNPJ alfanumérico, as doze primeiras posições podem conter letras e só os dois verificadores são numéricos.
- Conferir a contagem: 11 posições para CPF, 14 para CNPJ.
- Completar o zero à esquerda comido por planilha formatada como número.
- Reprovar como exceção o que sobra ou falta demais. Normalização não inventa documento.
No nome, o trabalho é duplo: uma forma de comparação, sem acento, sem pontuação, com espaços colapsados e sufixo empresarial padronizado, e em separado a forma de exibição, que vai para petição e relatório.
Nunca sobrescreva o que chegou da origem: o original serve para auditoria e para devolver o caso a quem enviou; o normalizado, para comparar.
Nome normalizado não é chave: serve para sugerir candidatos à conferência humana quando o documento está ausente ou divergente — sugestão, nunca agrupamento automático.
Matriz e filial com a mesma raiz de CNPJ: um registro ou dois
O CNPJ tem leitura por blocos: as oito primeiras posições identificam a empresa — a raiz —, as quatro seguintes, o estabelecimento, e as duas últimas são verificadoras.
Matriz e filial compartilham a raiz e diferem no estabelecimento, e as duas saídas simples erram em direções opostas: agrupar só pela raiz funde recortes que precisam ficar separados; usar só o número cheio deixa o grupo invisível no relatório.
O desenho que funciona mantém os dois níveis: um registro por CNPJ completo e um campo de grupo econômico que liga os estabelecimentos pela raiz.
A parte no processo costuma ser o estabelecimento citado na capa, enquanto contrato e faturamento podem estar na matriz. São recortes legítimos e diferentes do mesmo cliente — e a regra precisa estar escrita antes do primeiro caso.
Polo ativo, polo passivo e terceiro: o vínculo é papel, não campo de texto
Polo ativo é a posição de quem provoca aquele processo; polo passivo, a de quem é demandado nele; terceiro interessado, a de quem participa sem ocupar nenhum dos dois.
O papel pertence ao vínculo, não à pessoa. O mesmo cliente é polo ativo em um processo e polo passivo em outro, e guardar o papel dentro do registro mestre quebra no segundo caso.
O vínculo é uma tabela própria, de campos curtos:
- processo e parte, cada um apontando para seu registro;
- papel naquele processo;
- se a parte é cliente do escritório e desde quando.
Essa tabela admite mais de uma parte por processo e mais de um processo por parte. Campo “cliente” como texto livre vira contagem de grafias; o filtro correto é “vínculos em que esta parte é cliente”. Rateio e cobrança por cliente dependem de a mesma pessoa ter um registro só.
Parte sem documento informado: como registrar sem inventar chave
A capa nem sempre traz o documento da parte adversa, e a consulta à fonte pode não devolvê-lo. Processo em segredo de justiça é o caso extremo.
Três saídas comuns criam falso agrupamento e precisam estar proibidas por escrito:
- Deixar o campo com placeholder: todos os sem documento viram a mesma parte.
- Repetir um documento qualquer só para o registro salvar.
- Usar o nome como chave provisória, que é o problema original com outro nome.
O que fazer é registro provisório com identificador interno próprio, marcado como “documento não informado”, com origem e data: o registro existe, os vínculos funcionam, e a base sabe que aquela chave é interna.
Esses registros formam fila de exceção com dono e prazo, não um limbo permanente. Quando o documento aparece, o provisório é promovido e os vínculos seguem o registro — nada é recadastrado.
Onde a conferência de partes entra no pipeline e o que consolidar primeiro
No cadastro tratado como pipeline — captura, higienização, conferência, exceção e publicação —, a parte tem lugar em cada etapa:
- Higienização: normalizar documento e nome.
- Conferência: buscar parte existente pelo documento normalizado antes de criar registro novo.
- Exceção: resolver ambiguidade e ausência de documento em fila com dono e prazo.
- Publicação: só depois.
A busca precisa acontecer na gravação do vínculo, com restrição de unicidade no documento normalizado. Consulta na tela não impede dois cadastros simultâneos: o segundo nasce no intervalo entre a consulta e o salvar.
Correção antes da publicação custa uma pergunta a quem tem o documento em mãos; depois, custa desfazer relatório, recorte de carteira e lançamento já entregue ao sistema do cliente. Para medir, use volume de partes em exceção e retrabalho por dado de parte, dentro da medição por etapa.
Na base que já está suja, a ordem importa mais que o esforço:
- Ligar a busca por documento na entrada. Limpar base que continua recebendo registro novo é enxugar gelo.
- Normalizar a base inteira em campos novos, sem sobrescrever o original.
- Agrupar por documento normalizado e resolver os grupos exatos.
- Só então revisar por nome normalizado os registros sem documento, um a um.
Priorize por impacto: clientes ativos, partes que aparecem em relatório já entregue e as que alimentam cobrança. Consolidação preserva histórico: o registro descartado guarda data, quem decidiu, o que foi sobrescrito e o motivo. Decisão humana repetida com padrão estável é regra automática ainda não escrita, que é o sinal de quando faz sentido automatizar o cadastro.
Se a base vem de planilha, essa decisão pertence ao plano de migração — fonte da verdade campo a campo, definida antes da carga.
O relatório por cliente fecha quando três coisas estão no lugar: a parte tem um registro só, o documento normalizado é a chave e o polo é papel do vínculo, não campo digitado. Para discutir esse desenho dentro do fluxo que o escritório já usa, fale com a gente.
Perguntas frequentes
Por que o relatório por cliente não fecha mesmo com todos os processos cadastrados?
Porque o mesmo cliente aparece com vários registros na base de dados. Sem um cadastro mestre de partes — um registro único por pessoa ou empresa que os processos apontam em vez de redigitar — cada digitação cria uma versão nova. Somar por nome reparte o total da carteira entre as grafias, e nenhum dos recortes fica correto. A solução é usar o documento normalizado como chave e agrupar pelo vínculo, não pelo campo de texto.
Como evitar que o mesmo cliente apareça de formas diferentes no sistema?
Use o documento normalizado — CPF ou CNPJ — como chave única da parte, não o nome. O nome muda de escrita sem mudar de pessoa: caixa alta, abreviação, sufixo empresarial com ou sem acento. CPF e CNPJ, ao contrário, têm contagem de posições definida e dígito verificador, permitindo validar a consistência do valor antes de aceitá-lo. Mantendo um registro por pessoa ou empresa e apontando para ele a cada processo, a duplicação é eliminada.
O que normalizar em nome, CPF e CNPJ na entrada do cadastro?
No documento: remover pontuação, conferir a contagem (11 posições para CPF, 14 para CNPJ), completar zero à esquerda comido por planilha, e reprovar como exceção o que sobra ou falta. No nome, guarde uma forma de comparação sem acento, sem pontuação e com espaços colapsados; e guarde em separado a forma de exibição para petição e relatório. Nunca sobrescreva o valor original — mantenha-o para auditoria.
Matriz e filial com a mesma raiz de CNPJ devem ser um registro ou dois?
Devem ser dois registros distintos. O CNPJ tem leitura por blocos: as oito primeiras posições identificam a empresa (raiz), as quatro seguintes identificam o estabelecimento e as duas últimas são verificadoras. O desenho correto mantém ambos os níveis: um registro por CNPJ completo e um campo de grupo econômico que liga os estabelecimentos pela raiz, permitindo que o relatório escolha o nível de agregação na hora de somar.
Como cadastrar parte que não tem documento informado na capa do processo?
Crie um registro provisório com um identificador interno próprio, marcado como 'documento não informado', incluindo origem e data. Evite três práticas que criam falso agrupamento: deixar o campo com placeholder, repetir um documento qualquer, ou usar o nome como chave provisória. O registro provisório funciona normalmente, os vínculos são ligados e a base rastreia a chave como interna. Quando o documento aparece, o provisório é promovido e os vínculos seguem o registro.
Se faz sentido acelerar o cadastro sem abrir mão da conferência com o CNJ, fale com a equipe Projask sobre fluxo automatizado e integração. Você também pode usar o formulário na seção Contratar solução na página inicial.