Nota rejeitada por IE do cliente: como conferir a inscrição estadual antes de faturar, no ERP
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 cadastro | O que acontece com a nota |
|---|---|
| Número da IE com tamanho ou dígito errado | Rejeição 210, IE do destinatário inválida. Corrige e retransmite |
| IE do cliente baixada, suspensa ou não habilitada | Rejeição. Corrige o cadastro e retransmite |
| Cliente irregular no estado | Denegaçã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 ATIVA | Rejeiçã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
- No cadastro do cliente. Confira o CNPJ (
GET /api/consultar-cnpj, camposituacao_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. - 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.
- 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á:
curl -X GET "https://api.fiscalapi.com.br/api/consultar?uf=PR&cnpj=12345678000195" \
-H "X-API-Key: fapi_sua_chave_aqui" {
"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 voltou | O que fazer antes da nota |
|---|---|
| situacao_ie igual a Habilitado na UF do cliente | Fature. Na nota, indIEDest 1, com a IE |
| situacao_ie igual a Não habilitado | Nã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 cliente | Em regra, não contribuinte: indIEDest 9, sem IE |
| situacao_cadastral do CNPJ diferente de ATIVA | Nã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.
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