Rejeição 404: prefixo de namespace não permitido no XML fiscal
Revisão editorial em 16 de out. de 2026. Confira as versões e condições das regras nas fontes do artigo.
A rejeição 404, regra D02, verifica o uso de prefixo de namespace na área de dados fiscal. Mesmo que um parser XML aceite um prefixo associado à URI correta, o padrão da NF-e determina a declaração padrão sem prefixar suas tags.
Nesta página:
- Prefixo e namespace são a mesma informação?
- Exemplo: biblioteca acrescenta um prefixo automaticamente
- O prefixo SOAP também deve ser removido?
- Como conferir o resultado e distinguir 587?
Prefixo e namespace são a mesma informação?
Não. O namespace identifica o vocabulário por uma URI; o prefixo é uma forma de referenciá-lo na escrita das tags. O MOC exige o namespace fiscal padrão e veda prefixos nas tags de NF-e. Assim, não basta que o prefixo aponte para a URI correta.
D02 é obrigatória no quadro de validação. Confira o XML emitido pelo serializador e a árvore efetiva, porque alguns clientes adicionam prefixos automaticamente ao montar ou recarregar a mensagem.
Fontes: MOC Anexo I, regra D02.
Exemplo: biblioteca acrescenta um prefixo automaticamente
Suponha que a aplicação gere elementos do vocabulário fiscal com um prefixo criado pela biblioteca. O documento pode continuar bem formado e representar o mesmo namespace para um parser genérico, mas contrariar o formato fiscal exigido.
A correção deve configurar a declaração padrão na raiz fiscal e a serialização de seus descendentes. Não use uma troca textual global de nomes: ela pode atingir conteúdo, atributos ou elementos de outros vocabulários. Regenere a mensagem e confira sua assinatura no resultado final.
Fontes: MOC Anexo I, regra D02.
O prefixo SOAP também deve ser removido?
Não deduza essa ação de D02. O envelope SOAP é a camada de transporte e tem seu próprio namespace. A assinatura XML também possui o namespace XMLDSig, cuja declaração o MOC coloca em Signature. A restrição deve ser aplicada no contexto fiscal documentado, sem transformar elementos SOAP ou XMLDSig em elementos NF-e.
Na inspeção, delimite a raiz da área de dados, suas tags e a assinatura. O namespace fiscal exato continua sendo http://www.portalfiscal.inf.br/nfe; remover prefixo não corrige uma URI errada.
Fontes: MOC Anexo I, regra D02.
Como conferir o resultado e distinguir 587?
A 404 aponta prefixo; a 587, namespace diferente do padrão. Depois de ajustar o serializador, valide o XSD aplicável, confira a ausência de prefixos fiscais e verifique a assinatura. Um arquivo já autorizado não deve ser reescrito para padronização estética.
Se a mensagem rejeitada foi a única tentativa conhecida, preserve seu retorno. Quando houver tentativa anterior sem resposta conclusiva, consulte a situação antes de repetir a ação. Superar D02 não significa que o documento foi autorizado.
Fontes: MOC Anexo I, regra D02.
Limite do exemplo e preservação dos dados
A correção precisa da árvore XML e da assinatura originais protegidas. A comparação textual mostra o efeito do prefixo sem fabricar uma nota completa nem alterar namespaces operacionais. A conferência deve preservar o original e ocorrer em ambiente protegido; não publique certificado, senha, chave privada ou dados fiscais de clientes.
Fontes oficiais
- MOC 7.0 — Anexo I, versão 7.00. p. 72, regra D02, código 404; quadro completo e notas da seção.
- MOC 7.0 — Visão Geral, versão 7.00. pp. 49–51, declaração, namespace, otimização, UTF-8 e validação; pp. 53–55, assinatura XML.