Id em Reference da NF-e: nome da referência e alvo assinado
@IdnfeProc › NFe › ds:Signature › ds:SignedInfo › ds:Reference › @IdRevisão editorial em 15 de out. de 2026. As versões e condições das regras estão indicadas ao longo do artigo.
Reference/@Id identifica o elemento Reference dentro do XML. Ele é opcional no schema fiscal. O endereço do objeto resumido fica em Reference/@URI, e o identificador da informação fiscal está em infNFe/@Id.
Caminho desta página: /nfeProc/NFe/ds:Signature/ds:SignedInfo/ds:Reference/@Id. 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.
Por que o nome da referência não é a chave da nota?
Uma Reference pode ter um rótulo próprio do tipo ID, mas a assinatura fiscal alcança infNFe pela URI. Os três campos não são intercambiáveis. A ausência de Reference/@Id não elimina a obrigatoriedade de URI, de Transforms, de DigestMethod e de DigestValue.
Como representação textual, ReferenciaA pode nomear a referência, enquanto a URI operacional é formada com # e o identificador verdadeiro de infNFe. Não se inventa uma chave para demonstrar essa relação.
Quais restrições e efeitos precisam ser considerados?
O tipo ID exige forma de NCName e unicidade no documento. Nomes com espaços ou iniciados por algarismo não satisfazem essa forma. Um identificador compartilhado por Reference e outro nó cria conflito, mesmo se o programa conseguir visualizar o documento.
O atributo, quando presente, integra Reference, que está dentro de SignedInfo. Mudá-lo pode alterar o SignedInfo canonicalizado e invalidar SignatureValue, ainda que a URI e o digest da nota permaneçam iguais. “Opcional” descreve a estrutura; não autoriza edição posterior.
Como diagnosticar um mapeamento invertido?
Se a aplicação procura infNFe usando Reference/@Id, confira a implementação: ela deveria resolver Reference/@URI. Registre o atributo lido, o nó selecionado e a referência esperada antes de concluir que falta uma chave fiscal. Na geração, teste as duas situações estruturais, com e sem o Id opcional, sem alterar o alvo.
Não se apresenta XML completo porque a referência precisa de dados e resumo reais. Preserve o documento recebido e faça a correção no software em ambiente controlado. A aceitação do identificador pelo schema não comprova validade criptográfica ou autorização.
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; Canonical XML — 1.0, Recommendation 15/03/2001.
Referência técnica para integração
- XPath completo
/nfeProc/NFe/ds:Signature/ds:SignedInfo/ds:Reference/@Id- Namespace
Não informado- Leiaute
- 4.00 · PL_010e_v1.02
- Ocorrências no XSD
- 0–1 no contexto do elemento pai
- Tipo
- ID
- Preenchimento no catálogo
- Opcional
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.