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

Id em Reference da NF-e: nome da referência e alvo assinado

@IdnfeProc › NFe › ds:Signature › ds:SignedInfo › ds:Reference › @Id

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/@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.

Declaração XSD do contexto.

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.

XML Schema: tipo ID.

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.