CNPJ em Lote 🇧🇷 — Saúde do Fornecedor e Monitor de Mudanças (LGPD-safe)

Desenvolvido e mantido por Guilherme Kodama · GitHub: github.com/guilhermeKodama

📬 Vende para o governo? O Radar Vending Público junta licitações e diários oficiais de máquinas de café, snack e água e manda só o que importa no seu e-mail, todo dia. Ver amostra e planos · Plano Fundador — R$ 29/mês

Cole uma lista de CNPJs (do jeito que vier: planilha, e-mail, CSV) e receba, para cada empresa, o cadastro da Receita Federal + um veredito pronto: APTO / ATENÇÃO / BLOQUEAR, com os motivos. Agende e ele avisa só o que mudou desde a última vez.

Fonte: dados abertos do CNPJ da Receita Federal via BrasilAPI (com fallback automático para CNPJ.ws pública). Sem login, sem chave, sem CAPTCHA.

Pra quem é

• Compras / suprimentos: checar fornecedores antes de pagar ou contratar (situação cadastral, falência, empresa recém-aberta, MEI acima do teto, CNAE incompatível).
• Financeiro / crédito: triagem de clientes PJ em lote.
• Contabilidades e BPO: monitorar a carteira de clientes toda semana.
• Licitantes e órgãos públicos: conferir habilitação básica de participantes.

O que tem de diferente

• Veredito, não só dados: statusFornecedor + listas bloqueios e alertas (situação ≠ ATIVA, situação especial, falência/liquidação/recuperação judicial na razão social, idade mínima configurável, MEI, capital < R$ 1 mil, endereço sem número, CNAE fora do esperado).
• Monitor de mudanças: com onlyChanges + stateKey, cada execução compara com a foto anterior e devolve só CNPJs novos ou alterados, com campo mudancas (antes → depois). Agende + webhook = alerta automático.
• Entrada bagunçada OK: extrai CNPJs de qualquer texto, remove duplicados, recupera zeros à esquerda que o Excel comeu, valida dígito verificador e lista os inválidos.
• Pronto para o CNPJ alfanumérico (Receita, a partir de jul/2026): validação do novo formato.
• Fallback de fonte + backoff: se a BrasilAPI limitar (HTTP 429), espera e/ou usa CNPJ.ws, sem perder linhas.
• LGPD-safe por padrão: nomes e CPFs de sócios pessoa física nunca são exportados (só qtdSocios, qtdSociosPF e sócios PJ). Em MEI / empresário individual, CPF na razão social é removido e e-mail/telefone do titular não saem.

Entrada

Campo	Descrição
cnpjs	Lista, um por linha, com ou sem pontuação
cnpjText	Cole qualquer texto; os CNPJs são extraídos
cnpjFileUrls	URLs públicas de CSV/TXT (ex.: Google Sheets publicado)
expectedCnaePrefixes	Ex.: ["4721","5620"] — alerta se nenhum CNAE bater
minCompanyAgeYears	Idade mínima (padrão 1)
onlyChanges, stateKey	Modo monitor
onlyActive, ufs	Filtros de saída
includeContacts	Telefone da PJ (nunca para MEI/individual)
maxItems, concurrency, delaySeconds	Limites e ritmo

Exemplo — fornecedores de alimentação, monitor semanal:

{"cnpjText":"12.345.678/0001-95\n98765432000110", "expectedCnaePrefixes":["4721","4729","5620"],
 "minCompanyAgeYears":2, "onlyChanges":true, "stateKey":"fornecedores-alimentacao"}

Saída (exemplo resumido)

{"cnpjFormatado":"92.772.821/0001-64","razaoSocial":"S.A. (VIACAO AEREA RIO-GRANDENSE) - FALIDA",
 "situacaoCadastral":"ATIVA","statusFornecedor":"BLOQUEAR","bloqueios":["Razão social indica FALÊNCIA"],
 "alertas":[],"cnaePrincipal":"5111-1/00","municipio":"PORTO ALEGRE","uf":"RS","qtdSocios":2,
 "mudancas":[],"primeiraVezNoMonitor":true,"fonte":"BrasilAPI"}

Campos completos: razão social, nome fantasia, matriz/filial, situação e data, motivo, situação especial, início de atividade, idade, natureza jurídica, porte, capital social, CNAE principal + secundários, Simples/MEI, último regime tributário, endereço completo, código IBGE, telefones (PJ), contagem de sócios, sócios PJ, veredito, mudanças, fonte, data da coleta. Também há a chave RESUMO no key-value store com os totais da execução.

Limites honestos

• A base aberta da Receita é atualizada mensalmente; mudanças aparecem com essa defasagem.
• A BrasilAPI não devolve e-mail; o telefone vem quando a Receita tem.
• Não é consulta oficial de regularidade fiscal (CND/FGTS) — é triagem cadastral.
• Razão social de MEI/empresário individual costuma conter o nome do titular: é dado público do registro, exportado sem CPF.

Uso responsável

Dados públicos de pessoas jurídicas (Lei 12.527/2011 e política de dados abertos da Receita). Não use para spam nem para tratar dados de pessoas físicas sem base legal (LGPD).

---

English summary

Brazil CNPJ Bulk Lookup — Supplier Health & Change Monitor. Paste any list of Brazilian company tax IDs (CNPJ, including the new 2026 alphanumeric format) and get Receita Federal registry data plus a ready verdict: APTO (OK) / ATENCAO (warning) / BLOQUEAR (block) with reasons (inactive status, special status, bankruptcy/liquidation in the legal name, company age, MEI, tiny capital, missing address number, unexpected CNAE). Schedule it with onlyChanges to receive only new or changed companies, with before/after diffs. Messy input is fine (dedupe, check-digit validation, Excel leading-zero recovery). Sources: BrasilAPI with automatic CNPJ.ws fallback and 429 backoff. Privacy-first: individual partners' names/CPFs are never exported; individual-owner companies (MEI) never expose contact data.