chNFAg
Chave de acesso da NFAg referenciada
Onde fica no arquivo
No documento
-
NFAg/infNFAg/gSub/chNFAg
Obrigatório, uma vez
-
nfagProc/protNFAg/infProt/chNFAg
Obrigatório, uma vez
Chave de acesso da NFAg
-
nfagProc/NFAg/infNFAg/gSub/chNFAg
Obrigatório, uma vez
Nos eventos
-
eventoNFAg/infEvento/chNFAg
Obrigatório, uma vez
Chave de Acesso da NFAg vinculada ao evento
Na consulta ao web service
-
consSitNFAg/chNFAg
Obrigatório, uma vez
Chaves de acesso da NFAg
Na resposta do web service
-
retEventoNFAg/infEvento/chNFAg
Opcional, no máximo uma vez
Chave de Acesso NFAg vinculada
-
retNFAg/protNFAg/infProt/chNFAg
Obrigatório, uma vez
Chave de acesso da NFAg
No arquivo distribuído (documento + protocolo)
-
procEventoNFAg/eventoNFAg/infEvento/chNFAg
Obrigatório, uma vez
Chave de Acesso da NFAg vinculada ao evento
-
procEventoNFAg/retEventoNFAg/infEvento/chNFAg
Opcional, no máximo uma vez
Chave de Acesso NFAg vinculada
O caminho até aqui, nível a nível
Dentro do grupo gSub , grupo de informações da substituição
O que o arquivo aceita neste campo
- Ocorrência
- 1-1
- Tamanho
- até 44
- Tipo no esquema
- TChDFe
- Formato base
- string
Formato exigido: [0-9]{6}[A-Z0-9]{12}[0-9]{26} Expressão do próprio esquema. Valor que não casar com ela é recusado na validação do arquivo, antes de qualquer regra de negócio. ⚠ A leitura acima sai da EXPRESSÃO, não do nome do tipo: nome de tipo se expande por palpite e palpite publica regra errada.
Campos do mesmo grupo — 1
São os campos que ficam ao lado deste no arquivo, dentro de NFAg/infNFAg/gSub. Quem
preenche um costuma precisar dos outros na mesma passada.
Perguntas frequentes
O que é o campo chNFAg da NFAg?
Chave de acesso da NFAg referenciada No XML ele fica em NFAg/infNFAg/gSub/chNFAg. Obrigatório, uma vez, com tamanho até 44.
chNFAg aparece em quantos lugares da NFAg?
Em 9 posições do esquema oficial: NFAg/infNFAg/gSub/chNFAg, nfagProc/protNFAg/infProt/chNFAg, nfagProc/NFAg/infNFAg/gSub/chNFAg, eventoNFAg/infEvento/chNFAg, consSitNFAg/chNFAg, retEventoNFAg/infEvento/chNFAg e outras. A mesma tag em posições diferentes tem ocorrência própria em cada lugar — o que vale no grupo do emitente não vale automaticamente no do destinatário.
De onde vem esta descrição da NFAg?
Do esquema XML oficial (PL_NFAg_NT2026.004_RTC_1.00_correcao). O Buscador NCM lê a árvore do próprio arquivo: tipo, tamanho, ocorrência e domínio saem sem interpretação. O manual manda na REGRA de validação; o esquema manda no CAMPO.