[Community Node] CNPJ HUB — consulta CNPJ com fallback + saída normalizada

Lancei o CNPJ HUB, nó para n8n que consulta CNPJ com fallback automático entre 5 APIs e saída padronizada. Instalação simples e pronta para pipelines de dados B2B.

Pacote no npm
n8n-nodes-cnpj-hub: https://www.npmjs.com/package/n8n-nodes-cnpj-hub npm

APIs suportadas

  • CNPJ.ws

  • CNPJA

  • MinhaReceita

  • BrasilAPI

  • ReceitaWS
    Com fallback, rate limit configurável e dado normalizado opcional.

Como instalar

  • GUI do n8n: Settings → Community Nodes → Install e informe n8n-nodes-cnpj-hub.

  • CLI self-hosted: npm i n8n-nodes-cnpj-hub na pasta da instância.

Exemplos de aplicações reais

  • Enriquecimento de leads B2B. Recebe CNPJ do formulário, puxa razão social, CNAE e porte e grava no CRM.

  • Onboarding de sellers e fornecedores. Valida situação cadastral e CNAE antes de aprovar cadastro.

  • Conferência fiscal de NF-e. Valida CNPJ de entrada e alerta no Slack se estiver irregular.

  • KYB básico para fintech e SaaS. Revalida CNPJ periodicamente e bloqueia features em caso de alteração.

  • Monitoramento de parceiros. Job diário que reconsulta CNPJ e atualiza uma planilha de controle.

{
  "cnpj": "11.222.333/0001-81",
  "razao_social": "Nome da Empresa",
  "nome_fantasia": "Nome Fantasia",
  "situacao": "Ativa",
  "data_abertura": "2009-09-02",
  "porte": "Pequeno",
  "natureza_juridica": "Associação Privada",
  "capital_social": "0.00",
  "atividade_principal": {
    "codigo": "8550301",
    "descricao": "Administração de caixas escolares"
  },
  "endereco": {
    "logradouro": "Rua Garibaldi",
    "numero": "070",
    "complemento": "",
    "bairro": "Vila Rica",
    "cep": "95760000",
    "municipio": "São Sebastião do Caí",
    "uf": "RS"
  },
  "contato": {
    "telefone": "(51) 3635-4333 / (51) 3635-1603",
    "email": "[email protected]"
  },
  "socios": [
    {
      "nome": "Nome do Sócio",
      "cpf_cnpj": "***123456**",
      "qualificacao": "Presidente",
      "data_entrada": "2016-09-29"
    }
  ],
  "atividades_secundarias": [],
  "simples": {
    "optante": false,
    "data_opcao": null,
    "data_exclusao": null
  },
  "_meta": {
    "api_utilizada": "brasilapi",
    "cnpj_consultado": "11222333000181",
    "data_consulta": "2025-08-13T03:48:00.000Z",
    "estrategia": "fallback",
    "data_format": "normalized",
    "original_data": { /* Resposta original da API */ }
  }
}

Observações rápidas

  • Ajuste o rateLimitDelay conforme sua carga. APIs públicas variam em limite e estabilidade.

  • Nota de transparência. BrasilAPI é um projeto comunitário, não oficial do governo.

Curtiu. Faltou algum campo na normalização para seu caso. Me diz que eu avalio colocar no roadmap.

5 Likes

Fantastico!

1 Like

Excelente!

1 Like