API de consulta de inscrição estadual: como escolher
Antes de contratar uma API de consulta de inscrição estadual, faça as mesmas perguntas a todos os fornecedores e teste com documentos cuja resposta você já conhece. Dá para fazer em 30 minutos.
Abaixo, os critérios que dá para conferir, com a resposta da FiscalAPI em cada um. Para os demais fornecedores, confira na documentação de cada um.
Os critérios#
| Critério | O que perguntar | FiscalAPI |
|---|---|---|
| Cobertura | Os 27 estados? Por CNPJ, CPF e IE? | 27 UFs, por CNPJ, CPF ou IE. A busca por CPF depende do estado: São Paulo, por exemplo, só consulta por CNPJ ou IE |
| Todos os estados numa chamada | Dá para consultar sem saber a UF? Quanto custa? | GET /api/consultar-ie-todos varre os 27 estados e conta como 1 consulta |
| Formato | O JSON é igual em todos os estados? Traz a habilitação para NF-e? | Mesmo formato nas 27 UFs, com situacao_ie, situacao_nfe, regime_apuracao_icms, CNAE e endereço |
| Estado fora do ar | Como diferenciar "não encontrado" de "o estado não respondeu"? | source_status em cada UF e complete: false quando algum estado falhou |
| Cobrança em erro | Consulta com erro conta no saldo? | Não. Falha da FiscalAPI ou da fonte oficial não é cobrada. A varredura em que só parte dos estados respondeu conta como 1 |
| Preço | O preço está publicado? Tem fidelidade? | Publicado em fiscalapi.com.br/precos: de R$ 19,99/mês (30 consultas) até o Enterprise, a partir de R$ 250/mês (10.000 consultas). Sem fidelidade |
| Limite de requisições | Quantas por minuto? O que acontece ao passar? | 5, 20, 60 ou 120 por minuto, conforme o plano. Acima disso, HTTP 429 com Retry-After |
| Cache | A resposta diz se o dado veio do cache? | Sim: cached na consulta por UF e cached_ufs na de todos os estados |
| Volume | Tem rota de lote? E planilha? | Sem rota de lote na API: uma chamada por documento. No painel, planilha de até 20.000 linhas |
| Aviso de mudança | Avisa quando a situação da IE muda? | Não. A revalidação é um job seu: veja como revalidar o cadastro |
| Teste | Dá para testar sem cartão? | 10 consultas de IE e CNPJ por mês no painel, sem cartão, uma UF por vez. A varredura nos 27 estados e a API por chave exigem plano |
| Integração | Documentação com exemplos? SDK? | Exemplos em cURL, JavaScript, Python, PHP e C#. SDKs fiscalapi-br (npm e PyPI) e fiscalapi-br/fiscalapi-php (Packagist) |
Os itens "Aviso de mudança" e "Volume" mostram limites nossos. Pergunte o mesmo aos outros: a resposta muda o desenho da sua integração.
Perguntas para mandar ao fornecedor#
- Quais estados respondem por CPF?
- Consulta com erro é cobrada? E a que volta do cache?
- Na varredura de todos os estados, como sei que um estado não respondeu?
- O limite por minuto é por chave ou por conta?
- O preço está publicado? O que acontece quando o saldo acaba?
- Os campos têm o mesmo nome e o mesmo formato em todos os estados?
O teste de 30 minutos#
Separe 10 documentos da sua carteira cuja situação você já conhece:
- 3 CNPJs com IE ativa, em estados diferentes;
- 1 cliente com IE baixada ou suspensa;
- 1 CNPJ sem IE, como um prestador de serviço;
- 2 CPFs de produtor rural, um deles com propriedade em mais de um estado;
- 1 IE de MG ou MT sem os zeros à esquerda, como vem de planilha;
- 1 IE com o dígito verificador errado;
- 1 IE trocada, a de um cliente gravada no cadastro de outro, para ver se a resposta deixa conferir o vínculo (na FiscalAPI, pelo campo
cpf_cnpjou consultando pelo CNPJ).
Rode a mesma lista em cada fornecedor e anote:
| Anote | Por quê |
|---|---|
| Acertou a situação de cada um? | É o dado que evita a rejeição |
| Separou "não encontrado" de "estado não respondeu"? | Confundir os dois bloqueia cliente bom |
| Quanto tempo levou cada consulta? | Define se dá para consultar no formulário ou só numa fila |
| Quantas consultas foram cobradas? | Mostra a regra real de cobrança em erro |
| O JSON veio igual nos estados? | Formato diferente por UF vira código especial por UF |
Na FiscalAPI, as 10 consultas grátis do painel cobrem a consulta por estado. A varredura nos 27 estados e a API exigem plano: o Lite custa R$ 19,99/mês, com 30 consultas e 5 requisições por minuto.
O número com dígito errado nem precisa de consulta: o validador de inscrição estadual recusa de graça, no navegador. Veja dígito verificador ou consulta.
Perguntas frequentes#
Uma API de CNPJ serve para saber a situação da IE? Não. O cadastro do CNPJ é federal. A situação da IE está no cadastro de cada estado e pode divergir: CNPJ ativo com IE suspensa, por exemplo.
Preciso de certificado digital para consultar IE na FiscalAPI? Não. Basta a chave no header X-API-Key.
Dá para consultar milhares de documentos? Pela API, um por chamada, dentro do limite por minuto. Sem código, suba a planilha na consulta de IE em massa.
Por onde começo a integração? Pelo cadastro de clientes: veja como validar a IE no cadastro. Para ERPs, veja ERPs e hubs de marketplace.
Fontes#
- Planos e preços, FiscalAPI
- Consultar IE por UF e em todos os estados, documentação da FiscalAPI
- Rate limiting, documentação da FiscalAPI
Artigos relacionados#
Consulte dados fiscais via API
Consulte Inscrições Estaduais, CNPJs e Certidões Negativas via API REST. Dados direto da SEFAZ e Receita Federal. Planos a partir de R$ 19,99/mês.
Criar conta →