fiscal-mcp

fiscal-mcp / rejeições

Rejeição da SEFAZ, explicada para quem integra

Uma página por código: o que de fato aconteceu, qual campo do XML mudar, e o comando que reproduz o diagnóstico na sua máquina — sem certificado, sem cadastro e sem transmitir nada.

12 códigos catalogados 8 com XML de antes e depois
01.

O catálogo

códigoo que significareversível XML de exemplo
204Duplicidade de NF-e — já existe nota autorizada com essa chave de acesso.reversívelsim
217NF-e não consta na base de dados da SEFAZ.reversível
225Falha no schema XML — o arquivo não obedece ao leiaute.reversívelsim
228Data de emissão muito atrasada.reversívelsim
233Inscrição estadual do destinatário não informada.reversívelsim
236Chave de acesso com dígito verificador inválido.reversívelsim
266Série da NF-e diferente da série informada na chave de acesso.reversívelsim
301Uso denegado — irregularidade fiscal do emitente.irreversível
302Uso denegado — irregularidade fiscal do destinatário.irreversível
539Duplicidade de NF-e com diferença na chave de acesso — mesmo número e série já autorizados, mas com chave diferente.reversívelsim
610Total da NF-e diferente do somatório dos itens.reversívelsim
999Erro não catalogado no processamento da SEFAZ.reversível
02.

Por que estas páginas existem

Rejeição chega tarde, custa uma transmissão e vem com mensagem críptica. Quem integra não quer saber o que a legislação diz — quer saber qual campo mudar e como reproduzir o erro antes de gastar outra transmissão.

As páginas são geradas a partir do mesmo catálogo que a ferramenta explicar_rejeicao usa. Catálogo e documentação não divergem porque são a mesma coisa.

O catálogo cobre as rejeições mais frequentes em integração nova, e está longe de ser a lista completa. Onde falta exemplo, a página diz que falta: inventar XML fiscal errado é pior do que a lacuna.

O que estas páginas não são

  • Não são a transcrição literal da mensagem da SEFAZ — a redação muda por UF e por versão do Manual de Orientação do Contribuinte. O que não muda é o código.
  • Não substituem o Manual de Orientação do Contribuinte nem a validação da própria SEFAZ.
  • Levou um código que não está aqui? Abra uma issue — é a contribuição mais barata que existe no projeto.