# Como consultar inscrição estadual no Power Automate?

> Num fluxo de nuvem do Power Automate, a ação HTTP chama a API da FiscalAPI com o header X-API-Key e devolve a inscrição estadual de cada CNPJ. A ação HTTP é de conector premium.

URL: https://docs.fiscalapi.com.br/docs/guias/power-automate
Atualizado em 07/11/2026

Num fluxo de nuvem do Power Automate, use a ação **HTTP** com método `GET`, URI `https://api.fiscalapi.com.br/api/consultar` (ou `consultar-ie-todos` para os 27 estados) e o header `X-API-Key` com a sua chave.

* **Custo:** 1 consulta por linha, de R$ 0,025 a R$ 0,67 conforme o plano ([tabela](#quanto-custa)).
* **Grátis para testar:** 10 consultas por mês de IE em um estado, exatamente a chamada deste fluxo ([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-power-automate).

<Callout type="warn">
  **A ação HTTP é premium.** A licença gratuita do Power Automate só permite conectores padrão; HTTP pede uma licença com conectores premium, como a Power Automate Premium ([Microsoft Learn](https://learn.microsoft.com/en-us/training/modules/http-connectors/1-introduction), [tipos de licença](https://learn.microsoft.com/en-us/power-platform/admin/power-automate-licensing/types)). Sem ela, suba a planilha no painel da FiscalAPI: até 20.000 linhas, com o resultado em Excel ([consulta de IE em massa](https://fiscalapi.com.br/consulta-ie-em-massa/)).
</Callout>

## O fluxo

Exemplo com uma tabela do Excel no OneDrive ou no SharePoint, com as colunas `CNPJ`, `UF`, `Status`, `IE` e `Situacao`:

1. **Gatilho**: **Disparar um fluxo manualmente** (ou **Recorrência**, se for rodar sozinho).
2. **Excel Online (Business) > Listar linhas presentes em uma tabela**: a sua tabela.
3. **Aplicar a cada** sobre as linhas da tabela. Dentro dele:
   1. **Condição**: só segue se a coluna `Status` estiver vazia. Assim, linha já consultada não é consultada nem cobrada de novo.
   2. **HTTP**, configurada como abaixo.
   3. **Excel Online (Business) > Atualizar uma linha**: grave `Status` = `OK` e a IE e a situação (vazias quando o CNPJ não tem IE naquele estado). O `Status` é o que marca a linha como consultada.
   4. **Atraso** com a pausa do seu plano (tabela abaixo).

### Ação HTTP

| Campo       | Valor                                                              |
| ----------- | ------------------------------------------------------------------ |
| **Method**  | `GET`                                                              |
| **URI**     | `https://api.fiscalapi.com.br/api/consultar`                       |
| **Headers** | `X-API-Key`: a sua chave de API, criada no painel em **Chave API** |
| **Queries** | `uf`: coluna `UF` da linha; `cnpj`: coluna `CNPJ` da linha         |

A chave aparece no histórico de execuções para quem tem acesso ao fluxo. Para escondê-la, ligue **Entradas seguras** nas **Configurações** da ação HTTP.

### Ler a resposta

A resposta de `/api/consultar` traz as inscrições em `results`. Cada item tem `inscricao_estadual`, `situacao_ie` (`Habilitado` ou `Não habilitado`), `razao_social`, `municipio` e os outros campos de [Consultar IE por UF](/docs/consulta-ie/consultar-ie). Para gravar a primeira inscrição, use expressões como:

```text
first(body('HTTP')?['results'])?['inscricao_estadual']
first(body('HTTP')?['results'])?['situacao_ie']
```

`results` vazio quer dizer que o CNPJ não tem IE naquele estado. Se a UF não é conhecida, use `https://api.fiscalapi.com.br/api/consultar-ie-todos` só com `cnpj`: a resposta vem agrupada por estado, e o campo `complete` diz se todos responderam ([formato](/docs/consulta-ie/consultar-ie-todos)).

## Pausa entre chamadas

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

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

No Enterprise, 1 segundo já fica abaixo do limite. Nas configurações do **Aplicar a cada**, deixe o **Controle de simultaneidade** desligado, para as linhas rodarem uma de cada vez e o **Atraso** valer entre uma chamada e outra.

## Erros

* **402**: acabaram as consultas do mês e não há recarga. Repetir não adianta: pare o fluxo com uma ação **Encerrar**.
* **429**: passou do limite por minuto (a resposta traz `Retry-After`). A **Política de repetição** padrão da ação HTTP já repete em 408, 429 e 5xx com intervalo crescente ([Microsoft Learn](https://learn.microsoft.com/en-us/azure/logic-apps/error-exception-handling#retry-policies)). Se o 429 for frequente, aumente o **Atraso**.
* **400**: CNPJ ou UF inválidos. Corrija a linha.
* **502** e **503**: a fonte do estado não respondeu. Deixe o `Status` vazio para a linha entrar na próxima execução.

Para tratar o erro, adicione depois da HTTP uma ação configurada com **Executar após** marcando **falhou**. Nela, olhe o código em `outputs('HTTP')?['statusCode']`: em `402`, **Encerrar**; em `400`, grave o erro no `Status` da linha; em `502` e `503`, não grave nada.

## 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 da ação HTTP é uma consulta; repetição automática que termina em 200 conta uma vez. Resposta com erro HTTP (400, 402, 429, 500) não é cobrada. A licença premium do Power Automate é cobrada pela Microsoft, à 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 e de CNPJ, no painel e pela API. A chamada deste fluxo (`/api/consultar` com `uf`) entra; 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-power-automate).

## Perguntas frequentes

### Como consultar inscrição estadual no Power Automate?

Num fluxo de nuvem, use a ação HTTP com método GET, URI `https://api.fiscalapi.com.br/api/consultar`, as queries `uf` e `cnpj` e o header `X-API-Key`. O resultado vem em JSON, com a inscrição e a situação em `results`.

### A ação HTTP do Power Automate é premium?

Sim. A Microsoft trata a conexão HTTP como premium no Power Automate, então o fluxo precisa de uma licença que inclua conectores premium.

### Dá para consultar CNPJ no Power Automate?

Dá, com a mesma ação HTTP em `https://api.fiscalapi.com.br/api/consultar-cnpj` e a query `cnpj`. A resposta traz os dados da Receita Federal em `result`.

### Como não passar do limite de consultas por minuto?

Deixe o Aplicar a cada sem simultaneidade e ponha um Atraso depois da ação HTTP: 12 s no Lite, 3 s no Starter e 1 s no Pro e no Enterprise.

### Quanto custa consultar inscrição estadual pelo Power Automate?

Na FiscalAPI, de R$ 0,025 (Enterprise) a R$ 0,67 (Lite) por consulta. As 10 consultas grátis do mês valem para a consulta de IE em um estado, a deste fluxo. A licença premium do Power Automate é à parte.