Pular para o conteúdo
Fiscal ProBiblioteca
Rejeição 404 · Regra D02

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?

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