chNFGasAnt
Chave de Acesso da NFGas anterior Usar para NFGas quando indicar um item de devolução de nota anterior DEVE SER USADA NA NOTA AGREGADORA PARA INDICAR AS NOTAS QUE FORAM AGREGADAS
Onde fica no arquivo
No documento
-
NFGas/infNFGas/det/@chNFGasAnt
Opcional, no máximo uma vez
-
nfgasProc/NFGas/infNFGas/det/@chNFGasAnt
Opcional, no máximo uma vez
O caminho até aqui, nível a nível
Dentro do grupo det , detalhamento de Produtos e Serviços
O que o arquivo aceita neste campo
- Ocorrência
- 0-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 de NFGas anterior (tag: chNFGasAnt) no detalhamento dos Produtos e Serviços (grupo: det): - Validar chave de acesso da NFGas anterior. Retornar motivo da rejeição da Chave de Acesso: CNPJ zerado ou inválido, Ano < 2026 ou maior que atual, Mês inválido (0 ou > 12), Modelo diferente de 76, Número zerado, Tipo de emissão inválido, UF inválida ou DV inválido) [Motivo: XXXXXXXXXXXX]
Mensagem: Chave de Acesso anterior inválida
Se informada chave de acesso de NFGas anterior (tag: chNFGasAnt) no detalhamento dos Produtos e Serviços (grupo: det): - NFGas anterior 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 NFGas [chNFGas: 99999999999999999999999999999999999999999999] [nProt:9999999999999999][dhAut: AAAA-MM-DDTHH:MM:SS TZD]
Mensagem: NFGas anterior com diferença de Chave de Acesso
Se informada chave de acesso de NFGas anterior (tag: chNFGasAnt) no detalhamento dos Produtos e Serviços (grupo: det): - A NFGas anterior deve existir Acesso BD NFGas (Chave: CNPJ Emit, Modelo, Série, Nro)
Mensagem: NFGas anterior inexistente
Se informada chave de acesso de NFGas anterior (tag: chNFGasAnt) no detalhamento dos Produtos e Serviços (grupo: det): - A NFGas anterior não pode estar cancelada
Mensagem: NFGas a anterior não pode estar cancelada
Se informada chave de acesso de NFGas anterior (tag: chNFGasAnt) no detalhamento dos Produtos e Serviços (grupo: det): - A NFGas anterior não pode estar substituída
Mensagem: NFGas a anterior não pode ter sido substituída
Se tipo de faturamento da NFGas for agregador (tpFat=3) e informada chave de acesso de NFGas anterior (tag: chNFGasAnt) no detalhamento dos Produtos e Serviços (grupo: det): - A NFGas anterior deve ser do tipo de faturamento Agregada (tpFat=2)
Mensagem: NFGas a anterior deve ser do tipo de faturamento Agregado
Se informada chave de acesso da NFGas anterior (tag: chNFGasAnt): - CNPJ do emitente da NFGas anterior deve ser igual ao informado na NFGas de ajuste Exceção: os casos de alteração do CNPJ da empresa por motivo de aquisição, fusão, incorporação deve ser tratados no ambiente de autorização da NFGas
Mensagem: CNPJ do emitente da NFGas anterior deve ser igual ao informado na NFGas
Campos do mesmo grupo — 4
São os campos que ficam ao lado deste no arquivo, dentro de NFGas/infNFGas/det. Quem
preenche um costuma precisar dos outros na mesma passada.
Perguntas frequentes
O que é o campo chNFGasAnt da NFGas?
Chave de Acesso da NFGas anterior Usar para NFGas quando indicar um item de devolução de nota anterior DEVE SER USADA NA NOTA AGREGADORA PARA INDICAR AS NOTAS QUE FORAM AGREGADAS No XML ele fica em NFGas/infNFGas/det/@chNFGasAnt. É um atributo da tag, não um elemento. Opcional, no máximo uma vez, com tamanho até 44.
chNFGasAnt aparece em quantos lugares da NFGas?
Em 2 posições do esquema oficial: NFGas/infNFGas/det/@chNFGasAnt, nfgasProc/NFGas/infNFGas/det/@chNFGasAnt. 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 chNFGasAnt pode causar na NFGas?
7 regras do manual citam este campo, disparando os códigos 242, 245, 246, 250, 251, 532, 255. ⚠ 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 NFGas?
Do esquema XML oficial (PL_NFGas_NT2026.004_RTC_1.00). 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.