Pular para o conteúdo
FiscalAPI
FiscalAPI
Inscrição Estadual

Nota rejeitada por IE do cliente: como conferir a inscrição estadual antes de faturar, no ERP

Equipe FiscalAPI 4 min de leitura
Inscrição EstadualNF-eERPAPISEFAZ

Na distribuidora e na indústria, o pedido é aprovado, a carga é separada e a nota volta rejeitada porque a inscrição estadual do cliente foi baixada ou não está habilitada. O defeito não está no pedido, está no cadastro, que ninguém revisou desde a primeira compra. A conferência cabe numa chamada de API antes de faturar e numa revalidação da carteira em lote.

Atualizado em 18/11/2026.

O que um cadastro velho causa na nota

O que está errado no cadastroO que acontece com a nota
Número da IE com tamanho ou dígito erradoRejeição 210, IE do destinatário inválida. Corrige e retransmite
IE do cliente baixada, suspensa ou não habilitadaRejeição. Corrige o cadastro e retransmite
Cliente irregular no estadoDenegação 302. A chave fica gravada e queimada, a nota não pode ser cancelada e é preciso emitir outra depois de resolver
CNPJ do cliente fora de ATIVARejeição 182, a partir de 16/11/2026

A rejeição custa retrabalho. A denegação custa mais: a chave daquela nota não volta. Todas vêm do mesmo lugar, o cadastro do cliente. Para a lista completa, veja as rejeições mais comuns na NF-e.

Onde colocar a conferência no ERP

  1. No cadastro do cliente. Confira o CNPJ (GET /api/consultar-cnpj, campo situacao_cadastral) e a IE no estado dele (GET /api/consultar?uf=&cnpj=). Se não souber em que estado o cliente tem inscrição, GET /api/consultar-ie-todos?cnpj= procura nos 27 numa chamada.
  2. Antes de faturar. Confira a IE do estabelecimento que recebe a mercadoria. Cada filial tem CNPJ e IE próprios: consulte o CNPJ da filial na UF dela.
  3. Todo mês. Revalide a carteira, porque a IE ativa no primeiro pedido pode estar baixada no próximo.

A chamada é um GET com a chave no cabeçalho X-API-Key, feita de onde o ERP já fala com a internet. Não há conector pronto. No TOTVS Protheus, um fonte ADVPL ou TLPP com FWRest ou HttpGet, por exemplo num ponto de entrada do cadastro de clientes. No SAP ECC ou S/4HANA, ABAP com cl_http_client ou um fluxo no SAP Integration Suite. Em Sankhya, Senior, Omie e Bling, um serviço intermediário (script, n8n ou Make) chama a API e atualiza o cadastro pela API do ERP. No Odoo, um módulo próprio em Python.

Exemplo com dados fictícios, de um cliente no Paraná:

bash
curl -X GET "https://api.fiscalapi.com.br/api/consultar?uf=PR&cnpj=12345678000195" \
  -H "X-API-Key: fapi_sua_chave_aqui"
json
{
  "document": "12345678000195",
  "document_type": "cnpj",
  "uf": "PR",
  "results": [
    {
      "inscricao_estadual": "2345678967",
      "razao_social": "PADARIA MODELO LTDA",
      "situacao_ie": "Não habilitado",
      "tipo_ie": "IE Normal",
      "municipio": "MARINGA",
      "uf_ie": "PR",
      "situacao_nfe": ""
    }
  ]
}

Leitura: o CNPJ pode estar ativo e a IE do Paraná, não. Esse pedido não deve sair com essa IE antes de o cliente regularizar.

O que fazer com cada resposta

O que voltouO que fazer antes da nota
situacao_ie igual a Habilitado na UF do clienteFature. Na nota, indIEDest 1, com a IE
situacao_ie igual a Não habilitadoNão emita com essa IE. Segure o pedido e revise o cadastro com o cliente
situacao_contribuinte com "Vedada operação como Destinatário na UF" ou "Bloqueado como Destinatário na UF"Revise antes de emitir: o próprio campo diz que o cliente não pode receber como destinatário naquela UF
results vazio na UF do clienteEm regra, não contribuinte: indIEDest 9, sem IE
situacao_cadastral do CNPJ diferente de ATIVANão fature até esclarecer

Dois campos ajudam a automatizar a regra. situacao_nfe lista os documentos eletrônicos habilitados da inscrição, como NFe ou NFCe, NFe. regime_apuracao_icms traz o regime de apuração do ICMS.

O detalhe da regra do indIEDest está em como saber se o cliente é contribuinte do ICMS.

A carteira inteira em lote

Sem programar: no painel, suba uma planilha .xlsx com até 20.000 linhas. CNPJ, CPF e IE podem vir misturados na mesma coluna, e cliente repetido é consultado uma vez só. No fim, você baixa um Excel com IE, razão social, situação cadastral e UF de cada cliente, pronto para importar no ERP.

Com programa: um job noturno chama a API uma vez por cliente e grava a situação no cadastro. A documentação tem scripts prontos em Python e Node que leem a lista de CNPJs e retomam de onde pararam.

Quanto custa

Conferir o CNPJ e a IE de um cliente são 2 consultas: R$ 0,05 no Enterprise (R$ 250 por mês, 10.000 consultas), R$ 0,13 no Pro (R$ 130, 2.000) e R$ 0,20 no Starter (R$ 50, 500). Na planilha, cada documento conta 1 consulta.

Para começar

Veja a API de inscrição estadual, a consulta em massa por planilha e a documentação de Consultar IE por UF.

Perguntas frequentes

O cliente tem várias filiais. Qual IE vai na nota? A do estabelecimento que recebe a mercadoria. Consulte o CNPJ da filial na UF dela.

Tenho 15 mil clientes. Preciso programar para revalidar? Não. Suba a planilha no painel e baixe o resultado. Para rotina automática, use a API num job seu.

Não sei em que estado o cliente tem inscrição. Use GET /api/consultar-ie-todos?cnpj=: a busca nos 27 estados custa o mesmo que a de um estado.

O cliente diz que é isento de IE. A consulta confirma? Não. A consulta mostra se existe IE e a situação dela. A isenção de inscrição (indIEDest 2) o cliente precisa comprovar.

Compartilhar: WhatsApp LinkedIn Twitter

Consulte dados fiscais via API

Consulte Inscrições Estaduais, CNPJs e Certidões Negativas via API REST, com resposta em JSON. Planos a partir de R$ 50/mês.

Criar conta