Gerador e validador de CPF

Para que serve

Quase todo sistema brasileiro pede CPF em algum formulário, e quase todo desenvolvedor precisa preencher esse campo dezenas de vezes por dia enquanto testa uma tela, roda uma suíte automatizada ou popula um banco de homologação. Usar o próprio CPF nesses cenários é desconfortável, porque o número acaba parando em logs, capturas de tela e bases de teste que circulam pela equipe. Usar o de um colega é pior ainda.

O gerador resolve esse problema produzindo números que passam na validação sem pertencer a ninguém. Cada valor é uma combinação aleatória de nove dígitos com os dois verificadores calculados na sequência, exatamente como faria a rotina de conferência de qualquer sistema. Do ponto de vista do código, ele é indistinguível de um CPF real; do ponto de vista cadastral, não existe.

O painel de validação faz o caminho inverso e serve tanto para conferir uma digitação suspeita quanto para entender por que determinado número foi recusado. Ele diz se o cálculo fecha, mostra o número reduzido a dígitos e explica o motivo da rejeição quando há uma: tamanho errado, sequência repetida ou verificadores incompatíveis.

Como funciona o cálculo

O CPF tem onze dígitos. Os nove primeiros formam a base, que identifica o cadastro, e os dois últimos são verificadores calculados a partir dela pelo método conhecido como módulo 11.

1. Primeiro verificador. Multiplique os nove dígitos da base por pesos que começam em 10 e caem de um em um até 2, da esquerda para a direita. Some os nove produtos, multiplique a soma por 10 e tome o resto da divisão por 11. Se esse resto for 10, o dígito é zero; caso contrário, o dígito é o próprio resto.
2. Segundo verificador. Repita a operação com dez dígitos agora: os nove da base mais o primeiro verificador recém-calculado. Os pesos começam em 11 e caem até 2. Mesma regra final: resto 10 vira zero.
3. Regra de exclusão. Antes de qualquer conta, sequências com os onze dígitos iguais são descartadas. Elas fecham o cálculo por coincidência aritmética, mas a Receita Federal não as reconhece, e o validador aqui também não.

Um exemplo com a base 123.456.789: os produtos do primeiro passo somam 210, e 210 vezes 10 dividido por 11 deixa resto 0, então o primeiro verificador é 0. Com a base estendida para 1234567890, a segunda conta devolve 9. O número completo fica 123.456.789-09, que é justamente o exemplo mostrado no campo de validação.

Como usar

1. No painel Gerar, informe quantos números você quer, de 1 a 200.
2. Deixe Formatar com pontuação marcado para receber no formato 000.000.000-00, ou desmarque para obter só os onze dígitos, que é o formato aceito pela maioria das APIs.
3. Clique em Gerar. A lista aparece com um número por linha, pronta para colar em uma planilha ou em um arquivo de carga.
4. Use Copiar para levar tudo para a área de transferência e Limpar para esvaziar a saída.
5. No painel Validar, cole um CPF com ou sem pontuação e clique em Validar ou pressione Enter. O resultado aparece logo abaixo e a mensagem de status explica o motivo em caso de recusa.

Notas técnicas

A geração usa crypto.getRandomValues quando o navegador oferece essa função, com descarte dos valores que cairiam fora da faixa uniforme, para que nenhum dígito seja favorecido. Não há verificação de duplicidade entre os itens de uma mesma lista: em lotes grandes, a repetição é improvável, mas possível. Se o seu teste exige unicidade, aplique um filtro depois de gerar.

O validador confere apenas coerência matemática. Ele não sabe se o número está atribuído a alguém, se a inscrição está regular, suspensa ou cancelada, nem em que região fiscal foi emitida. Essas informações só existem nas bases da Receita Federal e não são consultáveis por uma página estática. Vale lembrar também que um CPF válido no cálculo pode perfeitamente ser um número inexistente, já que a Receita não usou todas as combinações possíveis.

Perguntas frequentes