Como consultar inscrição estadual no Excel?

Suba a planilha no painel da FiscalAPI e baixe outro Excel com a inscrição estadual e a situação de cada CNPJ, CPF ou IE nos 27 estados. Sem fórmula, sem macro, sem programar.

• Custo: 1 consulta por linha, de R$ 0,025 a R$ 0,67 conforme o plano (tabela).
• Grátis para testar: 10 consultas avulsas por mês de IE em um estado e de CNPJ, no painel e pela API (condições). A planilha em massa e o Power Query são pagos.
• Para quem quer o resultado dentro da própria planilha: Power Query chamando a API (caminho 2).
• Comece: crie a conta no painel.

Caminho 1: planilha no painel, sem programar

1. Entre no painel e abra a consulta de IE em massa.
2. Baixe o modelo .xlsx e preencha a coluna de documentos. CNPJ e CPF podem vir misturados; numa linha com número de IE, marque Sim na coluna que pergunta se é inscrição estadual.
3. Envie. O painel mostra quantas consultas o arquivo vai usar; se o saldo não cobrir tudo, você escolhe consultar só as primeiras.
4. Baixe o Excel com o resultado.

Até 20.000 linhas por arquivo de até 5 MB. Documento repetido é consultado uma vez só. Formate a coluna como texto para não perder zeros à esquerda. Mais em consulta de IE em massa.

Caminho 2: Power Query chamando a API

Para quando o resultado precisa ficar dentro da sua planilha. Passos do Excel do Microsoft 365 para Windows.

1. Prepare a tabela

Ponha os CNPJs numa coluna CNPJ, selecione os dados e tecle Ctrl+T. Em Design da Tabela, dê à tabela o nome Documentos.

2. Crie a função que chama a API

Em Dados > Obter Dados > De Outras Fontes > Consulta Nula, abra o Editor Avançado, apague o conteúdo e cole o código. Renomeie a consulta para ConsultarIE.

(cnpj as text) as record =>
let
    Chave = "fapi_sua_chave_aqui",
    // Segundos entre chamadas: 12 no Lite e sem plano, 3 no Starter, 1 no Pro, 0.5 no Enterprise
    Pausa = 3,
    Resposta = Function.InvokeAfter(
        () => Web.Contents(
            "https://api.fiscalapi.com.br",
            [
                RelativePath = "api/consultar-ie-todos",
                Query = [cnpj = cnpj],
                Headers = [#"X-API-Key" = Chave],
                ManualStatusHandling = {400, 402, 500, 502}
            ]
        ),
        #duration(0, 0, 0, Pausa)
    ),
    Status = Value.Metadata(Resposta)[Response.Status],
    Json = Json.Document(Resposta),
    Inscricoes =
        if Status = 200 then
            List.Combine(
                List.Transform(
                    Json[results],
                    (estado) => List.Transform(
                        estado[results],
                        (ie) => estado[uf] & ": " & ie[inscricao_estadual] & " (" & ie[situacao_ie] & ")"
                    )
                )
            )
        else
            {},
    Resultado = [
        Status = Status,
        Inscricoes = Text.Combine(Inscricoes, "; "),
        Completo = if Status = 200 then Json[complete] else null,
        Erro = if Status = 200 then null else try Json[message] otherwise try Json[detail] otherwise null
    ]
in
    Resultado

O que o código faz:

• Chama GET /api/consultar-ie-todos?cnpj=... com o header X-API-Key: procura o CNPJ nos 27 estados numa chamada.
• Espera Pausa segundos antes de cada chamada, para ficar no limite por minuto do plano.
• Devolve o status HTTP, as inscrições numa linha de texto (MT: 13.234.567-6 (Habilitado); GO: ...), o campo complete e a mensagem de erro, se houver.
• Em 429 e 503, o Power Query tenta de novo até três vezes e respeita o Retry-After (Microsoft). A Pausa reduz o 429, mas não o elimina: o Excel não garante uma linha de cada vez.

Na primeira execução, o Excel pergunta como acessar https://api.fiscalapi.com.br: escolha Anônimo e Conectar (a chave vai no header). Chave errada ou revogada volta 403, que o Excel mostra como erro de credencial.

A consulta nos 27 estados não confere o dígito verificador: CNPJ digitado errado é consultado e cobrado. Confira a lista antes (o caminho 1 já descarta documento inválido).

3. Chame a função para cada linha

Crie outra Consulta Nula, abra o Editor Avançado e cole:

let
    Fonte = Excel.CurrentWorkbook(){[Name = "Documentos"]}[Content],
    Texto = Table.TransformColumnTypes(Fonte, {{"CNPJ", type text}}),
    Consultas = Table.AddColumn(Texto, "Resultado", each ConsultarIE([CNPJ])),
    Colunas = Table.ExpandRecordColumn(
        Consultas, "Resultado", {"Status", "Inscricoes", "Completo", "Erro"}
    )
in
    Colunas

Clique em Fechar e Carregar. O resultado vai para uma planilha nova.

Erro Formula.Firewall? O Excel está bloqueando o envio dos CNPJs à API pelos níveis de privacidade. Em Dados > Obter Dados > Opções de Consulta > Pasta de Trabalho Atual > Privacidade, ajuste os níveis ou ignore-os neste arquivo (Microsoft).

4. Evite atualizações sem querer

Em Dados > Consultas e Conexões, clique com o botão direito na consulta > Propriedades > aba Uso. Deixe desmarcadas Atualizar dados ao abrir o arquivo e Atualizar a cada N minutos. Assim a API só é chamada quando você manda.

Como ler o resultado

Para um estado só, troque RelativePath por "api/consultar" e Query por [uf = "MT", cnpj = cnpj]. As inscrições passam a vir direto em results, sem o agrupamento por UF (Consultar IE por UF).

Quanto custa

Valores por consulta dentro da franquia mensal. No painel, cada linha é uma consulta; no Power Query, cada linha conta de novo a cada atualização. Erro HTTP (400, 402, 429, 500) não é cobrado. Veja Planos e limites.

Grátis para testar: conta que nunca assinou plano, sem recarga e com e-mail confirmado, tem 10 consultas avulsas por mês de IE em um estado e de CNPJ, no painel e pela API. A planilha em massa e a consulta nos 27 estados (Power Query) são pagas. Criar conta.

Perguntas frequentes

Como consultar inscrição estadual de vários CNPJs no Excel?

Suba a planilha com os CNPJs no painel da FiscalAPI e baixe o Excel com a inscrição estadual e a situação de cada um nos 27 estados. Cabem até 20.000 linhas por arquivo, sem macro e sem programar. Se precisa do resultado dentro da sua planilha, use o Power Query chamando a API.

Dá para consultar o SINTEGRA direto no Excel?

Dá, pela API: o Power Query chama GET /api/consultar-ie-todos com o CNPJ de cada linha e traz as inscrições dos 27 estados para a planilha. É preciso uma chave de API, criada no painel.

Atualizar a consulta no Excel cobra de novo?

Sim. Cada atualização chama a API para todas as linhas, e cada linha conta como uma consulta. Deixe desligadas as opções de atualizar ao abrir e a cada N minutos, e cole como valores o que não precisa mudar.

Preciso de macro ou VBA?

Não. A planilha do painel não usa macro, e o Power Query já vem no Excel do Microsoft 365.

Quanto custa consultar a IE pelo Excel?

De R$ 0,025 (Enterprise) a R$ 0,67 (Lite) por linha. As 10 consultas grátis do mês cobrem a consulta avulsa de IE em um estado e de CNPJ, não a planilha em massa nem a consulta nos 27 estados.

Planos e preços