Ir para o conteúdo
Azul Magazine Leitura que resolve, semana após semana
Buscar
Mercado

CNPJ válido para testes: como o número é montado e onde usar

CNPJ válido para testes é um número que fecha a conta dos dígitos verificadores sem existir na Receita, feito para homologar cadastro de empresa sem usar dado de cliente real.

Por · · 7 min de leitura
CNPJ válido para testes

CNPJ válido para testes

A equipe vai homologar o cadastro de fornecedores do novo sistema, e alguém sugere "usa o CNPJ da empresa mesmo". Três meses depois, o banco de homologação, cheio de dados reais de clientes, vaza num backup esquecido. A cena se repete em empresa de todo tamanho, e a saída é antiga e barata: número que fecha a conta e não é de ninguém. O CNPJ válido para testes é isso, um identificador com os dois dígitos verificadores calculados pelo algoritmo oficial, sem vínculo com nenhuma empresa. Ele passa em qualquer validação de formato e falha em qualquer consulta à Receita, que é o que um ambiente de teste precisa.

Este texto explica a estrutura do CNPJ, como o cálculo do módulo 11 funciona e por que o número gerado não existe em cadastro nenhum. Mostra onde ele entra no trabalho de quem desenvolve e homologa sistema, o que a lei de proteção de dados diz sobre dado real em teste, o que muda com o CNPJ alfanumérico e os erros de validação mais comuns. Traz um comparativo, um roteiro e as dúvidas frequentes.

CNPJ válido para testes: a estrutura do número

O CNPJ tem catorze dígitos em três blocos. Os oito primeiros identificam a empresa, chamados de raiz; os quatro seguintes identificam o estabelecimento, com 0001 para a matriz e 0002 em diante para filiais; e os dois últimos são verificadores, calculados a partir dos doze anteriores. "Válido", no sentido técnico, quer dizer que os verificadores batem com o cálculo; não quer dizer que a empresa existe. Um sistema recusa um CNPJ digitado errado na hora, sem consultar base nenhuma, refazendo a conta; por isso o gerado pelo mesmo algoritmo é aceito por qualquer formulário.

O gerador costuma permitir escolher se o número sai como matriz ou filial, o que ajuda a testar regras de sistema que tratam os dois casos de forma diferente.

Sequências repetidas, como 00.000.000/0000-00, fecham a conta matemática, e validadores bem feitos as rejeitam por regra extra.

Onde o gerador entra no trabalho

Cadastro de fornecedor, nota fiscal em homologação, integração com pagamento, importação de planilha de clientes: todo fluxo que pede CNPJ precisa ser testado com número que passe na validação e não seja de empresa real. Um gerador de CNPJ válido devolve números com os verificadores corretos, com ou sem pontuação, em lote quando é preciso, e ninguém precisa copiar o CNPJ do cliente para ver se o formulário funciona. O mesmo vale para aula de programação e para demonstração de software, em que a tela precisa de dados que pareçam reais sem serem.

O que sai do gerador serve para o teste e para nada mais: não emite nota de verdade, não abre conta e não passa em consulta à Receita ou ao Sintegra.

Em homologação de nota fiscal eletrônica, as secretarias de fazenda têm ambiente próprio, e o CNPJ gerado entra nele como emitente ou destinatário fictício.

Comparativo entre os tipos de número

Tipos de CNPJ e uso de cada um
TipoPassa na validaçãoUso
CNPJ realSim, e existe na ReceitaProdução, com proteção de dados
CNPJ gerado para testeSim, mas não existe em cadastroDesenvolvimento, homologação, aula
CNPJ inválidoNãoTestar a mensagem de erro
Sequência repetidaFecha a conta, rejeitada por regraTestar a regra extra
CNPJ alfanuméricoSim, com o novo cálculoTestar sistemas atualizados

Como montar o conjunto de teste, em ordem

  1. Gerar de dez a cem CNPJs válidos, entre matrizes e filiais, com e sem máscara, e guardar no projeto de teste.
  2. Acrescentar alguns inválidos, com verificador trocado, para testar a mensagem de erro.
  3. Incluir as sequências repetidas e pelo menos um alfanumérico, para conferir as regras extras.
  4. Usar sempre os mesmos números nos testes automatizados, para o resultado ser repetível.
  5. Marcar o ambiente como teste e nunca copiar essa base para produção.

