Como consultar CNPJ e inscrição estadual no n8n?

No n8n auto-hospedado, instale o nó da comunidade n8n-nodes-fiscalapi: ele já tem as operações de CNPJ e de inscrição estadual e só pede a chave de API. No n8n Cloud, ou se o nó não aparecer, o nó HTTP Request faz a mesma consulta com o header X-API-Key.

• Custo: 1 consulta por chamada, de R$ 0,025 a R$ 0,67 conforme o plano (tabela).
• Grátis para testar a API: 10 consultas por mês de IE em um estado e de CNPJ; a consulta nos 27 estados usada neste guia é paga (condições).
• Comece: crie a conta e a chave de API.

Caminho 1: nó da comunidade n8n-nodes-fiscalapi

Instalar

1. Em Settings > Community Nodes, clique em Install.
2. Digite o nome do pacote: n8n-nodes-fiscalapi.
3. Aceite o aviso sobre nós da comunidade e clique em Install.

Só contas Owner ou Admin instalam nós da comunidade. No n8n Cloud, só aparecem nós da comunidade verificados pela n8n; se o FiscalAPI não aparecer na busca de nós da sua instância, use o caminho 2. Detalhes na documentação do n8n.

Criar a credencial

1. Crie a chave de API no painel da FiscalAPI, em Chave API.
2. No n8n, crie uma credencial FiscalAPI API e cole a chave em API Key. Ela vai no header X-API-Key.

O teste da credencial chama um endpoint gratuito e não gasta consulta.

Operações

O nó também tem certidões (CND estadual, CND Federal, CNDT, CRF/FGTS), XML de NF-e com certificado, SIGEF, CNIR e perfil do produtor. A lista completa está no README do pacote.

Exemplo: inscrição estadual de uma lista de CNPJs

1. Google Sheets (ou Read/Write Files from Disk + Extract from File): uma linha por CNPJ, com a coluna cnpj.
2. FiscalAPI: Resource State Registration, Operation Get in All States, Document Type CNPJ, Document {{ $json.cnpj }}.
3. Split Out no campo results (um item por estado) e outro Split Out no campo results de novo (um item por inscrição).
4. Google Sheets: grave inscricao_estadual, uf_ie e situacao_ie de cada item.

Para os dados da Receita Federal do mesmo CNPJ, acrescente um nó FiscalAPI com Resource Company, Operation Get, CNPJ {{ $json.cnpj }}. A razão social fica em {{ $json.result.razao_social }}. Deixe Force Fresh Data desligado: ligado, a consulta vai ao vivo na Receita e conta como 3 consultas.

Caminho 2: nó HTTP Request

Funciona em qualquer n8n, inclusive no Cloud.

1. Adicione um nó HTTP Request.
2. Method: GET.
3. URL: https://api.fiscalapi.com.br/api/consultar-ie-todos (ou https://api.fiscalapi.com.br/api/consultar-cnpj para os dados da Receita).
4. Authentication: Generic Credential Type > Header Auth. Na credencial, Name X-API-Key e Value com a sua chave.
5. Ligue Send Query Parameters e adicione o parâmetro Name cnpj, Value {{ $json.cnpj }}.
6. Em Options > Batching, use Items per Batch 1 e Batch Interval de acordo com o plano (tabela abaixo).

A resposta tem o mesmo formato descrito em Consultar IE em todos os estados e Consultar CNPJ.

Espera entre chamadas

O limite é por minuto e por conta, somando todas as chaves.

No HTTP Request, o intervalo vai em Batching. No nó FiscalAPI, ponha um Loop Over Items com tamanho 1 e um nó Wait depois da consulta.

Erros

• 402: acabaram as consultas do mês e não há recarga. Repetir não adianta; pare o workflow e avise alguém.
• 429: passou do limite por minuto. O Retry On Fail do n8n não lê o header Retry-After: espera um intervalo fixo e curto. A proteção é o intervalo entre chamadas (Batching ou Wait); o Retry On Fail só cobre um 429 eventual.
• 400: documento ausente ou sem dígitos. Corrija o dado; repetir não muda o resultado.
• 502 e 503: a fonte do estado não respondeu. Tente de novo mais tarde.

A consulta nos 27 estados não confere o dígito verificador do CNPJ: número digitado errado é consultado e cobrado. Se a lista vem de digitação manual, valide os CNPJs antes (num nó Code, por exemplo).

Para seguir o workflow mesmo com erro, use On Error > Continue (using error output) nas configurações do nó e trate a saída de erro à parte.

Na consulta nos 27 estados, confira o campo complete: false quer dizer que algum estado não respondeu, e uma lista vazia ali não prova que não há IE.

Quanto custa

Valores por consulta dentro da franquia mensal. CNPJ ao vivo na Receita (force_fresh) conta como 3 consultas. Resposta com erro HTTP (400, 402, 429, 500) não é cobrada. Cada execução do workflow que chega ao nó é uma nova consulta: cuidado com gatilhos que rodam sozinhos (Schedule, Webhook) sobre a mesma lista. Veja Planos e limites.

Grátis para testar: conta que nunca assinou plano, sem recarga e com e-mail confirmado, tem 10 consultas por mês de IE em um estado (Get by State) e de CNPJ da base mensal (Company > Get), no painel e pela API. A consulta nos 27 estados e o CNPJ ao vivo usam plano ou recarga. Criar conta.

Perguntas frequentes

Existe nó da FiscalAPI para o n8n?

Sim, o nó da comunidade n8n-nodes-fiscalapi, instalado em Settings > Community Nodes no n8n auto-hospedado. Ele consulta inscrição estadual (em uma UF ou nos 27 estados), CNPJ, certidões, XML de NF-e, SIGEF, CNIR e perfil do produtor rural.

Como consultar CNPJ no n8n?

Com o nó FiscalAPI, Resource Company e Operation Get, ou com um HTTP Request em GET https://api.fiscalapi.com.br/api/consultar-cnpj?cnpj=... e o header X-API-Key. A resposta traz razão social, situação cadastral, CNAE, QSA e endereço da Receita Federal.

O nó da FiscalAPI funciona no n8n Cloud?

No n8n Cloud só aparecem nós da comunidade verificados. Se o FiscalAPI não aparecer na busca de nós, use o HTTP Request com Header Auth: faz a mesma consulta.

Como evitar erro 429 no n8n?

Espace as chamadas conforme o plano: 12 s no Lite, 3 s no Starter, 1 s no Pro e 0,5 s no Enterprise. No HTTP Request, use Batching com 1 item por lote; no nó FiscalAPI, Loop Over Items e Wait.

Quanto custa consultar inscrição estadual pelo n8n?

O mesmo da API: 1 consulta por chamada, de R$ 0,025 (Enterprise) a R$ 0,67 (Lite). As 10 consultas grátis do mês valem para IE em um estado e CNPJ da base mensal.

Planos e preços