Como podemos ajudar?

Como unificar clientes

ATENÇÃO: esta é uma operação IRREVERSÍVEL. A unificação de clientes apaga definitivamente o cadastro do cliente de origem do banco de dados após migrar todos os seus dados para o cliente de destino. Não existe "desfazer", lixeira ou backup automático dessa ação pelo próprio sistema. Confirme muito bem os dois cadastros antes de concluir.

O que é a unificação de clientes

A unificação serve para juntar dois cadastros de cliente duplicados (por exemplo, o mesmo CPF/CNPJ cadastrado duas vezes por engano, ou um cliente com contrato novo cadastrado do zero em vez de reaproveitar o cadastro antigo) em um único cadastro. Todo o histórico, contratos, débitos, notas fiscais e demais vínculos do cliente "de origem" são migrados para o cliente "de destino", e o cadastro de origem é removido do sistema ao final do processo.

Pré-requisitos

• Permissão específica de "Unificar clientes" liberada para o seu usuário/grupo (é uma permissão separada, não vem habilitada por padrão para todo mundo).
• O CPF/CNPJ dos dois clientes precisa ser igual, por questão de segurança — o sistema bloqueia a unificação de documentos diferentes. A única exceção é o CPF/CNPJ genérico "111.111.111-11" (usado como placeholder para cadastros sem documento definido/consumidor não identificado), que é aceito como coringa em qualquer um dos dois lados.
• Tenha certeza de qual cadastro deve ser o destino (o que vai permanecer) e qual deve ser a origem (o que vai deixar de existir). Normalmente o destino é o cadastro mais completo/mais antigo/com contrato ativo.

Onde fica a opção

1. Vá até a listagem de Clientes (tela de listagem, não dentro da edição de um cliente específico).
2. Clique no botão Ações (ícone de chave inglesa) no canto superior da tela.
3. Selecione "Unificar clientes".

Passo a passo

1. No popup "Unificar clientes", preencha o campo Cliente origem — busca por nome, CPF/CNPJ ou código, e inclui inclusive clientes já desabilitados.
2. Ao selecionar o cliente de origem, se o sistema encontrar outro cadastro ativo com o mesmo CPF/CNPJ, o campo Cliente destino já é preenchido automaticamente com sugestão — mas você pode alterar manualmente.
3. Confira com atenção qual é o cliente de origem (será apagado) e qual é o destino (vai receber tudo).
4. Clique em Unificar.
5. Se tudo estiver correto, o sistema redireciona para o cadastro do cliente de destino, já com os dados migrados, e exibe a mensagem "Clientes unificados com sucesso."

O que acontece com os dados do cliente de origem

Ao confirmar a unificação, dentro de uma única transação de banco de dados (tudo ou nada — se algo falhar no meio, a operação inteira é revertida e nada é alterado), o sistema:

• Contratos — todos os contratos do cliente de origem (inclusive os inativos/cancelados) são transferidos para o cliente de destino. O endereço que o cliente de origem tinha é preservado como endereço de cobrança fixo do contrato (para contratos que ainda não tinham um endereço próprio definido), assim como o endereço de cada login/usuário de acesso vinculado ao contrato.
• Usuários de acesso (logins/PPPoE) — todos os logins de conexão vinculados aos contratos do cliente de origem são reatribuídos ao cliente de destino, preservando a conectividade.
• Financeiro — débitos, pagamentos, carnês, alterações de vencimento, documentos, vendas, retornos bancários, gateway de cartão de crédito, sequências de mensalidade e o histórico financeiro completo são todos migrados para o cliente de destino. Nada é apagado nem baixado — o histórico financeiro do cliente de origem passa a existir sob o cliente de destino.
• Fiscal — notas fiscais (NF-e, NFC-e/NFe21, NFSe, NFCom/NFeSVA, NFe múltipla) emitidas para o cliente de origem passam a ficar vinculadas ao cliente de destino.
• Ordens de serviço e atendimento — OS, itens de atendimento e ocorrências do cliente de origem são migrados para o cliente de destino.
• Comunicação — histórico de e-mails, SMS, WhatsApp, campanhas e conversas de chat são migrados.
• Portal do cliente — o usuário de acesso à área do cliente, logs de hotsite e notificações do cliente de origem são reapontados para o cliente de destino.
• Dependentes e contatos — dependentes e contatos vinculados ao cliente de origem passam a ser do cliente de destino.
• Anexos/arquivos — os arquivos anexados ao cadastro do cliente de origem são movidos fisicamente (na pasta de mídia do sistema) para a pasta do cliente de destino.
• Dados cadastrais do tipo de cliente — se o cliente de origem tinha alguma característica marcada (é fornecedor, é técnico, é vendedor, é condomínio, é transportadora, é cadastro interno) que o cliente de destino não tinha, essa característica é copiada para o destino.
• Condomínio — se o cliente de origem era o "condomínio" vinculado de outros cadastros, esses vínculos passam a apontar para o cliente de destino.

O que é apagado de fato

Depois de migrar todos os vínculos acima, o sistema executa uma exclusão definitiva (DELETE real no banco de dados) do registro do cliente de origem. Não é uma inativação, não é um "soft delete" com flag de removido — o registro deixa de existir na tabela de clientes. Como todos os dados relacionados já foram reapontados para o cliente de destino antes desse passo, não sobra nenhum vínculo "órfão" apontando para um cliente inexistente, mas o cadastro do cliente de origem em si (nome, dados cadastrais próprios daquele registro) não pode mais ser recuperado.

Fica algum registro da unificação?

Sim. No histórico de alterações do cliente de destino (botão "Ver histórico do cliente" no cadastro) fica registrada uma entrada do tipo "Unificou", com a mensagem informando o código e o nome do cliente de origem que foi unificado — essa é a única "prova" que resta de que aquele cadastro existiu e foi incorporado.

O que NÃO fazer

• Não unifique clientes com CPF/CNPJ diferentes mesmo que pareçam ser a "mesma pessoa" — o sistema bloqueia por segurança, e forçar isso através do CPF/CNPJ genérico só deve ser usado em casos reais de cadastro sem documento, nunca como atalho.
• Não escolha o cliente errado como destino. Depois de confirmado, não é possível reverter — se você inverter origem e destino, vai perder justamente o cadastro que deveria continuar existindo.
• Não unifique sem antes revisar contratos e débitos em aberto dos dois cadastros — embora a operação migre tudo automaticamente, uma checagem prévia evita surpresas (por exemplo, dois contratos ativos que deveriam ter sido cancelados antes).
• Não repita a operação "para testar" — cada tentativa bem-sucedida apaga um cadastro. Se tiver dúvida sobre o resultado, confira primeiro em ambiente de homologação/teste, nunca em produção.

Erros comuns

• "Clientes devem possuir o mesmo CPF/CNPJ." — os documentos informados são diferentes e nenhum dos dois é o CPF genérico "111.111.111-11".
• "Clientes não podem ser iguais." — foi selecionado o mesmo cliente nos dois campos.
• "Cliente: Não foi possível unificar os clientes." — ocorreu uma falha durante a migração (a transação é revertida por completo, então nenhum dado é perdido nesse caso); verifique o log de erros do sistema para identificar a causa.