# Como consultar inscrição estadual no Make?

> Use o módulo HTTP "Make a request" com a chave de API no header X-API-Key para consultar a inscrição estadual de cada CNPJ pela FiscalAPI num cenário do Make.

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

Use o módulo **HTTP > Make a request**: um `GET` em `https://api.fiscalapi.com.br/api/consultar-ie-todos` com o CNPJ e a sua chave de API. Não há app da FiscalAPI no Make; o módulo HTTP faz o papel dele, com quatro campos.

* **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-make).

## 1\. Crie a credencial da chave

1. Crie a chave de API no painel da FiscalAPI, em **Chave API**.
2. No Make, adicione o módulo **HTTP > Make a request** e, em **Authentication type**, escolha **API key**.
3. Em **Credentials**, crie uma credencial nova e preencha:
   * **Name**: `FiscalAPI`
   * **Key**: a sua chave de API
   * **API key placement**: **In the header**
   * **API key parameter name**: `X-API-Key`

O Make recomenda guardar a chave na credencial, não em **Headers** ou **Query parameters** ([módulo HTTP](https://apps.make.com/http), [credencial API key](https://apps.make.com/api-key-authentication-type)).

## 2\. Configure a chamada

No mesmo módulo **Make a request**:

| Campo                | Valor                                                          |
| -------------------- | -------------------------------------------------------------- |
| **URL**              | `https://api.fiscalapi.com.br/api/consultar-ie-todos`          |
| **Method**           | `GET`                                                          |
| **Query parameters** | Name `cnpj`, Value: mapeie a coluna do CNPJ do módulo anterior |
| **Parse response**   | **Yes**                                                        |

Com **Parse response** em **Yes**, os campos da resposta (`results`, `complete` e, em cada estado, `uf` e `results`) ficam disponíveis para os módulos seguintes ([formato](/docs/consulta-ie/consultar-ie-todos)). Em **Advanced settings**, ponha **Timeout** em `120`: a consulta nos 27 estados pode levar dezenas de segundos.

Para um estado só, troque a URL por `https://api.fiscalapi.com.br/api/consultar` e acrescente o parâmetro `uf` (por exemplo, `MT`). Para os dados da Receita Federal, use `https://api.fiscalapi.com.br/api/consultar-cnpj`.

## 3\. Monte o cenário

Um cenário típico para uma planilha de CNPJs:

1. **Google Sheets > Search Rows**: as linhas da aba `Documentos` em que a coluna **Status** está vazia. Cada linha vira um pacote (bundle).
2. **HTTP > Make a request**: a consulta configurada acima.
3. **Tools > Sleep**, com a pausa do seu plano (tabela abaixo).
4. **Google Sheets > Update a Row** na linha de origem: grave o **Status** (por exemplo, o código de status da resposta) e o `complete`. Esse passo vem **antes** de qualquer Iterator, para rodar uma vez por CNPJ.
5. **Iterator** sobre `results` (um pacote por estado) e outro **Iterator** sobre o `results` de cada estado (um pacote por inscrição).
6. **Google Sheets > Add a Row** numa aba `Inscricoes`: o CNPJ, `inscricao_estadual`, `uf_ie` e `situacao_ie`.

O **Status** é gravado sempre, mesmo sem IE (o Iterator não gera pacote) ou com erro. Como o passo 1 só busca linhas sem Status, rodar o cenário de novo não consulta nem cobra a mesma linha. Para refazer uma linha, apague o Status dela.

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, confira os CNPJs antes.

## Pausa entre chamadas

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

| Plano                  | Consultas por minuto | Sleep entre chamadas |
| ---------------------- | -------------------- | -------------------- |
| Lite e conta sem plano | 5                    | 12 s                 |
| Starter                | 20                   | 3 s                  |
| Pro                    | 60                   | 1 s                  |
| Enterprise             | 120                  | 1 s                  |

O Sleep do Make conta em segundos inteiros; no Enterprise, 1 s já fica abaixo do limite.

## Erros

Em **Advanced settings**, a opção **Return error if HTTP request fails** decide o que acontece em `4xx` e `5xx`: em **Yes**, o cenário para no erro; em **No**, o módulo devolve a resposta e você trata com um filtro pelo código de status.

* **402**: acabaram as consultas do mês e não há recarga. Pare o cenário: repetir não adianta.
* **429**: passou do limite por minuto. A resposta traz o header `Retry-After` com os segundos de espera; aumente o Sleep.
* **400**: documento ausente ou sem dígitos. Grave o erro na linha e siga.
* **502** e **503**: a fonte do estado não respondeu. Grave o erro no Status; apague-o depois para tentar de novo.

Na consulta nos 27 estados, confira `complete`: `false` quer dizer que algum estado não respondeu.

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

Valores por consulta dentro da franquia mensal. Cada execução do módulo HTTP é uma consulta. Resposta com erro HTTP (400, 402, 429, 500) não é cobrada. O uso dos módulos entra no seu plano do Make, à parte. 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 (URL `/api/consultar` com `uf`) e de CNPJ, no painel e pela API. A consulta nos 27 estados usa plano ou recarga. [Criar conta](https://app.fiscalapi.com.br?utm_source=docs\&utm_medium=docs\&utm_campaign=guia-make).

## Perguntas frequentes

### Tem app da FiscalAPI no Make?

Não. Use o módulo HTTP > Make a request com a chave numa credencial do tipo API key, no header `X-API-Key`. É uma chamada `GET` comum.

### Como passar a chave da API no Make?

Em Authentication type, escolha API key e crie a credencial com API key placement In the header e API key parameter name `X-API-Key`.

### Como consultar a inscrição estadual de uma planilha inteira no Make?

Busque as linhas sem Status no Google Sheets, chame o HTTP Make a request para cada uma, grave o Status com Update a Row e as inscrições numa aba à parte, com um Sleep entre as chamadas conforme o plano.

### Rodar o cenário de novo cobra outra vez?

Cobra para cada linha consultada de novo. Grave sempre um Status e busque só as linhas sem Status antes do módulo HTTP.

### Quanto custa consultar inscrição estadual pelo Make?

De R$ 0,025 (Enterprise) a R$ 0,67 (Lite) por consulta na FiscalAPI. As 10 consultas grátis do mês valem para IE em um estado e CNPJ, não para a consulta nos 27 estados. O consumo do próprio Make é cobrado pelo Make.