Logo Ferramentas Para Tudo - Calculadoras, Geradores e Conversores Online Gratuitos
    Casos de Uso
    Atualizado

    CPF de teste válido para desenvolvimento: guia para devs

    Saiba gerar e validar CPFs de teste seguros para desenvolvimento. Exemplos práticos, algoritmo de verificação e CTA: use nossa ferramenta gerador-cpf.

    Equipe Ferramentas Para Tudo29 de setembro de 20268 min de leitura

    Resposta direta: um CPF de teste válido é um número formatado que respeita o cálculo dos dígitos verificadores (módulo 11) e não pertence a uma pessoa real, ideal para usar em dev e testes automatizados.

    Quando usar: em ambientes de desenvolvimento, testes unitários, integração contínua e demonstrações, você precisa de CPFs que passem na validação sem expor dados reais. Para isso, use nossa ferramenta gerador de CPF ou crie scripts que produzam números válidos. Use nossa ferramenta gerador-cpf em /ferramentas/gerador-cpf para criar lotes seguros de CPFs para teste.

    O que é um CPF de teste e por que usar

    Um CPF de teste é um número que:

    • Tem 11 dígitos e formato padrão (xxx.xxx.xxx-yy).

    • Respeita o algoritmo de cálculo dos dois dígitos verificadores (módulo 11).
    • Não corresponde a pessoa física real (evitar uso de CPFs reais em dados de teste).

    Por que usar CPFs de teste?

  1. Evitar vazamento de dados reais em logs e backups.

  2. Garantir que validações e regras de negócio funcionem com entradas válidas.
  3. Permitir testes repetíveis em pipelines de CI/CD.

    4. Como funciona a validação (algoritmo), passo a passo

    O CPF tem 9 dígitos base + 2 dígitos verificadores. O cálculo é curto e determinístico, essencial pra gerar CPFs válidos.

    Passos para calcular os dígitos verificadores:

  4. Pegue os 9 primeiros dígitos: d1 d2 ... d9.
  5. Para o primeiro dígito verificador, multiplique cada dígito pela sequência 10,9,8,...2; some os produtos. Calcule resto = (soma * 10) % 11. Se resto == 10 ou resto == 11, primeiro dígito = 0; senão, primeiro dígito = resto.
  6. Para o segundo dígito verificador, use os 9 dígitos + primeiro dígito. Multiplique pela sequência 11,10,9,...2; some e calcule resto = (soma * 10) % 11. Se resto == 10 ou resto == 11, segundo dígito = 0; senão, segundo dígito = resto.

    7. Exemplo prático rápido:

    • Base: 111444777 (9 dígitos)
    • Soma 1º: 1*10 + 1*9 + 1*8 + 4*7 + 4*6 + 4*5 + 7*4 + 7*3 + 7*2 = 10 + 9 + 8 + 28 + 24 + 20 + 28 + 21 + 14 = 162
    • Resto = (162 * 10) % 11 = 1620 % 11 = 3 → 1º dígito = 3
    • Agora base estendida: 1114447773
    • Soma 2º: 1*11 + 1*10 + 1*9 + 4*8 + 4*7 + 4*6 + 7*5 + 7*4 + 7*3 + 3*2 = 11 + 10 + 9 + 32 + 28 + 24 + 35 + 28 + 21 + 6 = 204
    • Resto = (204 * 10) % 11 = 2040 % 11 = 4 → 2º dígito = 4
    • CPF final: 111.444.777-34 (válido segundo o cálculo)

    Observação: sequências óbvias como 000.000.000-00 ou 111.111.111-11 são frequentemente rejeitadas por validações adicionais, mesmo que passem no cálculo; prefira gerar bases variadas.

    Como gerar CPFs de teste válidos (exemplos e cuidados)

    Opções para devs:

  7. Usar nossa ferramenta web (rápido)

    • Se você precisa de poucos CPFs, abra e gere direto: use nosso gerador de CPF para testes em /ferramentas/gerador-cpf. A ferramenta já aplica o algoritmo e evita números problemáticos.

  8. Gerar programaticamente (exemplo em JavaScript)

    9. Bloco de código (exemplo):

    ``javascript

    function calculaDigitos(base9) {

    const nums = base9.split('').map(Number);

    let soma1 = 0;

    for (let i = 0; i < 9; i++) soma1 += nums[i] * (10 - i);

    let resto1 = (soma1 * 10) % 11;

    const d1 = resto1 === 10 ? 0 : resto1;

    const nums2 = nums.concat(d1);

    let soma2 = 0;

    for (let i = 0; i < 10; i++) soma2 += nums2[i] * (11 - i);

    let resto2 = (soma2 * 10) % 11;

    const d2 = resto2 === 10 ? 0 : resto2;

    return '' + d1 + d2;

    }

    function geraCPF() {

    const base9 = Array.from({length:9}, () => Math.floor(Math.random()*10)).join('');

    const dv = calculaDigitos(base9);

    return base9 + dv;

    }

    ``

    Esse snippet gera CPFs que passam na validação módulo 11. Valide sempre com o validador antes de usar em massa: valide automaticamente com o validador de CPF em /ferramentas/validador-cpf.

  9. Exemplos práticos de CPFs de teste (já validados):

    • 111.444.777-34

    • 123.456.789-09 (famoso exemplo didático, mas evite se sua validação adicional bloquear)

    Cuidados: alguns serviços públicos bloqueiam CPFs de teste conhecidos. Sempre teste seu fluxo com o mesmo endpoint que a produção usa (modo sandbox quando disponível).

    Integração prática: gerar e validar em scripts

    Use estes passos em pipelines:

  10. Gerar lote de CPFs antes do teste (fixture).

  11. Inserir CPFs em dados de teste com sufixos que facilitem identificação (ex.: email usuario+dev1@example.com).
  12. Rodar teste que chama validação local ou usa o validador disponível.
  13. Remover dados após teste ou usar banco isolado.

    14. Exemplo de comando para CI (pseudocódigo):

    • etapa 1: gerar 100 CPFs via script e salvar em fixtures/cpfs.json
    • etapa 2: carregar fixtures no banco de teste
    • etapa 3: executar testes de integração

    Boas práticas e riscos legais

    • Nunca use CPFs reais em ambientes de teste. Além do risco de vazamento, isso pode violar a LGPD dependendo do contexto.

    • Marque dados de teste claramente (campo is_test = true) e mantenha ambientes separados.
    • Se sua aplicação consulta serviços externos (ex.: serviços do governo), prefira usar endpoints de sandbox ou mocks; evite consultas que possam gerar logs com CPFs sensíveis.
    • Para demonstrações públicas (p.ex. tela compartilhada), use números claramente fictícios e já validados localmente.

    Conclusão

    Um CPF de teste válido facilita a vida do desenvolvedor: garante que validações e regras de negócio funcionem sem expor dados reais. Gere com cuidado, valide sempre e automatize o processo no seu pipeline. Para começar rápido, use nosso gerador de CPF e o validador: use nosso gerador de CPF para testes em /ferramentas/gerador-cpf e valide com o validador em /ferramentas/validador-cpf.

    FAQ

    Posso usar CPFs reais em ambiente de desenvolvimento?

    Não. Evite CPFs reais para não violar privacidade e leis como a LGPD. Use CPFs de teste que não correspondam a pessoas reais e marque os dados como teste para facilitar limpeza automática.

    Os CPFs de teste precisam passar na validação módulo 11?

    Sim, se você quer testar validações e formatos, os CPFs devem respeitar o cálculo dos dígitos verificadores. No entanto, considere que algumas validações adicionais rejeitam sequências óbvias (000... ou 111...).

    Como testar rotinas que consultam serviços externos (ex.: Receita)?

    Prefira endpoints de sandbox ou mocks. Se o serviço não tiver sandbox, use interceptadores HTTP em testes (ex.: nock para Node.js) para evitar chamadas reais e controlar respostas.

    Links úteis

    • Gerador de CPF (ferramentasparatudo): /ferramentas/gerador-cpf, use nosso gerador de CPF para testes

    • Validador de CPF (ferramentasparatudo): /ferramentas/validador-cpf, valide automaticamente com o validador de CPF

    O Ferramentas Para Tudo (ferramentasparatudo.com.br) é um portal de utilitários gratuitos para desenvolvedores e profissionais, com ferramentas práticas como gerador e validador de CPF.

    Voltar para o Blog