chNFAgAnt
Chave de Acesso da NFag anterior
Onde fica no arquivo
No documento
-
NFAg/infNFAg/det/@chNFAgAnt
Opcional, no máximo uma vez
-
nfagProc/NFAg/infNFAg/det/@chNFAgAnt
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 — 8
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 NFAg anterior (tag: chNFAgAnt) no detalhamento dos Produtos e Serviços (grupo: det): - Validar chave de acesso da NFAg anterior. 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 anterior inválida
Se informada chave de acesso de NFAg anterior (tag: chNFAgAnt) no detalhamento dos Produtos e Serviços (grupo: det): - NFAg 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 NFAg [chNFAg: 99999999999999999999999999999999999999999999] [nProt:9999999999999999][dhAut: AAAA-MM-DDTHH:MM:SS TZD]
Mensagem: NFAg anterior com diferença de Chave de Acesso
Se informada chave de acesso de NFAg anterior (tag: chNFAgAnt) no detalhamento dos Produtos e Serviços (grupo: det): - A NFAg anterior deve existir Acesso BD NFAg (Chave: CNPJ Emit, Modelo, Série, Nro)
Mensagem: NFAg anterior inexistente
Se informada chave de acesso de NFAg anterior (tag: chNFAgAnt) no detalhamento dos Produtos e Serviços (grupo: det): - A NFAg anterior não pode estar cancelada
Mensagem: NFAg a anterior não pode estar cancelada
Se informada chave de acesso de NFAg anterior (tag: chNFAgAnt) no detalhamento dos Produtos e Serviços (grupo: det): - A NFAg anterior não pode estar substituída
Mensagem: NFAg a anterior não pode ter sido substituída
Se informada chave de acesso da NFAg anterior (tag: chNFAgAnt): - CNPJ do emitente da NFAg anterior deve ser igual ao informado na NFAg 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 NFAg
Mensagem: CNPJ do emitente da NFAg anterior deve ser igual ao informado na NFAg
Se tipo de faturamento da NFAg for agregador (tpFat=5) e informada chave de acesso de NFAg anterior (tag: chNFAgAnt) no detalhamento dos Produtos e Serviços (grupo: det): - A NFAg anterior deve ser do tipo de faturamento Agregado (tpFat=4)
Mensagem: NFAg a anterior deve ser do tipo de faturamento Agregado
Se tipo de faturamento da NFAg for DIFERENTE de agregador (tpFat=5) e informada chave de acesso de NFAg anterior (tag: chNFAgAnt) no detalhamento dos Produtos e Serviços (grupo: det): - A NFAg anterior NÃO PODE SER do tipo de faturamento Agregado (tpFat=4)
Mensagem: NFAg anterior NÃO PODE ser do tipo de faturamento Agregado
Campos do mesmo grupo — 8
São os campos que ficam ao lado deste no arquivo, dentro de NFAg/infNFAg/det. Quem
preenche um costuma precisar dos outros na mesma passada.
Perguntas frequentes
O que é o campo chNFAgAnt da NFAg?
Chave de Acesso da NFag anterior No XML ele fica em NFAg/infNFAg/det/@chNFAgAnt. É um atributo da tag, não um elemento. Opcional, no máximo uma vez, com tamanho até 44.
chNFAgAnt aparece em quantos lugares da NFAg?
Em 2 posições do esquema oficial: NFAg/infNFAg/det/@chNFAgAnt, nfagProc/NFAg/infNFAg/det/@chNFAgAnt. 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 chNFAgAnt pode causar na NFAg?
8 regras do manual citam este campo, disparando os códigos 242, 245, 246, 250, 251, 255, 1063, 1064. ⚠ 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.