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.
Atualizado em
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).
- Grátis para testar: 10 consultas por mês de IE em um estado, exatamente a chamada deste fluxo (condições).
- Comece: crie a conta e a chave de API.
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, tipos de licença). Sem ela, suba a planilha no painel da FiscalAPI: até 20.000 linhas, com o resultado em Excel (consulta de IE em massa).
O fluxo
Exemplo com uma tabela do Excel no OneDrive ou no SharePoint, com as colunas CNPJ, UF, Status, IE e Situacao:
- Gatilho: Disparar um fluxo manualmente (ou Recorrência, se for rodar sozinho).
- Excel Online (Business) > Listar linhas presentes em uma tabela: a sua tabela.
- Aplicar a cada sobre as linhas da tabela. Dentro dele:
- Condição: só segue se a coluna
Statusestiver vazia. Assim, linha já consultada não é consultada nem cobrada de novo. - HTTP, configurada como abaixo.
- Excel Online (Business) > Atualizar uma linha: grave
Status=OKe a IE e a situação (vazias quando o CNPJ não tem IE naquele estado). OStatusé o que marca a linha como consultada. - Atraso com a pausa do seu plano (tabela abaixo).
- Condição: só segue se a coluna
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. Para gravar a primeira inscrição, use expressões como:
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).
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). 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
Statusvazio 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.
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.
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.
Esta pagina foi util?
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.
Como consultar a inscrição estadual de milhares de CNPJs em Python?
Script pronto com o SDK oficial: segue o limite do seu plano, para quando acabam as consultas e retoma de onde parou.