NFe dentro de nfeProc: onde estão a nota fiscal e a assinatura

NFe em /nfeProc/NFe é o elemento que contém a nota eletrônica dentro do arquivo processado. protNFe é seu irmão no envelope: o protocolo não fica dentro de NFe e não faz parte dos dados fiscais de infNFe.

Identidade técnica: tag; XPath /nfeProc/NFe.

Nesta página:

• O conteúdo de NFe e sua ordem
• Como ler a nota sem perder o contexto
• Conferir um arquivo recebido
• Leituras relacionadas

O conteúdo de NFe e sua ordem

O tipo TNFe começa por um infNFe, admite depois infNFeSupl e termina com a assinatura Signature do namespace XMLDSig. O suplemento contém, quando cabível, QR Code e URL de consulta; não é o protocolo nem o conjunto principal de dados fiscais. A nota usa o namespace http://www.portalfiscal.inf.br/nfe, enquanto a assinatura usa http://www.w3.org/2000/09/xmldsig#. Fonte: XSD PL 010f v1.04, TNFe.

A versão do bloco fiscal fica em infNFe/@versao; não crie NFe/@versao por analogia. O modelo 55 ou 65 e o ambiente estão em infNFe/ide. O mesmo nome NFe também pode ser a raiz de um arquivo de nota isolada.

Como ler a nota sem perder o contexto

Em documento processado, procure /n:nfeProc/n:NFe/n:infNFe; em nota isolada, /n:NFe/n:infNFe. Associe n ao namespace da NF-e. Para a assinatura, use outro prefixo associado a XMLDSig. Remover namespaces para facilitar a busca pode fazer uma integração confundir elementos de origens diferentes.

Diagrama XML parcial, sem dados suficientes para validação:

<NFe xmlns="http://www.portalfiscal.inf.br/nfe">
  <infNFe versao="4.00" Id="NFe35191000000000000000550010000000011000000010">
    <!-- identificação, participantes, itens e totais -->
  </infNFe>
  <Signature xmlns="http://www.w3.org/2000/09/xmldsig#">
    <!-- assinatura original -->
  </Signature>
</NFe>

A chave é fictícia e serve apenas para mostrar posição e prefixo, sem afirmar dígito verificador ou autorização. O suplemento foi omitido porque é opcional estruturalmente.

Conferir um arquivo recebido

Compare infNFe/@Id com protNFe/infProt/chNFe, confira modelo e ambiente e valide a assinatura. Não confunda XML bem formado, XML válido no schema e nota autorizada: são verificações distintas. O protocolo e a situação atual precisam ser conferidos separadamente conforme o MOC 7, Anexo I.

Se o sistema de importação diz que não encontrou a nota, confira se recebeu nfeProc, NFe, um resumo de distribuição ou um evento. Se encontrou dados, mas perdeu a assinatura ao salvar, investigue a transformação do arquivo. Corrija o leitor ou recuperador, preservando os bytes originais; não reconstrua assinatura ou protocolo para fazer a importação passar.

Leituras relacionadas

O bloco infNFe organiza os dados fiscais e a referência da assinatura. infNFe — /nfeProc/NFe/infNFe.