API

Dicionário de Rejeições SEFAZ e NFS-e Nacional (NF-e, NFC-e, CT-e, MDF-e e SNNFSE): Guia Rápido para APIs

Tabela de referência rápida com as principais rejeições da SEFAZ e do Sistema Nacional da NFS-e (204, 215, 225, 228, 434, 531, 539, 591, 611, 694, 851, 930, 972, E0084, E0116, E363, E637, E0718): causa exata e como corrigir via API.

Fábio Magalhães CostaAtualizado em 22/11/2026
Dicionário de consulta rápida das principais rejeições da SEFAZ e do Sistema Nacional da NFS-e para desenvolvedores

Dicionário de consulta rápida das principais rejeições da SEFAZ e do Sistema Nacional da NFS-e para desenvolvedores

Quando uma nota fiscal é rejeitada em produção, ninguém quer ler 400 páginas do Manual de Orientação do Contribuinte para descobrir qual campo JSON está faltando. Reuni neste dicionário de consulta rápida as rejeições mais frequentes de NF-e, NFC-e, CT-e, MDF-e e NFS-e Nacional (SNNFSE) que encontramos no dia a dia de integrações via API, com a causa direta e o link para o guia técnico completo de correção.

Salve esta página nos favoritos do time de engenharia e suporte fiscal. Todas as rejeições abaixo são tratadas com mensagens estruturadas em JSON na API da Notaas e podem ser diagnosticadas automaticamente pelo servidor MCP @notaas/mcp.


Rejeições de NF-e (Modelo 55) e NFC-e (Modelo 65)

Código Descrição SEFAZ Causa Direta Guia Completo
204 / 539 Duplicidade de NF-e/NFC-e (com ou sem diferença na chave) Retentativa de rede gerou novo cNF ou reaproveitou número já autorizado. Resolver Rejeição 539 e 204
215 / 225 Falha no Schema XML da NF-e ou do Lote Tag fora de ordem, campo obrigatório vazio ou formato inválido (ex.: NCM, CEP, hashCSRT). Resolver Rejeições 225 e 215
228 Data de Emissão muito atrasada Tentativa de emissão retroativa fora da janela permitida pela SEFAZ estadual. Emissão Retroativa e Rejeição 228
391 / 768 / 963 Grupo <card> / tPag 16 (Depósito) ou 19 (Cashback) Inconsistência no tipo de integração de pagamento ou CNPJ da credenciadora. Resolver Rejeições 768, 963 e 391
402 / 878 Codificação UTF-8/ASCII ou URL do QR Code NFC-e Caractere inválido no XML ou hash/URL de consulta do QR Code fora do padrão da UF. Resolver Rejeições 402 e 878
434 / 438 Intermediador de Marketplace (indIntermed / infIntermed) Venda pela internet/delivery (indPres 2 ou 4) sem informar indicador ou CNPJ do marketplace. Resolver Rejeições 434 e 438
591 Informado CSOSN para emissor que não é do Simples Empresa no CRT = 2 (excesso de sublimite) ou CRT = 3 enviando CSOSN em vez de CST. CRT 2 e Rejeição 591
694 / 695 / 698 / 793 Grupo de ICMS para a UF de Destino (DIFAL / FCP) Falta de <ICMSUFDest> em venda interestadual para não contribuinte (CRT 2/3) ou alíquota divergente. DIFAL e FCP na NF-e (EC 87)
851 / 852 / 898 Soma das Duplicatas (<dup>) / Vencimento inválido Soma das parcelas difere de vLiq, número da parcela fora de 001..999 ou vencimento retroativo. Fatura, Duplicatas e autXML
928 / 930 / 931 Código de Benefício Fiscal (cBenef) e Desoneração CST com benefício fiscal em UF obrigada sem cBenef válido ou incompatível com a tabela estadual. Resolver cBenef e Rejeições 928–931
972 / 978 Responsável Técnico (infRespTec) / hashCSRT Faltou <infRespTec> em UF obrigada ou hashCSRT calculado em hex em vez de Base64 binário. infRespTec, CSRT e Rejeição 972
W16-10 Total do vNF difere do somatório dos itens ICMS-ST, IPI ou vICMSDeson não somado/subtraído corretamente no totalizador <ICMSTot>. ICMS-ST e Rejeição W16-10

Rejeições de NFS-e Nacional (SNNFSE / ADN) e Reforma Tributária (IBS/CBS)

Código Descrição SNNFSE Causa Direta Guia Completo
E0084 Estabelecimento não habilitado no CNC CNPJ não sincronizado pela prefeitura no Cadastro Nacional de Contribuintes ou rota errada. Rejeições CNC E0084, E0116, E0120
E0116 / E0120 Divergência ou ausência de Inscrição Municipal IM enviada com zeros a mais/menos ou ausente para município que exige no CNC. Rejeições CNC E0084, E0116, E0120
E363 / E637 Tríade Anexo VIII (NBS × cIndOp × cClassTrib) inválida Combinação de NBS, cIndOp e cClassTrib não pertence à mesma linha oficial do Anexo VIII. Anexo VIII e Erro E363 · Erro E637
E0714–E0718 Certificado digital não pertence ao prestador Assinatura com certificado diferente do CNPJ/CPF prestador sem vínculo QSA, matriz/filial ou procuração 00233. Resolver Erros E0714 a E0718
E0903 / E0932 Campos IBS/CBS para imóvel (tpOper / gRefNFSe) Preenchimento incompleto ou incompatível no grupo <imovel> da NT-009. Resolver Erros E0903 e E0932

Rejeições de CT-e (Modelo 57) e MDF-e (Modelo 58)

Código Descrição SEFAZ Causa Direta Guia Completo
531 (CT-e) Total do vTotDFe diverge do cálculo Novo totalizador da Reforma Tributária no CT-e 4.00 divergindo de vTPrest + IBS/CBS. Resolver Rejeição 531 no CT-e
611 (MDF-e) Existe MDF-e não encerrado para esta placa e UF Motorista tentou emitir novo MDF-e sem encerrar o manifesto anterior na SEFAZ. Encerrar MDF-e e Resolver Rej. 611
539 / 646 (CT-e) Duplicidade ou numeração no CT-e 4.00 Fim da inutilização de numeração no CT-e 4.00 e regras de controle sequencial. CT-e 4.00 e Rejeições 539/215/646

Ferramentas Gratuitas para Validar Antes de Transmitir

Antes de enviar sua nota para a SEFAZ ou SNNFSE, use nossa suíte gratuita (sem cadastro):

Quer diagnosticar rejeições automaticamente direto no seu editor (Claude Code / Cursor) ou emitir com 20 notas gratuitas por mês em produção real?

Notaas — Infraestrutura Fiscal Multi-Tenant para SaaS, ERPs e BPOs

Escale a emissão de NFS-e, NF-e, NFC-e, CT-e e MDF-e para dezenas de CNPJs

Integre a API de Nota Fiscal da Notaas no seu software: provisione clientes via Org API Multi-CNPJ, isole certificados A1 em nuvem, receba webhooks assinados com HMAC e gere DANFSe v2.0 local. Sandbox ilimitado e planos sob medida para operações em escala.

Artigos Relacionados em API

Guias Pilares de Integração Fiscal