Um CNPJ pode estar certo no ERP e sair errado no arquivo que vai para o CRM ou para o sistema fiscal. Se a planilha interpretar 00123456000149 como número, o CSV que ela gravar pode trazer 123456000149. Se o importador usar uma regra que aceita apenas dígitos, vai recusar 12ABC34501DE35. Para descobrir onde o valor muda, teste o cadastro do arquivo original até a última exportação.
A Receita mantém os CNPJs existentes. No formato alfanumérico, as primeiras 12 posições aceitam letras e números, e as duas últimas continuam sendo dígitos verificadores. Guarde os 14 caracteres como texto ao longo da integração e aplique a máscara só onde o sistema de destino a pedir. Se você também precisa revisar formulários, banco e emissão fiscal, veja o que testar nos sistemas para o CNPJ alfanumérico.
Importe o CSV com a coluna de CNPJ como texto
Abra uma planilha em branco e use Dados → De Texto/CSV. Confira na prévia se o arquivo usa vírgula ou ponto e vírgula. Em Transformar Dados, defina a coluna de CNPJ como Texto. Se o Power Query já tiver aplicado uma etapa de tipo numérico, substitua essa etapa antes de carregar. Mudar o tipo para texto depois que os zeros foram retirados preserva o valor já alterado. Volte ao arquivo original para recuperá-los.
Antes de importar para o ERP, abra uma cópia do CSV em um editor de texto e leia uma linha com zeros no começo. Confira a codificação e o delimitador exigidos pelo importador. Se o CNPJ estiver entre aspas, elas fazem parte do formato do CSV. O importador ainda precisa tratar a coluna como texto.
Teste três situações em homologação
O repositório CNPJ alfanumérico em CSV traz arquivos de exemplo e um validador em Python. Use estes três cenários em homologação.
- Numérico com zero inicial. Use
00123456000149e confira se os dois zeros continuam no início do valor exportado. - Alfanumérico. Use
12ABC34501DE35e confira se as letras, a ordem dos caracteres e os dígitos finais foram preservados. - Alfanumérico com máscara. Se o sistema aceitar
12.ABC.345/01DE-35, confira se a chave armazenada corresponde aos mesmos 14 caracteres.
Os dois últimos exemplos são a mesma chave. Se o ERP bloquear duplicatas, importe uma apresentação de cada vez. Rode também o CSV com erros para ver se o importador indica em qual registro encontrou CNPJ vazio, dígito incorreto ou valor truncado.
Confira a exportação antes de liberar o lote
-
Importe os dados em homologação, salve os cadastros e procure por cada CNPJ. Uma prévia de importação pode aceitar a coluna e a gravação falhar depois.
-
Exporte os registros e confira os 14 caracteres. Se o arquivo também passa por outro sistema, repita o teste na saída dele.
-
Valide o formato e os dígitos verificadores. O comando abaixo lê o CSV localmente e aponta a linha e o motivo do erro sem exibir os dados da célula.
python3 validar_csv.py exportacao.csvO padrão é a coluna
cnpjcom ponto e vírgula como separador. Use--colunae--delimitadorse a exportação usar outros valores. -
Compare a exportação com a origem pelo identificador de cada registro. Confira se todas as linhas esperadas voltaram e se cada uma tem o mesmo CNPJ. Um CNPJ trocado por outro válido passa no cálculo do dígito. A comparação pega essa troca.
Em um e-commerce atendido pela Inky, equipes diferentes preenchiam ERP e CRM e usavam uma planilha para fazer a ponte. Ao integrar os dois sistemas, o dado preenchido em um passou a atualizar o outro. Mesmo quando o CSV ainda é necessário, identificar quem gera o arquivo, quem pode editá-lo e quem o importa ajuda a encontrar em qual etapa o cadastro muda.
Se o arquivo sai correto de um sistema e chega alterado no outro, nossa equipe pode revisar o fluxo de integração de sistemas. Conte por onde o cadastro passa, sem enviar dados de clientes.
