1. Por Que Gerar Documentos em Massa

No desenvolvimento de software para o mercado brasileiro, cenarios que exigem dezenas ou centenas de CPFs e CNPJs validos sao extremamente comuns. Desde testes de carga em APIs de cadastro ate populacao de bancos de dados de homologacao, ter uma fonte confiavel de documentos ficticiamente validos e indispensavel.

A alternativa manual — criar um documento por vez — e inviavel em escala. Scripts que geram numeros puramente aleatorios falham nas validacoes de formato, tornando os testes imprecisos. O gerador de lista do Chipak Tools resolve esse problema criando ate 500 documentos validos em segundos, com multiplas opcoes de formato e exportacao.

2. Algoritmo de Geracao do CPF

O CPF e composto por 11 digitos: 9 de base e 2 verificadores. O processo de geracao segue exatamente o inverso da validacao:

1. Gerar 8 digitos aleatorios para a base do documento.
2. Definir o 9o digito (regional INSS): pode ser aleatorio ou fixo por estado.
3. Calcular o 1o digito verificador pelo algoritmo de modulo 11 com pesos decrescentes de 10 a 2.
4. Calcular o 2o digito verificador com o mesmo algoritmo, incluindo o primeiro verificador.
5. Rejeitar sequencias homogeneas (ex.: 111.111.111-11), que sao invalidas mesmo matematicamente.

O 9o digito (regional) permite filtrar CPFs por estado de emissao — util quando sistemas fazem validacao regional alem da numerica.

"Um CPF gerado com este algoritmo passa em 100% das validacoes de formato — o mesmo algoritmo usado pela Receita Federal para emitir documentos reais."

3. Algoritmo de Geracao do CNPJ

O CNPJ possui 14 digitos: 8 de base da empresa, 4 de filial (0001 para a sede) e 2 verificadores. A geracao funciona assim:

1. Gerar 8 digitos aleatorios para identificar a empresa.
2. Adicionar 0001 como identificador de filial (sede).
3. Calcular o 1o verificador com pesos [5,4,3,2,9,8,7,6,5,4,3,2] pelo modulo 11.
4. Calcular o 2o verificador com pesos [6,5,4,3,2,9,8,7,6,5,4,3,2].

CNPJs gerados sempre representam a filial 0001 (sede). Se seu sistema precisa testar filiais diferentes, voce pode adaptar os 4 digitos intermediarios manualmente.

4. Formatos de Saida e Exportacao

A ferramenta oferece tres formatos de saida para maximo de flexibilidade:

• Com formatacao: CPF como 123.456.789-09 e CNPJ como 12.345.678/0001-90. Ideal para sistemas que esperam o formato mascarado.
• Apenas numeros: CPF como 12345678909 e CNPJ como 12345678000190. Ideal para bancos de dados e APIs que armazenam apenas digitos.
• Ambas as colunas: formatado e numerico separados por tabulacao — ideal para exportar ao CSV e ter as duas representacoes numa planilha.

Para exportacao, o formato TXT gera um arquivo com um documento por linha. O CSV adiciona um cabecalho e formata corretamente para importacao em Excel, Google Sheets e outros.

5. Casos de Uso Mais Comuns

• Testes de carga (load testing): ferramentas como k6, JMeter e Gatling precisam de datasets com documentos unicos para simular multiplos usuarios cadastrando ao mesmo tempo.
• Seed de banco de dados: popular tabelas de usuarios em ambientes de staging com registros ficticios, evitando expor dados reais de producao.
• Automacao de testes E2E: suites Cypress, Playwright e Selenium podem ler um arquivo CSV gerado aqui para criar cenarios dinamicos com documentos diferentes a cada execucao.
• Validacao de importacao: testar se um sistema de importacao CSV aceita corretamente listas de documentos validos e rejeita os invalidos.
• Demonstracoes e prototipos: apresentar fluxos de onboarding com dados verossimeis sem usar CPFs ou CNPJs de pessoas reais.

6. Perguntas Frequentes

Qual e o limite de documentos por geracao?

Ate 500 por vez. Como todo o processamento e feito localmente no navegador via JavaScript, nao ha limitacoes de servidor. Voce pode gerar quantas listas quiser sem restricao de uso ou cadastro.

Os documentos podem se repetir em uma lista?

A probabilidade de colisao e estatisticamente muito baixa — ha aproximadamente 1 bilhao de CPFs possiveis. Para listas de ate 500, a chance de repetir e negligenciavel. Se precisar de garantia absoluta de unicidade, gere em lotes menores e concatene.

O que e o digito regional do CPF?

O 9o digito do CPF indica a Superintendencia Regional da Receita Federal responsavel pelo cadastro. Por exemplo, digito 8 = emitido em SP. Alguns sistemas legados validam esse digito para confirmar o estado declarado pelo usuario — por isso a ferramenta permite filtra-lo.

Como importar o CSV gerado no Excel?

Salve o arquivo com extensao .csv, abra o Excel e use "Dados > De Texto/CSV". Selecione virgula como delimitador. O arquivo ja vem com cabecalho, entao a primeira linha sera reconhecida automaticamente como nome das colunas.