Como podemos ajudar?

Como fazer a configuração para aceitar CPF duplicado

Por padrão, o sistema não permite cadastrar dois clientes com o mesmo CPF/CNPJ. Esse comportamento é controlado por um único parâmetro global de sistema, e este artigo explica onde ele fica, o que exatamente ele muda no comportamento do sistema, quando faz sentido habilitá‑lo e quais riscos isso traz.

Onde fica essa configuração

A configuração fica em Configurações Gerais do sistema, na aba "Cliente", no campo:

• Permitir CPF/CNPJ duplicados (nome interno do campo: clienteDocumentoUnico) — opções Sim / Não.

O valor padrão de fábrica é "Não" — ou seja, o sistema bloqueia documentos duplicados até que um administrador altere essa opção manualmente.

Por que o sistema bloqueia CPF/CNPJ duplicado por padrão

A validação acontece diretamente na gravação do cadastro de cliente. Sempre que um cliente é salvo (novo ou edição), o sistema verifica se já existe outro registro com o mesmo CPF/CNPJ e, se o parâmetro estiver em "Não", recusa a gravação com a mensagem "Cliente: Já existe um cliente cadastrado com este CPF/CNPJ". Além da validação no salvamento, a própria tela de cadastro do cliente faz uma checagem em tempo real enquanto o campo é digitado: se o documento já existir em outro cliente, o campo é destacado (borda/aviso) e recebe a mensagem "Este CPF/CNPJ já esta em uso", impedindo o envio do formulário.

Esse bloqueio existe para evitar duplicidade real de clientes na base — o que, na prática, gera: relatórios financeiros e fiscais fragmentados para a mesma pessoa/empresa, notas fiscais e cobranças divididas entre cadastros diferentes, e falhas em integrações (SVA, portal do cliente, CRM) que localizam o cliente pelo documento.

Pré-requisitos

• Usuário com permissão de acesso à tela de Configurações (módulo administrativo).
• Entender que essa é uma configuração global — vale para toda a base, não é possível liberar duplicidade só para um cliente ou um tipo de cadastro específico.
• Ter clareza do motivo real da necessidade (ver seção "Quando faz sentido habilitar" abaixo), pois trata-se de remover uma proteção de integridade de dados.

Passo a passo para habilitar

1. Acesse o menu Configurações do sistema.
2. Selecione a aba "Cliente".
3. Localize o campo "Permitir CPF/CNPJ duplicados".
4. Altere o valor de "Não" para "Sim".
5. Clique em Salvar.

A alteração é imediata e vale para toda a operação a partir desse momento (não afeta clientes já cadastrados — apenas libera a gravação de novos documentos repetidos).

O que muda no sistema depois de habilitado

• Cadastro de cliente: a validação de duplicidade no salvamento deixa de bloquear o registro. Na tela, o aviso em tempo real também muda de comportamento: em vez de marcar o campo como erro bloqueante, ele passa a exibir apenas um alerta informativo (o campo é sinalizado como "atenção", não mais como "erro"), permitindo salvar mesmo assim.
• Oportunidades (CRM): ao informar um CPF/CNPJ já existente na conversão de uma oportunidade em cliente, o sistema pergunta se você deseja usar o cliente já cadastrado ou seguir criando um novo — com a configuração desabilitada (padrão), o vínculo com o cliente existente é feito automaticamente, sem perguntar.
• Bolívia (RG/CI): quando o locale do sistema é Bolívia, a mesma regra vale também para duplicidade de RG/CI, não apenas CPF/CNPJ.

Quando faz sentido permitir CPF/CNPJ duplicado

• Mesmo titular com múltiplos contratos/cadastros: provedores que, por herança de modelo antigo ou processo comercial, mantêm um cadastro de cliente por endereço/contrato mesmo quando é a mesma pessoa/empresa (em vez de um cliente com múltiplos contratos vinculados).
• Migração de base: importação de uma base antiga onde já existiam duplicidades reais que precisam ser gravadas "como estão" para depois serem tratadas/mescladas com calma.
• Operação pontual e assistida: nesses casos, o recomendado é habilitar, fazer a operação necessária, e desabilitar novamente em seguida — não deixar como configuração permanente.

Riscos de deixar sempre habilitado

• Duplicidade descontrolada de clientes: qualquer atendente pode criar um cliente novo em vez de localizar o já existente, fragmentando histórico de atendimento, financeiro e contratos.
• Financeiro e fiscal divididos: débitos, boletos e notas fiscais passam a ser emitidos em nome de cadastros diferentes para a mesma pessoa/empresa, dificultando cobrança, negativação e conciliação.
• CRM perde a triagem automática de vínculo: como o sistema deixa de vincular automaticamente ao cliente já existente ao converter uma oportunidade, o operador precisa decidir manualmente a cada caso — e pode errar, criando duplicidade nova a cada venda.
• Retrabalho de limpeza de base: quanto mais tempo o parâmetro fica em "Sim", mais duplicidades reais se acumulam, tornando a limpeza posterior mais trabalhosa.

Para localizar duplicidades já existentes na base, a listagem de Clientes possui a coluna/filtro "CPF/CNPJ Duplicado", que indica quais cadastros têm o mesmo documento em mais de um cliente — útil tanto para auditar o impacto de ter deixado a opção habilitada quanto para planejar uma faxina de duplicados antes de voltar o parâmetro para "Não".

Erros comuns

• Confundir "permitir duplicado" com "ignorar validação de formato": o parâmetro só afeta a checagem de duplicidade. A validação de formato do CPF/CNPJ (dígito verificador, tamanho, etc.) continua acontecendo normalmente, mesmo com a opção em "Sim".
• Achar que a mudança é por cliente ou por tela: é uma configuração única e global — muda o comportamento em todas as telas do sistema que cadastram/validam cliente (cadastro de cliente, wizard de contratação, CRM, troca de titularidade), não é possível restringir a um fluxo específico.
• Fluxo de troca de titularidade se comporta de forma particular: ao criar um cliente novo durante uma troca de titularidade, a tela também consulta esse mesmo parâmetro, mas a checagem de bloqueio nesse ponto específico do código reage de forma direta ao valor do parâmetro (bloqueia justamente quando "Permitir CPF/CNPJ duplicados" está em "Sim"), ao contrário do comportamento padrão do cadastro de cliente. Ou seja, esse fluxo pode se comportar de um jeito diferente do esperado — vale testar a troca de titularidade isoladamente depois de alterar essa configuração, em vez de assumir que o comportamento será idêntico ao cadastro comum de cliente.
• Esquecer de desabilitar depois de uma operação pontual: é o erro mais comum — habilitar para resolver um caso específico (ex.: importação, correção de cadastro) e deixar assim por meses, acumulando duplicidades novas geradas no dia a dia.