IE - Inscrição Estadual (Versão 2)

Introdução

Esta API permite consultar informações sobre Inscrições Estaduais (IE) no SINTEGRA/CCC. A consulta pode ser realizada utilizando o CNPJ ou CPF do contribuinte, juntamente com a UF.

Histórico de Versões

Versão	Início da Depreciação	Data de Descontinuação	Status	Alteração
Versão 2	-	-	Em Produção	Alteração para suportar resposta de CNPJ e CPF com múltiplas inscrições na mesma UF. O retorno agora é uma lista.
Versão 1	12/08/2025	28/02/2026	Em Depreciação (Período de Transição)	Versão inicial.

Endpoints

1. Consultar

Consulta detalhes de uma Inscrição Estadual específica.

Endpoint

GET /api/v2/ie/consultar

Requisição

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
`uf`	Texto	Sim	Unidade Federativa da Inscrição Estadual	`SP`
`cnpj` ou `cpf`	Texto	Sim	CNPJ ou CPF do contribuinte	`61585865150633`

Resposta

Campo	Tipo	Descrição	Exemplo
`cnpj`	Texto	CNPJ ou CPF do contribuinte	`"61585865150633"`
`razao_social`	Texto	Razão social da empresa	`"RAIA DROGASIL S/A"`
`nome_fantasia`	Texto	Nome fantasia da empresa	`""`
`uf_ie`	Texto	Unidade Federativa da Inscrição Estadual	`"SP"`
`ie`	Texto	Número da Inscrição Estadual	`"535612879117"`
`tipo_ie`	Texto	Tipo da Inscrição Estadual	`"IE NORMAL"`
`situacao_ie`	Texto	Situação atual da Inscrição Estadual	`"HABILITADO"`
`situacao_cnpj`	Texto	Status do CNPJ	`"SEM RESTRIÇÃO"`
`data_situacao_uf`	Data	Data da última atualização da situação	`"22/06/2016"`
`data_inicio`	Data	Data de início da Inscrição Estadual	`"22/06/2016"`
`data_fim`	Data	Data de encerramento da Inscrição Estadual (se houver)	`""`
`cnae_principal_codigo`	Texto	Código CNAE da atividade principal	`"4771701"`
`regime_tributacao`	Texto	Regime de tributação	`"NORMAL"`
`ie_destinatario`	Texto	Indicador de obrigatoriedade de IE do destinatário	`"OBRIGATÓRIA"`
`porte_empresa`	Texto	Porte da empresa	`""`
`credito_presumido`	Texto	Indicador de crédito presumido	`""`
`tipo_produtor`	Texto	Indicador se é produtor rural	`"NÃO"`
`logradouro`	Texto	Nome do logradouro	`"AVENIDA INDEPENDENCIA"`
`numero`	Texto	Número do endereço	`"2906"`
`complemento`	Texto	Complemento do endereço	`""`
`bairro`	Texto	Bairro	`"ALEMAES"`
`cep`	Texto	CEP	`"13416-240"`
`uf`	Texto	UF do endereço do estabelecimento	`"SP"`
`municipio_codigo`	Texto	Código IBGE do município	`"3538709"`
`municipio_descricao`	Texto	Nome do município	`"PIRACICABA"`

Erros

Código HTTP	Erro	Mensagem
`400`	`REQUISICAO_INVALIDA`
`403`	`PLANO_INATIVO`	`Plano inativo para realizar consultas.`
`403`	`CREDITOS_INSUFICIENTES`	`Sem créditos suficientes para consulta.`
`404`	`NAO_ENCONTRADO`	`Nenhum registro encontrado com os parâmetros informados.`

Exemplos

Exemplo de Requisição (cURL)

curl -X GET 'https://consultar.io/api/v1/ie/consultar?uf=SP&cnpj=61585865150633' -H 'Authorization: Token <seu-token>'

Exemplo de Resposta de Sucesso (200) - CNPJ

[
  {
    "cnpj": "61585865150633",
    "razao_social": "RAIA DROGASIL S/A",
    "nome_fantasia": "",
    "uf_ie": "SP",
    "ie": "535612879117",
    "tipo_ie": "IE NORMAL",
    "situacao_ie": "HABILITADO",
    "situacao_cnpj": "SEM RESTRIÇÃO",
    "data_situacao_uf": "22/06/2016",
    "data_inicio": "22/06/2016",
    "data_fim": "",
    "cnae_principal_codigo": "4771701",
    "regime_tributacao": "NORMAL",
    "ie_destinatario": "OBRIGATÓRIA",
    "porte_empresa": "",
    "credito_presumido": "",
    "tipo_produtor": "NÃO",
    "logradouro": "AVENIDA INDEPENDENCIA",
    "numero": "2906",
    "complemento": "",
    "bairro": "ALEMAES",
    "cep": "13416-240",
    "uf": "SP",
    "municipio_codigo": "3538709",
    "municipio_descricao": "PIRACICABA"
  }
]

Exemplo de Resposta de Sucesso (200) - CPF

[
  {
    "cnpj": "35488964053",
    "razao_social": "MIGUEL RICARDO CAVALCANTI",
    "nome_fantasia": "FAZENDA DA CUNHA",
    "uf_ie": "MT",
    "ie": "698741950",
    "tipo_ie": "IE DE PRODUTOR RURAL",
    "situacao_ie": "HABILITADO",
    "situacao_cnpj": "SEM RESTRIÇÃO",
    "data_situacao_uf": "07/03/2005",
    "data_inicio": "07/03/2005",
    "data_fim": "",
    "cnae_principal_codigo": "115600",
    "regime_tributacao": "NORMAL",
    "ie_destinatario": "OBRIGATÓRIA",
    "porte_empresa": "",
    "credito_presumido": "",
    "tipo_produtor": "NÃO",
    "logradouro": "RODOVIA MT 123 KM 456",
    "numero": "SN",
    "complemento": "",
    "bairro": "ZONA RURAL",
    "cep": "78467899",
    "uf": "MT",
    "municipio_codigo": "5105259",
    "municipio_descricao": "LUCAS DO RIO VERDE"
  },
  {
    "cnpj": "35488964053",
    "razao_social": "MIGUEL RICARDO CAVALCANTI",
    "nome_fantasia": "FAZENDA CARVALHO",
    "uf_ie": "MT",
    "ie": "292692800",
    "tipo_ie": "IE DE PRODUTOR RURAL",
    "situacao_ie": "HABILITADO",
    "situacao_cnpj": "SEM RESTRIÇÃO",
    "data_situacao_uf": "02/06/2011",
    "data_inicio": "02/06/2011",
    "data_fim": "",
    "cnae_principal_codigo": "154700",
    "regime_tributacao": "",
    "ie_destinatario": "OBRIGATÓRIA",
    "porte_empresa": "",
    "credito_presumido": "",
    "tipo_produtor": "NÃO",
    "logradouro": "RODOVIA MT 345 KM 678",
    "numero": "SN",
    "complemento": "",
    "bairro": "ZONA RURAL",
    "cep": "78467899",
    "uf": "MT",
    "municipio_codigo": "5105259",
    "municipio_descricao": "LUCAS DO RIO VERDE"
  }
]

Exemplo de Resposta de Erro (404)

{
  "error": "NAO_ENCONTRADO",
  "message": "Nenhum registro foi encontrado para os parâmetros informados."
}

Limites e Considerações

Cada requisição de "Consultar" consome 1 crédito
Todas as requisições são registradas no histórico de transações
O token de autenticação deve ser mantido em segurança
Em caso de comprometimento do token, entre em contato com o Suporte