Gerador de CNPJ válido para teste: como usar rápido
Precisa de um gerador de CNPJ válido para teste? Guia rápido pra devs: como gerar CNPJ com dígitos verificadores e usar em testes locais. usar-ferramenta-gerador-cnpj
O gerador de CNPJ válido para teste cria números que respeitam o formato e os dígitos verificadores, ideal pra preencher bases de dados de desenvolvimento e automatizar testes. Use nossa ferramenta para gerar CNPJs prontos: usar-ferramenta-gerador-cnpj.
O que é um CNPJ válido (e por que você precisa disso em testes)
CNPJ válido significa: 14 dígitos no formato NN.NNN.NNN/NNNN-NN com dois dígitos verificadores calculados por algoritmo (módulo 11). Em desenvolvimento você precisa de CNPJs válidos para testar validação, relatórios e integração com APIs que checam formato. Gerar números inválidos pode fazer seus testes passarem quando não deveriam, ou falharem por erro de formato.
Como o dígito verificador do CNPJ é calculado (resumo técnico)
O cálculo usa dois passos com pesos específicos (módulo 11):
- Primeiro dígito verificador: aplicar pesos de 5 a 2 e depois 9 a 2 sobre os primeiros 12 dígitos; somar, calcular resto e converter para o dígito.
- Segundo dígito verificador: repetir o processo incluindo o primeiro dígito calculado.
Aqui está um pseudocódigo simples (útil pra entender ou implementar rapidamente):
``
function calculaDigitos(cnpj12):
pesos1 = [5,4,3,2,9,8,7,6,5,4,3,2]
soma1 = sum(cnpj12[i] * pesos1[i] for i in 0..11)
resto1 = soma1 % 11
dig1 = (resto1 < 2) ? 0 : 11 - resto1
cnpj13 = cnpj12 + [dig1]
pesos2 = [6,5,4,3,2,9,8,7,6,5,4,3,2]
soma2 = sum(cnpj13[i] * pesos2[i] for i in 0..12)
resto2 = soma2 % 11
dig2 = (resto2 < 2) ? 0 : 11 - resto2
return dig1, dig2
``
Passo a passo: gerar CNPJ válido para teste
Se preferir evitar implementar, use nossa ferramenta: usar-ferramenta-gerador-cnpj, ela gera CNPJs válidos em lote ou um a um.
Exemplo prático (número real gerado para desenvolvimento)
Vamos gerar um CNPJ de exemplo passo a passo:
- Dígitos iniciais (aleatórios): 12.345.678
- Filial: 0001
- Junta: 123456780001
- Aplicando o cálculo obtemos dígitos verificadores: 95
- CNPJ final: 12.345.678/0001-95
Use esse padrão nos seus testes locais. Não use em produção nem em comunicação com governo, são apenas dados sintéticos.
Boas práticas ao usar CNPJs gerados em dev e QA
- Separe bases de dados de teste e produção; nunca insira dados gerados em produção.
- Marque registros sintéticos com uma flag "is_test" para evitar confusão em análises.
- Para testes de integração com terceiros que validam contra base oficial, prefira ambientes de sandbox ou mocks.
- Gerações em lote: padronize a filial (0001) e documente o algoritmo usado, assim outros devs reproduzem o teste.
Conclusão
Gerar CNPJ válido para teste é rápido: ou implemente o algoritmo de módulo 11 ou use nossa ferramenta pronta. Para criar CNPJs válidos agora e evitar dor de cabeça nos seus testes, acesse usar-ferramenta-gerador-cnpj.
FAQ
Posso usar CNPJs gerados em produção?
Não. CNPJs gerados são sintéticos e não representam empresas reais. Nunca insira dados falsos em ambientes produtivos, pode quebrar integrações e levantar problemas legais.
Como testar validação de CNPJ automaticamente nos meus testes unitários?
Automatize o algoritmo de validação (módulo 11) em uma função ou use mocks que retornam sucessos/erros. Gere casos de teste: CNPJ válido, dígito errado, formato inválido e campo nulo.
O gerador de CNPJ precisa obedecer regras regionais (filiais)?
Para a maioria dos testes não. Use filial padrão (0001) a menos que você esteja testando lógica que depende do número da filial. Em casos específicos, simule as variações necessárias.