Pular para o conteúdo
Fiscal ProBiblioteca
NF-e e NFC-e · Suplemento, assinatura e protocolo

URI em Reference da NF-e: como localizar o infNFe assinado

@URInfeProc › NFe › ds:Signature › ds:SignedInfo › ds:Reference › @URI

Revisão editorial em 15 de out. de 2026. As versões e condições das regras estão indicadas ao longo do artigo.

Reference/@URI indica quais dados entram no cálculo do resumo da assinatura. Na assinatura da NF-e, o MOC determina a referência interna ao infNFe identificado por seu atributo Id, precedido de # na URI.

Caminho desta página: /nfeProc/NFe/ds:Signature/ds:SignedInfo/ds:Reference/@URI. O alias ds neste XPath representa o namespace http://www.w3.org/2000/09/xmldsig#; ele permite localizar o elemento, mas não exige esse prefixo na serialização fiscal.

Como a URI precisa se relacionar com Id?

A relação é textual: URI é # seguido exatamente do valor de infNFe/@Id. Esse identificador começa pelo literal NFe e incorpora a chave de acesso da nota. É preciso preservar caixa, caracteres e o vínculo com a nota real; não reconstruir uma chave hipotética para fazer o verificador passar.

O tipo fiscal exige URI com no mínimo dois caracteres. Essa restrição lexical rejeita a URI vazia, mas não valida a existência do alvo nem garante que ele é infNFe. Resolver a referência corretamente é uma obrigação adicional do processamento.

Declaração XSD do contexto.

Como distinguir essa URI dos endereços dos algoritmos?

Uma URI em Algorithm identifica um procedimento reconhecido pela implementação. Aqui, URI identifica os dados referenciados. Não se deve usar o endereço de SHA-1 ou C14N como referência à nota.

Exemplo de conferência, sem XML completo nem chave inventada: copie o valor original de infNFe/@Id, acrescente apenas o marcador # para a comparação e confira a igualdade com a URI recebida. Em seguida garanta que esse valor identifica um único nó infNFe e que é aquele usado pelo restante da aplicação. Um nome de atributo igual em Signature ou Reference não é o alvo fiscal.

XMLDSig: processamento e elementos.

O que fazer se o alvo estiver ausente ou externo?

Se o identificador não existe, compare o XML originalmente assinado com o recebido e a sequência de montagem. Se há duplicidade, não selecione o primeiro nó. Se há URL externa, bloqueie a resolução automática para rede e investigue a origem; esse formato não corresponde à referência interna descrita para a NF-e.

Preserve os arquivos para diagnóstico. Mudar URI em um XML pronto altera SignedInfo e não recalcula o digest ou a assinatura. A regra F01/298 trata divergência do padrão, inclusive ausência de Reference URI. Mesmo uma URI correta não basta: transformações, digest, assinatura, certificado e autorização são verificados separadamente.

MOC: validações de assinatura.

Fontes e contexto

Schema específico XMLDSig da NF-e — PL_010f_v1.04 / xmldsig-core-schema_v1.01.xsd; MOC — Visão Geral — 7.0; MOC — Anexo I, Leiaute e Regras de Validação — 7.0; XML Signature Syntax and Processing — 1.1, Recommendation 11/04/2013.

Referência técnica para integração

XPath completo
/nfeProc/NFe/ds:Signature/ds:SignedInfo/ds:Reference/@URI
Namespace
Não informado
Leiaute
4.00 · PL_010e_v1.02
Ocorrências no XSD
1–1 no contexto do elemento pai
Tipo
inline:anyURI · anyURI
Preenchimento no catálogo
Obrigatório

A ocorrência vale dentro da estrutura XML: um campo obrigatório em um grupo opcional não torna esse grupo obrigatório. A aplicação fiscal depende da operação e da versão da regra.

minLength
2