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

Id em SignatureValue da NF-e: atributo e conteúdo são distintos

@IdnfeProc › NFe › ds:Signature › ds:SignatureValue › @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.

SignatureValue/@Id é um identificador XML opcional do elemento que contém a assinatura. O valor criptográfico está no texto de SignatureValue, em Base64; ele não é calculado a partir do nome escolhido para o atributo.

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

Como separar identificador e bytes da assinatura?

O schema define SignatureValueType como extensão de base64Binary, acrescentando Id opcional do tipo ID. Assim, um parser precisa ler duas informações de naturezas diferentes: atributo de identificação e conteúdo binário codificado.

A referência fiscal da nota permanece em SignedInfo/Reference/@URI, apontando para infNFe. Ela não deve ser redirecionada a SignatureValue por esse elemento ter um Id. Nomear o resultado da assinatura não faz dele os dados fiscais assinados.

Declaração XSD do contexto.

Quais exemplos ajudam a reconhecer um erro de formato?

Como representação textual, o nome ValorAssinadoA tem forma de ID; valor assinado não tem, por conter espaço. O nome deve ser único no documento. Esses exemplos demonstram apenas a forma, sem criar uma assinatura.

Cenário: o exportador grava o atributo corretamente, mas o texto de SignatureValue está vazio ou truncado. A presença do identificador não recupera os bytes. No cenário inverso, uma assinatura pode ter o conteúdo completo e omitir esse atributo opcional sem perder por isso a estrutura exigida.

XML Schema: tipo ID.

O que conferir em uma integração?

Confirme que o código de extração lê o conteúdo de SignatureValue em vez de @Id. Se o erro se refere a ID duplicado, enumere os identificadores de todo o documento; se se refere à assinatura calculada, investigue o conteúdo, as referências e a canonicalização. As mensagens pertencem a camadas diferentes.

Não se fornece XML completo porque ele exigiria o valor criptográfico e o certificado correspondentes. Preserve os originais e ajuste o mapeamento em teste controlado. Um rótulo aceito pelo XSD não prova autoria, integridade nem autorização da nota.

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 Schema Part 2: Datatypes — Second Edition, 28/10/2004; 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:SignatureValue/@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.