O passo quatro é o que faz o teste valer: número novo a cada execução esconde bug que só aparece com determinado dígito, e o conjunto fixo permite reproduzir.

Como o cálculo do módulo 11 funciona

Para o primeiro verificador, cada um dos doze dígitos é multiplicado por um peso de uma sequência fixa, que vai de 5 a 2 e depois de 9 a 2, e os produtos são somados. O resto da divisão por 11 define o dígito: resto menor que 2 dá 0, e o resto maior dá 11 menos o resto. Para o segundo verificador, a conta se repete com os treze dígitos já conhecidos e pesos de 6 a 2 seguidos de 9 a 2. A conta cabe em quinze linhas de código; o gerador faz a operação inversa, sorteando a raiz e o estabelecimento e calculando os dois dígitos finais.

A diferença para o CPF está só nos pesos e no tamanho; quem implementou um implementa o outro em minutos.

O que muda com o CNPJ alfanumérico

A Receita Federal passou a emitir, a partir de 2026, CNPJs com letras nos doze primeiros caracteres, mantendo os dois verificadores numéricos, porque a numeração antiga estava perto de esgotar. O cálculo continua sendo o módulo 11, mas cada letra é convertida num valor antes da conta, pela tabela ASCII menos 48. Sistemas que validam só dígitos numéricos passam a rejeitar CNPJ legítimo, e é aí que o teste importa: o conjunto de homologação precisa ter números alfanuméricos gerados para conferir se o cadastro, a nota e a integração aceitam o novo formato. Os CNPJs antigos, só numéricos, continuam válidos.

Máscara de campo que aceita só número e banco de dados com coluna numérica são os dois pontos que mais quebram na transição.

O que a lei diz sobre dado real em teste

CNPJ é dado público, mas o cadastro de cliente ao redor dele, com nome do responsável, e-mail, telefone e faturamento, é dado pessoal e comercial protegido. Copiar a base de produção para homologação sem anonimizar é tratamento fora da finalidade, e vazamento de ambiente de teste já rendeu sanção. A prática recomendada é a homologação ser inteiramente fictícia, com CNPJs gerados, razões sociais inventadas e contatos de domínio de teste. O gerador existe para isso: manter o dado real onde ele precisa estar, e só ali.

Usar número gerado para tentar emitir nota real, abrir conta ou se passar por empresa é crime, sem relação com teste de software; a ferramenta não cria empresa, só faz a conta.

Os erros de validação mais comuns

Aceitar sequência repetida, porque a conta fecha. Validar só o formato, com catorze dígitos e pontuação, sem refazer o cálculo. Rejeitar o número sem máscara, que o usuário cola do cartão CNPJ. Validar só no navegador e não no servidor, o que permite enviar qualquer coisa pela API. Não tratar o alfanumérico. E consultar a Receita a cada tecla digitada, o que é lento e desnecessário: a conta local resolve o formato, e a consulta fica para o momento certo do fluxo.

Perguntas frequentes sobre o gerador

CNPJ válido para testes é de alguma empresa?

Não. O número fecha a conta dos verificadores, mas não está em cadastro nenhum. Existe só para o teste.

Posso usar o número gerado para emitir nota de verdade?

Não. É irregular, e a secretaria de fazenda recusa. O gerador serve para ambiente de homologação, aula e demonstração.

Por que meu validador aceita 00.000.000/0000-00?

Porque a conta matemática fecha. Validadores bem feitos rejeitam sequências repetidas por regra extra.

O gerador produz CNPJ alfanumérico?

Os atualizados, sim, com o cálculo que converte letras em valores antes do módulo 11. Vale ter os dois formatos na base de teste.

Preciso validar no servidor?

Sim. Validação só no navegador é contornada por qualquer chamada direta à API.

Como fica a LGPD em homologação?

Base inteiramente fictícia, sem cópia de produção, e acesso separado. CNPJ gerado, razão social inventada, contato de domínio de teste.

Resumo

CNPJ válido para testes é um número de catorze caracteres com os dois verificadores calculados pelo módulo 11, sem vínculo com empresa alguma, usado para homologar cadastro, nota e integração sem expor dado real. Ele é aceito por qualquer validador local e falha em qualquer consulta oficial, que é o esperado. O conjunto fixo, com válidos, inválidos, sequências repetidas e alfanuméricos, torna o teste repetível; a validação no servidor evita a burla; e a LGPD pede que a produção fique fora da homologação.

Divulgue: WhatsApp Facebook X

Leia também