Enriquecimento de CRM com CNPJ: guia prático para limpar, completar e manter a base B2B

Todo CRM B2B envelhece. Vendedores cadastram contas com pressa, importações trazem planilhas sem padrão, empresas mudam de endereço, de atividade ou simplesmente fecham. Em pouco tempo, os relatórios por segmento deixam de fazer sentido e as cadências passam a disparar para empresas que não existem mais.

O CNPJ é a melhor âncora para recuperar essa base: é um identificador único, público e estável, que dá acesso a dados cadastrais oficiais. Este guia apresenta um roteiro de enriquecimento em oito etapas, com exemplos de código e as decisões que evitam estragar o que o time construiu.

Etapa 1: audite antes de mexer

Antes de enriquecer, meça o tamanho do problema. Exporte as contas do CRM e calcule, para cada campo relevante:

• preenchimento: percentual de contas com valor;
• validade: percentual com valor no formato certo (CNPJ com dígito verificador correto, UF válida, CEP com 8 dígitos);
• duplicidade: contas diferentes com o mesmo CNPJ.

Esse diagnóstico define a prioridade (por exemplo, "40% das contas sem CNPJ" pede uma etapa de correspondência antes de qualquer enriquecimento) e vira a linha de base para medir o resultado.

Etapa 2: normalize o CNPJ

Um CNPJ guardado de cinco jeitos diferentes não serve como chave. Normalize tudo para a forma canônica: 14 caracteres, sem máscara, em maiúsculas.

Cuidados:

• zeros à esquerda: planilhas costumam removê-los; complete com zeros até 14 posições quando o valor for só numérico;
• formato alfanumérico: desde julho de 2026 há CNPJs com letras; a validação precisa aceitá-los (veja o guia de adaptação ao CNPJ alfanumérico);
• dígito verificador: CNPJs que não passam na validação vão para uma fila de revisão, não para a consulta.

Etapa 3: encontre o CNPJ de quem não tem

Para contas sem CNPJ, há algumas estratégias de correspondência, da mais confiável para a menos:

1. Documentos internos: notas fiscais, contratos e cadastros de faturamento costumam ter o CNPJ correto.
2. Domínio do e-mail ou do site: o domínio corporativo ajuda a encontrar a empresa, desde que você descarte provedores genéricos (gmail, hotmail, outlook).
3. Razão social + município: correspondência aproximada de nomes, sempre com revisão humana quando a semelhança não for alta.

Nunca preencha um CNPJ por correspondência aproximada sem marcar a origem e o grau de confiança. Um CNPJ errado é pior do que nenhum, porque contamina tudo o que vem depois.

Etapa 4: consulte os dados

Com CNPJs válidos, é hora de buscar os dados cadastrais. Para testar o processo, APIs públicas baseadas nos dados abertos da Receita são suficientes. Um exemplo com a BrasilAPI:

curl -s https://brasilapi.com.br/api/cnpj/v1/00000000000191 \
  | jq '{razao_social, situacao: .descricao_situacao_cadastral, cnae: .cnae_fiscal,
         cnae_descricao: .cnae_fiscal_descricao, porte, uf, municipio,
         simples: .opcao_pelo_simples}'

Para centenas ou milhares de contas, escreva um processo em lote com controle de ritmo e repetição em caso de falha:

import csv
import time

import requests

API = "https://brasilapi.com.br/api/cnpj/v1/{cnpj}"
CAMPOS = ["razao_social", "descricao_situacao_cadastral", "cnae_fiscal",
          "cnae_fiscal_descricao", "porte", "uf", "municipio", "opcao_pelo_simples"]

def consultar(cnpj: str, tentativas: int = 4) -> dict | None:
    for i in range(tentativas):
        r = requests.get(API.format(cnpj=cnpj), timeout=20)
        if r.status_code == 200:
            return r.json()
        if r.status_code == 404:
            return None                      # CNPJ não encontrado na base
        time.sleep(2 ** i)                   # 429 ou erro temporário: espera e tenta de novo
    raise RuntimeError(f"falha ao consultar {cnpj}")

