Consultar Inscrição Estadual (IE) na SEFAZ
cadastro_consultarRead-onlyIdempotent
Consulta a Inscrição Estadual (IE) de um contribuinte na SEFAZ estadual (mundo NF-e/ICMS), por CNPJ/CPF/IE + UF. ATENÇÃO: muitas UFs NÃO oferecem este serviço (ex: RJ) e prestadores de serviço normalmente NÃO têm IE - nesses casos a IE não vem, e ISSO NÃO SIGNIFICA QUE O CNPJ ESTEJA INATIVO. Quando a SEFAZ não retorna e o documento é CNPJ, há fallback automático na Receita Federal (campo 'fonte'='receita') trazendo razão social, situação cadastral e endereço - sempre leia o campo 'mensagem'. Para apenas saber se um CNPJ está ativo ou pegar seus dados cadastrais (sem precisar da IE), prefira cliente_consultar.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| uf | No | UF do CPF, CNPJ, IE | |
| cpfCnpjIe | No |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ie | No | ||
| fonte | No | Fonte dos dados: "sefaz" (Inscrição Estadual da SEFAZ estadual), "receita" (fallback na Receita Federal quando a UF não oferece a consulta ou o contribuinte não tem IE - comum em prestadores de serviço) ou "indisponivel". | |
| status | No | Status Consulta Valores: 0 - Não Encontrada;; 1 - Encontrada; | |
| Contato | No | ||
| cpfCnpj | No | ||
| ieAtual | No | ||
| ieUnica | No | ||
| Endereco | No | ||
| mensagem | No | Mensagem explicativa do resultado: por que a IE não veio, qual fonte foi usada, e o aviso de que vazio NÃO significa CNPJ inativo. Fica vazio quando a SEFAZ retornou a Inscrição Estadual normalmente. | |
| situacao | No | Situação do contribuinte: 0 - não habilitado; 1 - habilitado. | |
| razaoSocial | No | ||
| nomeFantasia | No | ||
| ufConsultada | No | ||
| cnaePrincipal | No | ||
| regimeApuracao | No | ||
| dataInicioAtividade | No | Data/hora ISO 8601 (ex: 2026-07-22T13:45:00-03:00) | |
| dataOcorrenciaBaixa | No | Data/hora ISO 8601 (ex: 2026-07-22T13:45:00-03:00) | |
| indicadorCredenciamentoCTe | No | Indicador de contribuinte credenciado a emitir CT-e. Valores: 0 - Não credenciado para emissão da CT-e;; 1 - Credenciado;; 2 - Credenciado com obrigatoriedade para todas operações;; 3 - Credenciado com obrigatoriedade parcial;; 4 - a SEFAZ não fornece a informação. Este indicador significa apenas que o contribuinte é credenciado para emitir CT-e na SEFAZ consultada. | |
| indicadorCredenciamentoNFe | No | Indicador de contribuinte credenciado a emitir NF-e. Valores: 0 - Não credenciado para emissão da NF-e;; 1 - Credenciado;; 2 - Credenciado com obrigatoriedade para todas operações;; 3 - Credenciado com obrigatoriedade parcial;; 4 - a SEFAZ não fornece a informação. Este indicador significa apenas que o contribuinte é credenciado para emitir NF-e na SEFAZ consultada. | |
| dataUltimaAlteracaoCadastral | No | Data/hora ISO 8601 (ex: 2026-07-22T13:45:00-03:00) |