chNF3eAnt
Chave de Acesso da NF3e anterior
Onde fica no arquivo
No documento
-
NF3e/infNF3e/NFdet/@chNF3eAnt
Opcional, no máximo uma vez
-
nf3eProc/NF3e/infNF3e/NFdet/@chNF3eAnt
Opcional, no máximo uma vez
O caminho até aqui, nível a nível
Dentro do grupo NFdet , 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 NF3e anterior (tag: chNF3eAnt) ou o HashCode do Modelo 6 (mod6HashAnt no detalhamento dos Produtos e Serviços (NFdet): - Verificar se o tipo da NF3e é igual a 3 (Normal com Ajustes)
Mensagem: Não é permitido informar NF3e anterior para NF3e diferente de normal com ajustes
Se Tipo da NF3e = 3 (Normal com Ajustes) (tag: finNF3e) e informada chave de acesso de NF3e anterior (tag: chNF3eAnt) no detalhamento dos Produtos e Serviços (grupo: NFdet): - Validar chave de acesso da NF3e anterior. Retornar motivo da rejeição da Chave de Acesso: CNPJ zerado ou inválido, Ano < 2019 ou maior que atual, Mês inválido (0 ou > 12), Modelo diferente de 66, 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 Tipo da NF3e = 3 (Normal com Ajustes) (tag: finNF3e) e informada chave de acesso da NF3e anterior (tag: chNF3eAnt): - NF3e 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 NF3e [chNF3e: 99999999999999999999999999999999999999999999] [nProt:999999999999999][dhAut: AAAA-MM-DDTHH:MM:SS TZD]
Mensagem: NF3e anterior com diferença de Chave de Acesso [chNF3e: 99999999999999999999999999999999999999999999]
Se Tipo da NF3e = 3 (Normal com Ajustes) (tag: finNF3e) e informada chave de acesso da NF3e anterior (tag: chNF3eAnt): - A NF3e anterior deve existir Acesso BD NF3e (Chave: CNPJ Emit, Modelo, Série, Nro)
Mensagem: NF3e anterior inexistente
Se Tipo da NF3e = 3 (Normal com Ajustes) (tag: finNF3e) e informada chave de acesso da NF3e anterior (tag: chNF3eAnt): - A NF3e anterior não pode estar cancelada
Mensagem: NF3e a anterior não pode estar cancelada
Se Tipo da NF3e = 3 (Normal com Ajustes) (tag: finNF3e) e informada chave de acesso da NF3e anterior (tag: chNF3eAnt): - A NF3e anterior não pode estar substituída
Mensagem: NF3e a anterior não pode ter sido substituída
Se Tipo da NF3e = 3 (Normal com Ajustes) (tag: finNF3e) e informada chave de acesso da NF3e anterior (tag: chNF3eAnt): - A NF3e anterior não pode ter sido ajustada
Mensagem: NF3e anterior não pode ter sido ajustada anteriormente
Se Tipo da NF3e = 3 (Normal com Ajustes) (tag: finNF3e) e informada chave de acesso da NF3e anterior (tag: chNF3eAnt): - CNPJ do emitente da NF3e anterior deve ser igual ao informado na NF3e de ajuste Exceção: os casos de alteração do CNPJ da Distribuidora por motivo de aquisição, fusão, incorporação deve ser tratados no ambiente de autorização da NF3e
Mensagem: CNPJ do emitente da NF3e anterior deve ser igual ao informado na NF3e de ajuste
Campos do mesmo grupo — 2
São os campos que ficam ao lado deste no arquivo, dentro de NF3e/infNF3e/NFdet. Quem
preenche um costuma precisar dos outros na mesma passada.
Perguntas frequentes
O que é o campo chNF3eAnt da NF3e?
Chave de Acesso da NF3e anterior No XML ele fica em NF3e/infNF3e/NFdet/@chNF3eAnt. É um atributo da tag, não um elemento. Opcional, no máximo uma vez, com tamanho até 44.
chNF3eAnt aparece em quantos lugares da NF3e?
Em 2 posições do esquema oficial: NF3e/infNF3e/NFdet/@chNF3eAnt, nf3eProc/NF3e/infNF3e/NFdet/@chNF3eAnt. 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 chNF3eAnt pode causar na NF3e?
8 regras do manual citam este campo, disparando os códigos 241, 242, 245, 246, 250, 251, 254, 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 NF3e?
Do esquema XML oficial (PL_NF3E_1.00a_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.