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

> Instale o nó da comunidade n8n-nodes-fiscalapi, ou use o nó HTTP Request, para consultar CNPJ e inscrição estadual pela FiscalAPI nos seus workflows do n8n.

URL: https://docs.fiscalapi.com.br/docs/guias/n8n
Atualizado em 07/11/2026

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](#quanto-custa)).
* **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](#quanto-custa)).
* **Comece:** [crie a conta e a chave de API](https://app.fiscalapi.com.br?utm_source=docs\&utm_medium=docs\&utm_campaign=guia-n8n).

## 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](https://docs.n8n.io/integrations/community-nodes/installation-and-management/).

### 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

| Resource           | Operation         | Endpoint                      |
| ------------------ | ----------------- | ----------------------------- |
| State Registration | Get by State      | `GET /api/consultar`          |
| State Registration | Get in All States | `GET /api/consultar-ie-todos` |
| Company            | Get               | `GET /api/consultar-cnpj`     |

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](https://github.com/fiscalapi-br/n8n-nodes-fiscalapi).

### 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](/docs/consulta-ie/consultar-ie-todos) e [Consultar CNPJ](/docs/enriquecimento/consultar-cnpj).

## Espera entre chamadas

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

| Plano                  | Consultas por minuto | Intervalo entre chamadas |
| ---------------------- | -------------------- | ------------------------ |
| Lite e conta sem plano | 5                    | 12000 ms                 |
| Starter                | 20                   | 3000 ms                  |
| Pro                    | 60                   | 1000 ms                  |
| Enterprise             | 120                  | 500 ms                   |

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

|                                 | Lite    | Starter | Pro      | Enterprise |
| ------------------------------- | ------- | ------- | -------- | ---------- |
| Consulta de IE (1 UF ou 27 UFs) | R$ 0,67 | R$ 0,10 | R$ 0,065 | R$ 0,025   |
| Consulta de CNPJ (base mensal)  | R$ 0,67 | R$ 0,10 | R$ 0,065 | R$ 0,025   |

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](/docs/referencia/plans-and-limits).

**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](https://app.fiscalapi.com.br?utm_source=docs\&utm_medium=docs\&utm_campaign=guia-n8n).

## 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.