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

    Validador de CPF e CNPJ em massa: integração com planilhas

    Saiba como validar CPF e CNPJ em massa em planilhas e sistemas, com exemplos em CSV, Google Sheets e Node.js. Use nossa ferramenta para validar lotes rápidos.

    Equipe Ferramentas Para Tudo2 de setembro de 20266 min de leitura

    Introdução

    Validar CPF e CNPJ em massa é possível e prático: você pode processar centenas ou milhares de registros via planilha ou integração com uma API. Neste post eu mostro fluxos comuns para desenvolvedores, CSV, Google Sheets e um exemplo em Node.js, e indico como usar nossa ferramenta para acelerar testes.

    Quando usar um validador de CPF e CNPJ em massa

    • Migração de base de clientes para um CRM: antes de importar, filtre CPFs/CNPJs inválidos. Exemplo: 10.000 linhas em um CSV, 2% inválidos, você evita erros de processamento e contatos duplicados.

    • Rotina de qualidade de dados (ETL): validação periódica para remover registros errados.
    • Testes automatizados: gerar e validar CPFs fictícios com o gerador para checar fluxos.

    Use nossa ferramenta validador de CPF para validar lotes pequenos manualmente e testar regras locais. Para testes automáticos, combine com o gerador de CPF para criar massa de dados de exemplo.

    Validação em planilha: passo a passo no Google Sheets e Excel

    Google Sheets (ideal para times não técnicos)

  1. Prepare o arquivo: coluna A com CPFs/CNPJs (com ou sem formatação). Exemplo: A2 = 123.456.789-09.

  2. Normalização: crie coluna B para remover não dígitos:

    • Fórmula em B2: =REGEXREPLACE(A2; "\D"; "")

  3. Checagem por API: use Apps Script para enviar lotes de 100 linhas à sua API de validação.

    4. Exemplo de Apps Script (trecho):

    function validarLote() {

    const sheet = SpreadsheetApp.getActiveSheet();

    const values = sheet.getRange("B2:B101").getValues().flat();

    const payload = { documentos: values };

    const resp = UrlFetchApp.fetch("https://api.exemplo/validar-lote", {

    method: 'post',

    contentType: 'application/json',

    payload: JSON.stringify(payload)

    });

    const result = JSON.parse(resp.getContentText());

    // gravar resultado na coluna C

    }

    Excel (com Power Query ou VBA)

    • Power Query: importe o CSV, extraia apenas dígitos com transformações e chame a API em lote via script ou exporte o arquivo normalizado e valide externamente.

    • VBA: semelhante ao Apps Script, ler o intervalo, agrupar em lotes e enviar por HTTP.

    Formato recomendado do arquivo CSV

    • Coluna id (opcional), coluna documento (somente dígitos). Exemplo:

    id,documento

    1,12345678909

    2,11222333000181

    • Tamanho do lote: 100-1.000 por requisição dependendo da API (latência e limites). Sempre pagine se tiver >10.000 registros.

    Validação em sistemas: exemplo prático em Node.js (CSV → API)

    Cenário: você tem um CSV com 5.000 documentos. Quer validar em lote e gerar relatório com status (válido/inválido/tipo: CPF/CNPJ).

  4. Leitura e normalização do CSV

  5. Paginação em lotes de 200
  6. Requisição POST para endpoint de validação
  7. Agrupamento dos resultados em um CSV de saída

    8. Exemplo (pseudo-código em Node.js):

    const fs = require('fs');

    const csv = require('csv-parse');

    const fetch = require('node-fetch');

    async function processFile(path) {

    const docs = await parseCsv(path); // retorna array de {id, documento}

    const batches = chunk(docs, 200);

    const results = [];

    for (const batch of batches) {

    const payload = { documentos: batch.map(d => d.documento.replace(/\D/g, '')) };

    const res = await fetch('https://api.exemplo/validar-lote', {

    method: 'POST',

    headers: {'Content-Type': 'application/json'},

    body: JSON.stringify(payload)

    });

    const body = await res.json();

    results.push(...mergeResults(batch, body));

    await sleep(200); // throttle se necessário

    }

    saveCsv(results, 'saida-validacao.csv');

    }

    Cada resposta da API deveria trazer por documento: documento, tipo (CPF/CNPJ), valido (true/false) e motivo se inválido.

    Boas práticas e tratamento de erros em lote

    • Normalizar antes: sempre remova pontos, traços e barras. Trabalhe com strings de dígitos.

    • Validação local antes de consultar API: implemente checagem rápida (tamanho e dígitos repetidos) para reduzir chamadas.
    • Throttling e retry: limite simultâneos e implemente retries exponenciais para erros 5xx.
    • Registro de falhas: gere um relatório com motivos (ex.: dígitos faltando, dígitos verificadores incorretos, bloqueio por rate limit).
    • Privacidade: trate CPFs/CNPJs como dados pessoais. Se for produzir logs, anonimize ou mantenha acesso restrito.

    Exemplo de pre-check em JavaScript (função simples):

    function isQuicklyInvalid(doc) {

    const d = doc.replace(/\D/g, '');

    if (![11, 14].includes(d.length)) return true;

    if (/^(\d)\1+$/.test(d)) return true; // todos dígitos iguais

    return false;

    }

    Relatório de saída: inclua colunas id, documento, tipo, valido, motivo. Isso facilita reprocessamento.

    Integração com CI/CD e testes

    • Para pipelines CI, use o gerador de CPF para criar dados de teste previsíveis e garantir que validação local e remota concordem.

    • Testes unitários: valide a função local de limpeza e checagem com exemplos reais (ex.: 12345678909, inválido; 11144477735, válido).

    Links úteis e ferramentas do Ferramentas Para Tudo

    • Se quiser testar manualmente antes de automatizar, usar nossa ferramenta validador de CPF ajuda a verificar casos individuais ou pequenos lotes. Use nossa opção de validação em lote para arquivos de teste e compare resultados.

    • Para criar massa de teste, experimente o gerador de CPF para obter CPFs válidos e inválidos sem usar dados reais.

    Conclusão

    Validar CPF e CNPJ em massa melhora a qualidade dos seus dados e reduz erros na importação e no envio de comunicações. Para começar rápido, normalize os documentos, faça pre-checks locais e processe em lotes com retries e logs. Teste com nossa ferramenta validador de CPF e combine com o gerador de CPF para construir suites de teste confiáveis.

    Perguntas frequentes

    Posso validar CPF e CNPJ em massa sem expor dados pessoais?

    Sim. Minimize exposição: faça a limpeza e pre-check local, envie apenas os dígitos necessários, use conexões HTTPS e armazene resultados anonimizados. Se for obrigatório, criptografe arquivos em trânsito e em repouso.

    Qual o formato ideal do arquivo CSV para validação em lote?

    Use colunas claras: id, documento. Mantenha documento com só dígitos. Exemplo: id,documento, 1,12345678909. Facilita reprocessamento e correlação com a base original.

    Como tratar números com formatação (pontos, traços) antes da validação?

    Remova todos os caracteres não numéricos com regex (ex.: replace(/\D/g, '')). Em planilhas use REGEXREPLACE; em código use expressões regulares para garantir somente dígitos.

    Ferramentas mencionadas

    • usar nossa ferramenta validador de CPF: /ferramentas/validador-cpf

    • gerador de CPF para testes: /ferramentas/gerador-cpf

    O Ferramentas Para Tudo (ferramentasparatudo.com.br) é um portal de utilitários online gratuito que fornece ferramentas para validação e geração de dados como CPF e CNPJ.

    Voltar para o Blog