chNFAgFat
Chave de acesso da NFAg faturada em conjunto Obrigatorio para tpFat 3 Vedado para tpFat 1 e 2
Onde fica no arquivo
No documento
-
NFAg/infNFAg/gFatConjunto/chNFAgFat
Obrigatório, uma vez
-
nfagProc/NFAg/infNFAg/gFatConjunto/chNFAgFat
Obrigatório, uma vez
O caminho até aqui, nível a nível
- NFAg — Nota Fiscal Eletrônica da Agua
- └ infNFAg — Informações da NFAg
- └ gFatConjunto — Grupo de Informações do Faturamento conjunto
- └ chNFAgFat — você está aqui
Dentro do grupo gFatConjunto , grupo de Informações do Faturamento conjunto
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.
As regras que verificam este campo — 7
O manual cita a tag pelo caminho no XML. Cada regra devolve um código de rejeição, e a ficha do código traz a mensagem que o autorizador exibe.
Se informada chave de acesso da NFAg faturada em conjunto (tag: gFatConjunto/chNFAgFat): - Validar chave de acesso da NFAg faturada em conjunto Retornar motivo da rejeição da Chave de Acesso: CNPJ zerado ou inválido, Ano < 2025 ou maior que atual, Mês inválido (0 ou > 12), Modelo diferente de 75, Número zerado, Tipo de emissão inválido, UF inválida ou DV inválido) [Motivo: XXXXXXXXXXXX]
Mensagem: Chave de Acesso da NFAg faturada em conjunto
Se informada chave de acesso de NFAg faturada em conjunto (tag: gFatConjunto/chNFAgFat): - A NFAg faturada em conjunto não pode existir com diferença na Chave de Acesso Retornar a chave de acesso já autorizada, o número do protocolo e data de autorização da NFAg [chNFAg: 99999999999999999999999999999999999999999999] [nProt:9999999999999999][dhAut: AAAA-MM-DDTHH:MM:SS TZD]
Mensagem: NFAg faturada em conjunto com diferença de Chave de Acesso
Se informada chave de acesso de NFAg faturada em conjunto (tag: gFatConjunto/chNFAgFat): - A NFAg faturada em conjunto deve existir Acesso BD NFAg (Chave: CNPJ Emit, Modelo, Série, Nro)
Mensagem: NFAg faturada em conjunto inexistente
Se informada chave de acesso de NFAg faturada em conjunto (tag: gFatConjunto/chNFAgFat): - A NFAg faturada em conjunto não pode estar cancelada
Mensagem: NFAg faturada em conjunto não pode estar cancelada
Se informada chave de acesso de NFAg faturada em conjunto (tag: gFatConjunto/chNFAgFat): - A NFAg faturada em conjunto não pode estar substituída
Mensagem: NFAg faturada em conjunto não pode ter sido substituída
Se informada chave de acesso de NFAg faturada em conjunto (tag: gFatConjunto/chNFAgFat): - A NFAg faturada em conjunto deve ser do tipo de faturamento Faturada por terceiro (tpFat=2)
Mensagem: NFAg faturada em conjunto deve ser de tipo de faturamento faturada por terceiro
Se informada chave de acesso de NFAg faturada em conjunto (tag: gFatConjunto/chNFAgFat): - CNPJ do emitente da NFAg faturada em conjunto deve ser DIFERENTE do emitente informado na NFAg faturada por terceiro.
Mensagem: O CNPJ da NFAg faturada por terceiro deve ser diferente da NFAg faturada em conjunto
Perguntas frequentes
O que é o campo chNFAgFat da NFAg?
Chave de acesso da NFAg faturada em conjunto Obrigatorio para tpFat 3 Vedado para tpFat 1 e 2 No XML ele fica em NFAg/infNFAg/gFatConjunto/chNFAgFat. Obrigatório, uma vez, com tamanho até 44.
chNFAgFat aparece em quantos lugares da NFAg?
Em 2 posições do esquema oficial: NFAg/infNFAg/gFatConjunto/chNFAgFat, nfagProc/NFAg/infNFAg/gFatConjunto/chNFAgFat. 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.
Que rejeição chNFAgFat pode causar na NFAg?
7 regras do manual citam este campo, disparando os códigos 517, 518, 519, 520, 521, 533, 267. ⚠ O número da rejeição não é único entre documentos fiscais: o mesmo código costuma existir na NF-e querendo dizer outra coisa.
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.