FiscalAPI
Guias

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.

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:

  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

CampoValor
MethodGET
URIhttps://api.fiscalapi.com.br/api/consultar
HeadersX-API-Key: a sua chave de API, criada no painel em Chave API
Queriesuf: 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.

PlanoConsultas por minutoAtraso entre chamadas
Lite e conta sem plano512 segundos
Starter203 segundos
Pro601 segundo
Enterprise1201 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 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

LiteStarterProEnterprise
Consulta de IE (1 UF ou 27 UFs)R$ 0,67R$ 0,10R$ 0,065R$ 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.

Planos e preços

Esta pagina foi util?

On this page