Id em SignatureValue da NF-e: atributo e conteúdo são distintos
@IdnfeProc › NFe › ds:Signature › ds:SignatureValue › @IdRevisã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.
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.
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.