Tudo que você precisa pra integrar a consulta de Inscrição Estadual por CNPJ no seu sistema.
1. Autenticação
Todas as requisições exigem o seu token no header x-api-key. O token é gerado no seu painel após ativar uma assinatura, tem o formato iefacil_... e é exibido uma única vez.
x-api-key: iefacil_seu_token_aqui
Não compartilhe seu token. Se suspeitar de vazamento, use o botão Regenerar no painel (o antigo para de funcionar na hora).
2. Endpoints
Consultar Inscrição Estadual
GET https://www.inscricaoestadualfacil.com.br/api/b2b/consultar/{cnpj}?uf={UF}
Parâmetro
Onde
Descrição
cnpj
URL
CNPJ (14). Com ou sem formatação. Aceita CNPJ alfanumérico (NT 2026.004).
uf
Query
Sigla do estado da consulta (ex: PR, SP, RS). Obrigatório.
x-api-key
Header
Seu token da API. Obrigatório.
Consultar seu uso / franquia
GET https://www.inscricaoestadualfacil.com.br/api/b2b/uso
Mesmo header x-api-key. Retorna consultas usadas hoje, no mês, restantes e a data de renovação.
Observação sobre o Maranhão (MA)
A SEFAZ-MA não disponibiliza consulta cadastral via webservice. Consultas com uf=MA retornam 422 com o link do portal oficial.
using var http = new HttpClient();
http.DefaultRequestHeaders.Add("x-api-key", "iefacil_seu_token");
var url = "https://www.inscricaoestadualfacil.com.br/api/b2b/consultar/12345678000195?uf=PR";
var resposta = await http.GetAsync(url);
var json = await resposta.Content.ReadAsStringAsync();
if (resposta.IsSuccessStatusCode)
{
var dados = System.Text.Json.JsonDocument.Parse(json).RootElement;
Console.WriteLine($"IE: {dados.GetProperty("ie")}");
Console.WriteLine($"Razão social: {dados.GetProperty("razao_social")}");
Console.WriteLine($"Situação: {dados.GetProperty("situacao")}");
}
else
{
Console.WriteLine($"Erro {(int)resposta.StatusCode}: {json}");
}