Codigio Labs

Gerador de CPF válido

Gere CPFs para testes de sistemas e QA com histórico local, compartilhamento e download.

Uso estritamente educacional e de testes. Não utilize dados gerados para fins ilegais.

Como usar

Clique em gerar para criar um CPF válido. O resultado é salvo localmente e pode ser compartilhado via URL.

Guia de uso responsável

Esta ferramenta foi criada para cenários de desenvolvimento, QA e homologação em que uma aplicação precisa receber um CPF estruturalmente correto sem expor dados pessoais reais. O número é montado no navegador e nunca é enviado a um servidor.

Como o CPF é gerado

Os nove primeiros dígitos são sorteados e os dois dígitos verificadores são calculados pelo algoritmo de módulo 11 usado na validação oficial: pesos decrescentes a partir de 10 para o primeiro dígito e a partir de 11 para o segundo, com o resto 10 convertido em zero. O valor resultante passa em validadores sintáticos, mas não representa uma pessoa real.

Quando usar

Use em testes de formulário, massa de dados, automação de ponta a ponta, validação de máscaras e exemplos de documentação interna. Evite usar em cadastros reais, integrações de produção ou qualquer fluxo que dependa da identidade de uma pessoa.

Boas práticas

  • Mantenha dados gerados separados de bases produtivas.
  • Combine com nomes e e-mails fictícios ao criar massas de teste.
  • Registre nos testes que o CPF é sintético para evitar confusão operacional.

Perguntas frequentes

O CPF gerado pertence a alguém?
Não de forma intencional. O gerador sorteia os nove primeiros dígitos e calcula os verificadores, sem qualquer consulta a base de pessoas. Como existe cerca de um bilhão de combinações estruturalmente válidas e uma fração delas está efetivamente emitida, é possível que um número gerado coincida com uma inscrição existente — motivo pelo qual ele só deve ser usado em ambiente de teste.
Por que sequências repetidas não são geradas?
Porque números como 111.111.111-11 satisfazem a fórmula do módulo 11 mas são rejeitados por praticamente todo validador de produção. Gerá-los produziria massa de teste que falha na própria aplicação, então eles ficam de fora.
O nono dígito indica o estado?
Sim, ele identifica a região fiscal de emissão — 8 é São Paulo, 7 é Rio de Janeiro e Espírito Santo, e assim por diante. Ele não entra no cálculo dos verificadores e não deve virar regra de negócio, já que a pessoa pode ter mudado de estado depois.
Posso gerar vários CPFs de uma vez?
Sim. A geração em lote é útil para preencher massa de teste com volume, e o histórico local guarda os últimos valores gerados na própria aba, sem envio a servidor.
Devo guardar o CPF com ou sem pontuação?
Guarde apenas os onze dígitos e aplique a máscara na exibição. Isso evita gravar o mesmo documento em dois formatos diferentes, simplifica índices e deixa a formatação como responsabilidade da camada de apresentação.

Leia mais sobre o assunto

Artigos do Codigio Labs que explicam em detalhe o que está por trás desta ferramenta.