cnpj-biz-api

n8n community node for CNPJ.biz API v2 — Search Brazilian companies by CNPJ, filter by activities, location, legal nature, and more.

Package Information

Downloads: 0 weekly / 54 monthly
Latest Version: 0.0.3
Author: Gustavo José Melo

Available Nodes

CNPJ.biz icon
CNPJ.biz
Consultar dados de empresas brasileiras via API CNPJ.biz v2

Documentation

@gustavojosemelo/n8n-cnpj-biz-api

n8n community node para a API CNPJ.biz v2 — Consulte dados de empresas brasileiras diretamente nos seus workflows n8n.

Recursos

  • Empresa — Buscar por CNPJ, contar por filtro, listar com dados completos
  • Atividade (CNAE) — Listar e buscar atividades econômicas
  • Natureza Jurídica — Listar e buscar naturezas jurídicas
  • Localidade — Listar e buscar países, estados e cidades
  • Bairro — Listar e buscar bairros por localidade
  • Conta — Consultar saldo de créditos

Instalação

Via n8n Community Nodes

  1. Acesse Settings → Community Nodes
  2. Instale: @gustavojosemelo/n8n-cnpj-biz-api

Via npm (self-hosted)

cd ~/.n8n
npm install @gustavojosemelo/n8n-cnpj-biz-api

Credencial

Você precisa de uma API Key do CNPJ.biz. Cadastre-se em cnpj.biz para obter sua chave.

Na configuração de credenciais do n8n, selecione CNPJ.biz API e cole sua chave.

Uso

Buscar Empresa por CNPJ

Informe o CNPJ (apenas números) e opcionalmente inclua filiais.

Listar Empresas por Filtro

Use o campo Filtros (JSON) para montar filtros avançados. Exemplo:

{
  "atividades": [365, 1361],
  "atividade_tipo": ["principal", "secundaria"],
  "situacao": ["ativa"],
  "porte_empresa": ["ME", "EPP"],
  "localidades": [
    { "tipo": "cidade", "cidade": "Campina Grande", "estado": "PB", "pais": "BR" }
  ],
  "ddd": ["83"]
}

Campos de filtro disponíveis

Campo Tipo Exemplo
atividades number[] [365, 1361]
atividade_tipo string[] ["principal", "secundaria"]
natureza_juridica number[] [4, 36]
tipo string[] ["1", "2"]
porte_empresa string[] ["MEI", "ME", "EPP", "DEMAIS"]
situacao string[] ["ativa"]
regime_tributario string[] ["Simples Nacional", "Lucro Real"]
capital_minimo string "1.000,00"
capital_maximo string "1.000.000,00"
razao_fantasia string[] ["ltda", "confeitaria"]
localidades object[] Ver exemplo acima
bairros object[] [{"bairro": "Centro", "cidade": "SP", "estado": "SP"}]
cep string[] ["02020-000"]
ddd string[] ["11"]
data_abertura_inicio string "18/01/2020"
data_abertura_fim string "20/06/2023"
contato string "telefoneoucelularouemail"
avancado string[] ["numero", "email", "sememailcontab", "exportei"]

Autor

Gustavo José Melo — gustavo@universonext.com.br

Licença

MIT

Discussion