CNPJ BrasilValidador CNPJ Alfanumérico
CNPJ 2026 · Validator · Migration checker

Valide bases para o novo CNPJ antes que uma regra antiga vire erro em produção.

O Validador de CNPJ Alfanumérico da JM Forge já está disponível na Apify. Ele valida CNPJs numéricos e alfanuméricos em lote, calcula os dígitos verificadores, aponta erros e duplicados e entrega um resumo de migração para listas, texto, JSON e CSV.

Validação estrutural não confirma existência, titularidade, situação cadastral ou regularidade de uma inscrição. Para valores vigentes, consulte sempre a aba Pricing do Actor na Apify.

O problema

O novo formato não quebra apenas uma regex.

Sistemas históricos frequentemente assumem que CNPJ significa “14 dígitos”. O novo formato mantém 14 posições, mas permite letras nas 12 primeiras. Isso pode afetar importadores, schemas, bancos, APIs, ETLs, ERPs, CRMs e validações frontend/backend.

Regex

Detecte validações só-numéricas

Use registros reais ou de teste para verificar se a base que chega ao seu workflow está estruturalmente preparada.

Data quality

Separe erro de formato de erro de DV

O output informa tamanho, caracteres, dígitos verificadores e códigos estruturados de erro por registro.

Migration

Meça a base antes de migrar

O resumo consolida válidos, inválidos, formatos, duplicados, fontes de entrada e problemas mais frequentes.

Entradas

Use a base do jeito que ela já existe.

  • Lista direta de CNPJs
  • Texto livre com candidatos a CNPJ
  • Objetos JSON com campo configurável
  • CSV com coluna configurável
  • Vírgula ou ponto-e-vírgula no CSV
  • Letras minúsculas normalizadas para maiúsculas
Para cargas críticas, prefira entradas estruturadas como lista, JSON ou CSV. Extração de texto livre é uma conveniência heurística.
Exemplo

Numérico e alfanumérico na mesma execução.

{
  "cnpjs": [
    "00.000.000/E08G-12",
    "12.ABC.345/01DE-35",
    "47.960.950/0001-21"
  ],
  "maxResults": 10000
}

O Actor preserva o valor original, normaliza a inscrição, identifica o formato, calcula os DVs e registra o veredito de cada item.

Output

Um veredito por registro — e um resumo para a migração.

O Dataset separa os resultados individuais do resumo da execução. Isso permite corrigir linhas específicas e, ao mesmo tempo, enxergar a condição geral da base.

Campo / blocoO que respondeUso
normalizedCnpjRepresentação normalizada sem máscara.Comparação, dedupe e integração.
formatnumeric, alphanumeric ou não classificado.Inventário de migração.
checkDigitsValidSe os dígitos verificadores conferem com o cálculo implementado.Validação estrutural.
validationErrorsProblemas estruturados por registro.Correção e auditoria.
duplicateSe o valor normalizado já apareceu na execução.Qualidade de base.
migrationReportAgregações da execução no RUN_SUMMARY.Diagnóstico de migração.
Relatório de migração

O resumo é gratuito.

O RUN_SUMMARY inclui o migrationReport sem cobrança de evento. Ele pode consolidar quantos registros foram analisados, válidos, inválidos, numéricos, alfanuméricos, duplicados e quais problemas apareceram com mais frequência.

O relatório valida a base fornecida. Ele não certifica que ERP, API, banco, frontend ou qualquer outro software do cliente aceite o novo formato.
Sem dependência externa

Validação determinística e reproduzível.

  • Sem consulta cadastral
  • Sem API externa no fluxo de validação
  • Sem navegador
  • Sem IA no veredito
  • Cálculo de DV implementado como lógica pura

Isso reduz latência, custo e dependência de disponibilidade de terceiros para a etapa de validação estrutural.

Quando usar

Validação de dados e consulta cadastral são produtos diferentes.

Use o Validator quando a pergunta é “este valor tem estrutura e DV compatíveis?”. Use o flagship de consulta quando a pergunta é “qual empresa está associada a este CNPJ e quais dados públicos estão disponíveis?”.

FAQ

O que este Actor faz — e o que não faz.

Ele valida CNPJ numérico antigo também?

Sim. O Actor foi publicado para validar os dois formatos na mesma ferramenta.

Ele confirma que uma empresa existe?

Não. O veredito é estrutural. Existência, titularidade e situação cadastral exigem consulta a fontes cadastrais.

Posso usar CSV?

Sim. O Actor aceita CSV com coluna configurável, além de lista direta, texto livre e registros JSON.

Qual é o limite por execução?

A documentação atual informa até 50.000 resultados por execução. Verifique a página do Actor antes de workloads críticos porque limites e pricing podem evoluir.

Quanto custa?

A página da Apify mostra preço a partir de US$0,10 por 1.000 resultados de validação. A aba Pricing da Apify é sempre a referência autoritativa para o valor vigente.

Publicado na Apify

Tem uma base para testar?

Comece com uma amostra, confira os erros estruturados e o relatório de migração e depois aumente o volume conforme a necessidade.