Gerador de CPF em Lote

Para que serve gerar CPFs em lote?

Quem trabalha com QA ou desenvolvimento volta e meia esbarra na mesma necessidade de muitos CPFs válidos para encher uma base de testes. Aqui você consegue até 1.000 CPFs distintos num piscar de olhos, cada um com os dígitos verificadores certos.

Vale lembrar que esses números não pertencem a ninguém. São apenas combinações matematicamente válidas, então restrinja o uso a ambientes de teste.

Tudo acontece no seu navegador. Quando terminar, é só copiar a lista ou baixá-la como .txt.

Geração de CPFs em lote para devs e QA

Um gerador de CPF em lote produz dezenas, centenas ou milhares de números válidos do Cadastro de Pessoas Físicas de uma só vez — útil quando um único CPF não basta. Cenários típicos incluem stress test de um validador de documento brasileiro, popular um banco de dados de staging com linhas realistas, exercitar limites de paginação e busca em uma listagem de clientes, demonstrar a vazão de uma rotina de parsing e montar fixtures para suítes automatizadas que simulam dezenas de usuários distintos.

Cada número é produzido com o algoritmo padrão de módulo 11: nove dígitos-base pseudoaleatórios seguidos de dois dígitos verificadores calculados com os pesos decrescentes 10→2 e 11→2. Não repetimos a matemática completa aqui — veja a página /gerador-cpf para o passo a passo — mas a saída desta ferramenta passa em todos os validadores comuns (Faker, Bogus, factory_bot, dry-validation e na maioria das bibliotecas de máscara de front-end).

Evitando duplicatas em lotes grandes

Ao pedir milhares de CPFs, a geração aleatória pura eventualmente produz colisões. O Paradoxo do Aniversário entra em cena antes do esperado: para 100.000 raízes de nove dígitos sorteadas, a probabilidade de pelo menos uma duplicata já é da ordem de 0,5%. A solução padrão é um Set (ou tabela hash) chaveado pela string de onze dígitos — pôr o candidato, checar pertinência, sortear de novo em caso de colisão. Esta ferramenta já deduplica dentro do lote pedido, mas, se você concatenar várias execuções, mantenha o seu próprio conjunto entre rodadas.

Distribuição estatística esperada

Como os nove primeiros dígitos são sorteados uniformemente, cada uma das dez regiões fiscais codificadas pelo nono dígito (DF/GO/MT/MS/TO, Norte, CE/MA/PI, PE/RN/PB/AL, BA/SE, MG, RJ/ES, SP, PR/SC, RS) aparece com probabilidade aproximadamente igual. Se seu teste depende de distribuição geográfica, não confie só no gerador — filtre ou semeie por região.

Boas práticas em mock data

• Nunca reaproveite números reais de funcionários ou clientes — mesmo em dev, um log exposto pode vazar PII.
• Evite sequências triviais como 111.111.111-11 — a maioria dos validadores em produção rejeita CPFs com dígitos repetidos.
• Combine cada CPF gerado com um nome fictício (Faker, Bogus) para que fique óbvio em screenshots que o dado é sintético.
• Marque linhas mock no banco (uma coluna booleana is_synthetic ou um prefixo _test) para que um script futuro de limpeza possa removê-las.

Exemplo prático: paginar uma listagem de 1.000 linhas

// Gera 1.000 CPFs e insere no banco de staging
const cpfs = await fetch('/api/bulk-cpf?count=1000').then(r => r.json())
const rows = cpfs.map((cpf, i) => ({ id: i + 1, cpf, nome: faker.person.fullName() }))
await db.insert('clientes', rows)
// Bate na listagem e valida a paginação
expect(await page.locator('tbody tr')).toHaveCount(25) // tamanho da página
await page.click('[data-testid="next-page"]')
// 40 páginas no total — exercita o limite superior

Limites legais

CPFs gerados satisfazem o algoritmo, mas não estão registrados na Receita Federal. Usá-los em transação real, produto financeiro, benefício público, emissão de NF-e ou contrato vinculante configura fraude de identidade e crime previsto nos arts. 299 e 307 do Código Penal (falsidade ideológica e falsa identidade). A saída desta ferramenta é apenas para testes unitários, mock data, ambientes de treinamento e desenvolvimento de validadores.

Perguntas frequentes

A ferramenta gera duplicatas? Dentro de um mesmo lote, não — cada número é checado contra um Set antes de entrar. Entre lotes separados, a probabilidade de colisão é baixíssima para quantidades pequenas, mas não nula; mantenha seu próprio conjunto se for concatenar rodadas.

Existe um limite por geração? Sim, 1.000 CPFs por requisição. O limite mantém o navegador responsivo e evita travamentos em dispositivos modestos. Para volumes maiores, rode a ferramenta várias vezes ou chame o algoritmo direto no seu script de fixtures.

Posso baixar o resultado como CSV? Sim — o botão Baixar exporta um arquivo de texto puro com um CPF por linha, que importa diretamente em Excel, Google Sheets, psql \copy e na maioria das ferramentas de ETL.

Algum dado sai do meu navegador? Não. A geração acontece inteiramente do lado do cliente em JavaScript — o servidor nunca vê os números.