Gerador de CPF Válido para Testes

O que é um CPF?

O CPF (Cadastro de Pessoa Física) é o documento de identificação fiscal de pessoas físicas no Brasil, emitido pela Receita Federal. Ele possui 11 dígitos no formato XXX.XXX.XXX-XX, onde os dois últimos são dígitos verificadores calculados pelo algoritmo módulo 11.

Como funciona a validação?

Os dígitos verificadores do CPF são calculados usando pesos multiplicadores sobre os 9 primeiros dígitos. O primeiro dígito verificador usa pesos de 10 a 2, e o segundo usa pesos de 11 a 2. O resultado é o resto da divisão por 11: se menor que 2, o dígito é 0; caso contrário, é 11 menos o resto. Todos os CPFs gerados pelo FakeForge passam nessa validação.

Para que serve um gerador de CPF?

Desenvolvedores precisam de CPFs válidos para testar sistemas que validam esse campo (cadastros, formulários de e-commerce, integração com gateways de pagamento e testes automatizados). Usar um CPF real em ambiente de teste viola a LGPD. Geradores criam números fictícios que passam na validação sem pertencer a ninguém.

Estrutura do CPF: os 11 dígitos explicados

O CPF é mantido pela Receita Federal e tem 11 dígitos no formato XXX.XXX.XXX-XX. Os 8 primeiros são o número-base, o 9º indica a região fiscal e os 2 últimos são verificadores.

Algoritmo mod-11 passo a passo

Exemplo com os 9 primeiros dígitos 529.982.247:

1. Multiplique cada dígito pelos pesos 10, 9, 8, 7, 6, 5, 4, 3, 2: 50 + 18 + 72 + 63 + 48 + 10 + 8 + 12 + 14 = 295.
2. Calcule o resto de 295 dividido por 11: 295 mod 11 = 9.
3. Se o resto for menor que 2, o dígito é 0. Senão, é 11 menos o resto: 11 - 9 = 2.
4. Acrescente o 2 ao final e repita com pesos 11, 10, 9, 8, 7, 6, 5, 4, 3, 2 sobre os 10 dígitos: soma 347, resto 6, dígito 11 - 6 = 5.
5. Resultado: 529.982.247-25.

Em Python, a validação completa cabe em poucas linhas:

def valida_cpf(cpf: str) -> bool:
    d = [int(c) for c in cpf if c.isdigit()]
    if len(d) != 11 or len(set(d)) == 1:  # 111.111.111-11 passa no cálculo, mas é rejeitado
        return False
    for i in (9, 10):
        soma = sum(d[j] * (i + 1 - j) for j in range(i))
        resto = soma % 11
        if d[i] != (0 if resto < 2 else 11 - resto):
            return False
    return True

print(valida_cpf("529.982.247-25"))  # True
print(valida_cpf("529.982.247-26"))  # False

Precisa de implementação por linguagem? Veja os guias de Python, Node.js e cURL.

Por que CPF fake é seguro pra testes (LGPD)

A Lei Geral de Proteção de Dados (Lei 13.709/2018) trata o CPF como dado pessoal. Copiar CPFs reais de produção para ambientes de teste, staging ou planilhas de QA amplia a superfície de vazamento e exige base legal para esse uso.

Um CPF gerado pelo algoritmo mod-11 tem o formato correto, mas não foi emitido pela Receita Federal para ninguém, então não identifica uma pessoa natural. Há uma ressalva: como o espaço de números é finito (cerca de 1 bilhão de combinações), um CPF sorteado pode coincidir por acaso com um CPF real. Por isso, nunca use CPF gerado em produção, em consultas à base da Receita Federal ou em qualquer fluxo com efeito jurídico. Em homologação e testes automatizados, o risco é desprezível.

Perguntas Frequentes