Como funciona o Gerador de CPF Válido?
Algoritmo explicado para desenvolvedores e QA engineers.
Se você já tentou testar um formulário com 000.000.000-00 e descobriu que seu validador aceitou sem reclamar, você tem um bug crítico no seu sistema. O CPF brasileiro não é apenas um número de 11 dígitos — ele é um certificado matemático. Os dois últimos dígitos (chamados de dígitos verificadores) são calculados a partir dos nove primeiros usando o algoritmo Módulo 11, o mesmo usado em códigos de barras bancários.
O Algoritmo Módulo 11 passo a passo
O processo de geração de um CPF válido funciona assim:
- 19 dígitos aleatórios entre 0–9 são gerados (ex: 4 7 3 9 8 2 1 6 5).
- 2Calculamos a soma ponderada: d1 × 10 + d2 × 9 + d3 × 8 ... + d9 × 2.
- 3O resultado é dividido por 11. Se o resto for < 2, o 1° verificador = 0. Senão = 11 - resto.
- 4Repetimos o processo agora incluindo o 1° verificador, multiplicando de 11 a 2.
- 5O 2° verificador é calculado da mesma forma. CPF está formado.
// Implementação TypeScript — generateCPF()
const n = Array.from({ length: 9 }, () => Math.floor(Math.random() * 10));
let d1 = 0;
for (let i = 0; i < 9; i++) d1 += n[i] * (10 - i);
d1 = 11 - (d1 % 11);
if (d1 >= 10) d1 = 0;
n.push(d1); // 10° dígito
let d2 = 0;
for (let i = 0; i < 10; i++) d2 += n[i] * (11 - i);
d2 = 11 - (d2 % 11);
if (d2 >= 10) d2 = 0;
n.push(d2); // 11° dígito — CPF completo!Por que nunca usar CPFs reais em testes
É um cenário mais comum do que se imagina: um desenvolvedor que precisa depurar um erro em produção faz um dump do banco de dados de produção para seu ambiente local. Nesse momento, dados de centenas ou milhares de clientes reais estão na máquina de um desenvolvedor — em um laptop vulnerável, possivelmente sem criptografia de disco, talvez em uma rede Wi-Fi pública.
Risco LGPD real: Manter dados pessoais identificáveis (CPF, Nome, Endereço) fora do ambiente de produção sem anonimização formal viola os Artigos 6º e 7º da Lei 13.709/2018. Multas chegam a 2% do faturamento anual, limitadas a R$50 milhões por infração.
A solução é simples: use dados sintéticos gerados por ferramentas como esta. Os CPFs produzidos aqui passam em todos os validadores técnicos sem representar nenhuma pessoa real.
Casos de uso por tipo de projeto
E-commerce e Checkout
Teste o fluxo de CPF no faturamento, validação de identidade e emissão de NF-e sem expor dados de clientes reais.
Fintech e KYC
Popule pipelines de onboarding digital com CPFs válidos para testar integrações com bureaus de crédito em ambiente sandbox.
Automação E2E
Gere fixtures com cpfs únicos por cenário de teste no Cypress, Playwright ou Selenium WebDriver.
Formulários Web
Valide máscaras de input, mensagens de erro e edge-cases como CPFs com dígitos zerados ou iguais.
