Reference da NF-e: vínculo entre infNFe, transformações e digest

Reference liga os dados fiscais de infNFe ao SignedInfo assinado. Ela identifica o alvo por URI, declara as transformações e registra o método e o resultado do resumo criptográfico desses dados.

Caminho desta página: /nfeProc/NFe/ds:Signature/ds:SignedInfo/ds:Reference. 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.

Qual conteúdo e quais atributos pertencem a Reference?

O tipo fiscal exige uma única Reference dentro de SignedInfo. Seus filhos são, em ordem, Transforms, DigestMethod e DigestValue. URI é obrigatório, do tipo derivado de anyURI com comprimento mínimo 2; Id e Type são opcionais.

URI localiza o objeto resumido. Id identifica a própria referência, e Type pode descrever o tipo do objeto referido; nenhum dos dois substitui a localização. O perfil fiscal determina infNFe como alvo, usando # seguido do seu identificador. O XSD sozinho não comprova que essa localização existe ou é o nó correto.

Declaração XSD do contexto.

Como conferir o vínculo com a nota?

Resolva a URI no documento preservado, exigindo o infNFe esperado e evitando seleção ambígua por nomes repetidos. A chave de acesso usada no identificador precisa pertencer à nota em análise. Aplique as transformações declaradas e calcule SHA-1 do resultado; compare os bytes obtidos com DigestValue decodificado de Base64.

Depois verifique SignatureValue sobre SignedInfo canonicalizado. Conferir somente a referência demonstra, no máximo, a correspondência do resumo nessa etapa; a autenticidade criptográfica e a confiança do certificado ainda precisam ser verificadas.

XMLDSig: processamento e elementos.

O que fazer quando a referência não resolve?

Cenário 1: a URI aponta para o Id da própria Signature. O XML pode ter uma URI lexicalmente aceitável, mas o alvo fiscal está errado. Cenário 2: a URI é uma URL externa. Não a consulte automaticamente nem envie dados para esse endereço; ela diverge da referência interna prevista para a nota. Cenário 3: o identificador existe duas vezes. A leitura precisa rejeitar a ambiguidade, sem escolher o primeiro nó encontrado.

Não há XML completo de referência neste artigo: seria necessário um infNFe original e o resumo correspondente. Preserve o arquivo e investigue o gerador. Trocar a URI depois de assinar altera SignedInfo e não é reparo de documento autorizado.

MOC: perfil de assinatura, pp. 53–56.

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; XML Signature Syntax and Processing — 1.1, Recommendation 11/04/2013; XML Schema Part 2: Datatypes — Second Edition, 28/10/2004.