Consulta de Inscrição Estadual (IE) por CNPJ

A Inscrição Estadual (IE) é o registro de uma empresa no cadastro de contribuintes de ICMS da sua UF - quem emite nota fiscal de mercadoria precisa dela. A CNPJAPI consulta a IE de um CNPJ na fonte oficial: o cadastro de contribuintes das Secretarias da Fazenda estaduais (SEFAZ), pelo mesmo sistema de webservices oficiais do NF-e que os emissores de nota usam - e sem você precisar de certificado digital próprio.

O problema

• A base da Receita Federal (e as APIs que só a replicam, como a ReceitaWS) não traz a Inscrição Estadual - a IE é estadual, não federal.
• Integrar a SEFAZ por conta própria exige certificado digital e uma implementação por estado - caro e trabalhoso.
• Sites que "consultam IE" costumam raspar os portais das SEFAZ: quebram quando o portal muda, esbarram em captcha e não oferecem uma API estável para automatizar.

Como a API resolve

Uma chamada por CNPJ devolve a Inscrição Estadual na fonte oficial:

• Fonte oficial da SEFAZ (cadastro de contribuintes), não raspagem
• Sem certificado seu: a CNPJAPI faz a ponte com a SEFAZ; você usa só a API key
• 16 UFs cobertas, incluindo o Rio de Janeiro: AC, AM, BA, ES, GO, MT, MS, MG, PB, PR, PE, RJ, RN, RS, SC, SP
• Por UF ou varredura nacional numa só chamada
• Situação (habilitada ou baixada), tipo de contribuinte (contribuinte de ICMS, isento ou não-contribuinte) e a razão social conforme o cadastro estadual
• API REST com a mesma chave da consulta de CNPJ; combine as duas com ?incluir=ie

Veja o contrato completo e a disponibilidade por UF em tempo real.

Fonte oficial x raspagem

Alternativa ao SINTEGRA: consulta de IE por CNPJ via API

O SINTEGRA (Sistema Integrado de Informações sobre Operações Interestaduais) é o serviço público e gratuito que reúne o cadastro de contribuintes de ICMS das SEFAZ e permite verificar, por CNPJ, se a Inscrição Estadual de uma empresa existe e em que situação está. Para uma consulta avulsa, ele resolve - mas é manual, um portal por estado e com captcha, sem uma API para automatizar.

A CNPJAPI consulta o mesmo cadastro oficial de contribuintes de ICMS da SEFAZ, só que por uma API REST estável: uma chamada por CNPJ, por UF ou em varredura nacional, sem captcha e sem navegar portal por portal. É o SINTEGRA para quem precisa automatizar - integrar no ERP, validar cadastros em lote ou consultar em escala.

A CNPJAPI não é o SINTEGRA nem tem vínculo com ele; a fonte do dado é a mesma - o cadastro de contribuintes de ICMS das Secretarias da Fazenda estaduais.

Perguntas frequentes

A Receita Federal (ou a ReceitaWS) retorna a Inscrição Estadual? Não. A IE é um registro estadual (ICMS); o cadastro federal da Receita não a inclui. Ela vem da SEFAZ de cada estado.

Como consultar a IE de um CNPJ? Chame GET /consulta/ie/{cnpj}?uf=SP com sua API key, ou omita a UF para varrer as 16 UFs cobertas numa só chamada.

Preciso de certificado digital? Não. A CNPJAPI já faz a integração oficial com a SEFAZ; você consulta só com a API key.

A consulta de IE da CNPJAPI é um SINTEGRA? O dado é o mesmo do SINTEGRA - o cadastro de contribuintes de ICMS das SEFAZ - mas a CNPJAPI entrega por uma API REST, para automatizar por CNPJ, por UF ou em varredura nacional, sem captcha. A CNPJAPI não é o SINTEGRA nem tem vínculo com ele.

Por onde começar

1. Gere sua API key em https://app.cnpjapi.com.br. Todo plano registrado inclui uma cota mensal de IE - o gratuito também - e há créditos avulsos para volume.
2. Chame GET /consulta/ie/{cnpj}?uf=SP, ou omita a UF para a varredura nacional (veja os guias).
3. Precisa dos dados cadastrais junto? Use GET /{cnpj}?incluir=ie.

Crie sua conta e consulte Inscrição Estadual na fonte oficial em minutos.