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

Id em KeyInfo da NF-e: identificação do grupo de chave

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

O atributo Id de KeyInfo nomeia esse grupo dentro do documento XML. O schema o admite como opcional do tipo ID. Sua existência não é necessária para extrair a chave pública de X509Certificate no perfil NF-e.

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

O que o Id identifica e o que fica no certificado?

KeyInfo/@Id identifica o elemento KeyInfo. O número de série, o titular, a autoridade emissora e a chave pública são dados do certificado X.509 que está em X509Data/X509Certificate. Nenhum desses dados deve ser deduzido de um nome arbitrário do grupo.

Na assinatura da NF-e, a referência fiscal aponta para infNFe/@Id; ela não precisa apontar para KeyInfo/@Id. No XMLDSig geral é possível construir outras relações entre assinaturas e informações de chave, mas essa possibilidade não altera o alvo fiscal da nota.

Declaração XSD do contexto.

Como conferir formato e unicidade?

O tipo ID tem forma de nome XML sem dois-pontos, não admite espaços como separadores e exige unicidade no documento. Como exemplos puramente textuais, ChavePublicaA tem forma de identificador, enquanto chave publica não tem. Esses nomes não são valores fiscais nem uma sugestão de preenchimento.

Se KeyInfo e Signature reutilizam o mesmo ID, a montagem está errada. A ausência do atributo opcional, por outro lado, não significa ausência do grupo obrigatório ou do certificado.

XML Schema: tipo ID.

Como investigar uma leitura incorreta?

Se a aplicação informa que não encontrou certificado porque KeyInfo está sem Id, confira o seletor utilizado. A árvore Signature/KeyInfo/X509Data/X509Certificate permite localizá-lo por nome expandido e ancestral, sem depender de um rótulo opcional. Se o erro é “identificador duplicado”, registre todos os nós com o valor repetido antes de atribuir o problema ao certificado.

Não se apresenta um XML completo: o grupo exige o certificado real. A correção deve ser feita no mapeamento ou gerador com teste controlado, preservando o arquivo recebido. Renomear um identificador no documento já assinado não substitui a verificação criptográfica e do estado fiscal.

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