Rejeição 404 — Uso de prefixo de namespace não permitido

O que é esta rejeição?#

A Rejeição 404 é retornada pela SEFAZ quando o sistema identifica o seguinte problema na NF-e: Uso de prefixo de namespace não permitido. A nota fiscal não foi autorizada e precisa ser corrigida antes de ser retransmitida.

Este código indica que rejeição: Uso de prefixo de namespace não permitido.

Causas comuns#

• O XML contém erros de formatação, namespaces inválidos ou codificação incorreta
• A versão do layout XML não é suportada ou é superior à vigente na SEFAZ
• Há caracteres especiais, espaços ou quebras de linha indevidas no XML
• O XML deve usar codificação UTF-8 sem BOM (Byte Order Mark)

Como resolver#

1. Valide o XML com um parser antes de enviar — ele deve ser bem-formado (well-formed)
2. Use apenas o namespace padrão da NF-e: http://www.portalfiscal.inf.br/nfe
3. Salve o XML com codificação UTF-8 sem BOM
4. Atualize a versão do layout no sistema emissor para a versão vigente aceita pela SEFAZ
5. Remova caracteres de edição (tabs, espaços extras) do início e fim do XML

Verificações analíticas#

• Se o XML possui declaração de namespace com prefixo explícito (ex: nfe:NFe ou ns1:infNFe) em vez de namespace padrão sem prefixo no elemento raiz NFe, então o schema está declarado incorretamente causando rejeição 404: substitua toda ocorrência de prefixo qualificado por namespace default xmlns="http://www.portalfiscal.inf.br/nfe" no elemento raiz e remova prefixos de todos os elementos filhos.
• Se o atributo versao do elemento infNFe contém valor diferente de '4.00' (ex: '3.10', '4.0', '4.00 ' com espaço) enquanto a SEFAZ destino exige layout 4.00, então há incompatibilidade de versão de schema que gera rejeição estrutural: corrija o atributo para exatamente versao="4.00" sem espaços ou zeros adicionais e atualize os campos exclusivos do layout 4.00 como infRespTec e indIntermed.
• Se o XML foi serializado com BOM UTF-8 (bytes EF BB BF no início do arquivo) e o elemento NFe não é o primeiro nó do documento, ou se há caracteres de whitespace, tabulação ou quebra de linha antes da declaração <?xml version='1.0' encoding='UTF-8'?>, então o parser da SEFAZ rejeita o documento como mal-formado: regenere o XML garantindo que o byte inicial seja exatamente 3C (menor-que do '<?xml') sem BOM e sem whitespace precedente.
• Se o XML contém entidades de caractere não declaradas ou caracteres fora do plano BMP Unicode (como emojis ou símbolos acima de U+FFFF) em campos de texto livre como xNome, xFant, xObs ou infCpl, enquanto o encoding declarado é UTF-8, então a serialização produz sequências de bytes inválidas para o parser SEFAZ: sanitize todos os campos textuais removendo caracteres com code point acima de U+FFFF e substitua caracteres especiais problemáticos (aspas, ampersand, menor-que) pelas entidades XML canônicas &amp; &lt; &gt; &apos; &quot;.
• Se o documento possui múltiplas declarações de namespace para o mesmo URI (ex: xmlns="http://www.portalfiscal.inf.br/nfe" redeclarado em elementos filhos como infNFe, det ou imposto) ou namespace redundante xmlns:xsi sem uso efetivo de xsi:type ou xsi:schemaLocation no contexto da NF-e 4.00, então o validador SEFAZ interpreta o prefixo como não permitido conforme rejeição 404: remova todas as declarações de namespace duplicadas ou desnecessárias mantendo apenas o xmlns único no elemento raiz NFe.