@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 — [email protected]

Licença

MIT