Como consultar inscrição estadual no Make?

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).
• 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).
• Comece: crie a conta e a chave de API.

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, credencial API key).

2. Configure a chamada

No mesmo módulo Make a request:

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

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

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.

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.

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.

Planos e preços