with open("contas.csv") as entrada, open("contas_enriquecidas.csv", "w", newline="") as saida:
    leitor = csv.DictReader(entrada)
    escritor = csv.DictWriter(saida, fieldnames=[*leitor.fieldnames, *CAMPOS, "enriquecido_em"])
    escritor.writeheader()
    for linha in leitor:
        dados = consultar(linha["cnpj"]) or {}
        escritor.writerow({**linha, **{c: dados.get(c) for c in CAMPOS},
                           "enriquecido_em": time.strftime("%Y-%m-%d")})
        time.sleep(0.5)                      # respeite os limites de uso da API

Em produção, considere três pontos:

• limites e termos de uso: APIs públicas gratuitas têm limites de requisição e não oferecem garantia de disponibilidade; para volumes grandes ou uso comercial contínuo, prefira um fornecedor com contrato;
• cache: não consulte de novo um CNPJ enriquecido há poucos dias;
• registro: guarde quando e de onde veio cada dado.

Etapa 5: mapeie os campos para o CRM

Defina, antes da importação, onde cada informação entra. Um mapeamento típico:

Etapa 6: defina regras de sobrescrita

Esta é a etapa que mais gera conflito com o time comercial. Algumas regras que funcionam bem:

• Campos cadastrais oficiais (razão social, situação, CNAE, endereço fiscal) podem ser sobrescritos pela fonte oficial, com histórico do valor anterior.
• Campos editados por pessoas (nome de exibição, segmento ajustado, responsável) não são sobrescritos. Se o dado oficial divergir, crie uma sugestão ou uma tarefa de revisão.
• Campos vazios são preenchidos sem cerimônia.
• Tudo fica registrado: origem, data e valor anterior, para auditoria e para desfazer erros.

Etapa 7: trate contas inativas

O enriquecimento quase sempre revela empresas baixadas, inaptas ou suspensas. Não as apague. Em vez disso:

• marque o status cadastral e retire as contas das cadências ativas;
• mantenha o histórico de negócios e atividades, que continua valendo para análise;
• para clientes ativos com CNPJ baixado, abra uma tarefa: a empresa pode ter mudado de CNPJ ou ter sido incorporada por outra.

Etapa 8: transforme em rotina

Enriquecer uma vez resolve o passado; a base volta a envelhecer em seguida. Defina uma rotina:

• novas contas: enriquecimento automático no momento do cadastro;
• reconsulta periódica: mensal, alinhada à publicação do cadastro da Receita, priorizando contas em negociação e clientes ativos;
• eventos: mudanças relevantes (situação, endereço, CNAE) geram alertas para o responsável, como descrito no artigo sobre diffs mensais do CNPJ.

LGPD: o que muda quando entram contatos

Dados cadastrais de pessoa jurídica (razão social, CNAE, endereço do estabelecimento) não são dados pessoais. Mas o enriquecimento frequentemente toca dados que são:

• sócios pessoa física e seus nomes;
• e-mails nominais e telefones celulares;
• empresários individuais e MEIs, cuja razão social é o nome da pessoa.

Para esses dados, documente a base legal (normalmente o legítimo interesse, com avaliação registrada), colete apenas o necessário para a finalidade comercial, ofereça descadastro em toda abordagem e tenha um processo para atender pedidos de titulares. Quando um titular pedir remoção, a exclusão precisa valer também para as próximas rodadas de enriquecimento, ou o dado volta no mês seguinte.

Como medir o resultado

Repita a auditoria da etapa 1 depois do primeiro ciclo e acompanhe mensalmente:

• percentual de contas com CNPJ válido;
• preenchimento dos campos de segmentação (setor, porte, região);
• contas inativas fora das cadências;
• relatórios por segmento que voltaram a ser usados pelo time.

Conclusão

Enriquecer o CRM com CNPJ é menos sobre a consulta em si e mais sobre as regras ao redor dela: normalizar a chave, encontrar quem não tem CNPJ com cuidado, respeitar o que o time editou, tratar inativas sem apagar histórico, repetir o processo todo mês e cuidar dos dados pessoais. Com isso, a base volta a ser confiável para segmentar, distribuir territórios e priorizar.

Se preferir enriquecer planilhas e o CRM sem escrever o processo, experimente o enriquecimento de CSV da CNPJpedia.