finNFAg
Finalidade de emissão da NFAg
Onde fica no arquivo
No documento
-
NFAg/infNFAg/ide/finNFAg
Obrigatório, uma vez
-
nfagProc/NFAg/infNFAg/ide/finNFAg
Obrigatório, uma vez
O caminho até aqui, nível a nível
Dentro do grupo ide , identificação da NFAg
O que o arquivo aceita neste campo
- Ocorrência
- 1-1
- Tamanho
- 1
- Tipo no esquema
- TFinNFAg
- Formato base
- string
Valores aceitos — 2
- 0
- 3
Lista fechada do esquema oficial: qualquer outro valor é recusado na validação do arquivo.
As regras que verificam este campo — 10
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 o Tipo da NFAg = 3 (Substituição) (tag: finNFAg): - O grupo de informações da substituição (grupo: gSub) deve ser informado
Mensagem: Grupo NFAg de Substituição deve ser informado para a NFAg de Substituição
Se o Tipo da NFAg =1 (Normal) (tag: finNFAg): - O grupo de informações da substituição (grupo: gSub) NÃO deve ser informado
Mensagem: Grupo NFAg de Substituição não deve ser informado para NFAg Normal
Se Tipo da NFAg = 3 (Substituição) (tag: finNFAg) e informada chave de acesso da NFAg substituída: - Validar chave de acesso da NFAg substituída. 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 substituída inválida
Se Tipo da NFAg = 3 (Substituição) (tag: finNFAg) e informada chave de acesso da NFAg substituída: - NFAg substituída 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 substituída com diferença de Chave de Acesso
Se Tipo da NFAg = 3 (Substituição) (tag: finNFAg) e informada chave de acesso da NFAg substituída: - A NFAg substituída deve existir Acesso BD NFAg (Chave: CNPJ Emit, Modelo, Série, Nro)
Mensagem: NFAg a ser substituída inexistente
Se Tipo da NFAg = 3 (Substituição) (tag: finNFAg) e informada chave de acesso da NFAg substituída: - A NFAg substituída não pode estar cancelada
Mensagem: NFAg a ser substituída não pode estar cancelada
Se Tipo da NFAg = 3 (Substituição) (tag: finNFAg) e informada chave de acesso da NFAg substituída: - A NFAg substituída não pode estar substituída
Mensagem: NFAg a ser substituída não pode ter sido substituída anteriormente
Se Tipo da NFAg = 3 (Substituição) (tag: finNFAg): - CNPJ do emitente da NFAg substituta deve ser igual ao informado na NFAg substituída 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 substituta deve ser igual ao informado na NFAg substituída
Se Tipo da NFAg = 3 (Substituição) (tag: finNFAg): - Identificação do destinatário da NFAg substituta deve ser igual ao informado na NFAg substituída (tags: CNPJ/CPF/idOutros)
Mensagem: Destinatário da NFAG substituição deve ser igual a NFAG original
Se o Tipo da NFAg = 3 (Substituição) (tag: finNFAg): - A NFAg Substituída deve ser do mesmo tipo de faturamento (tag: tpFat) da NFAg de Substituição
Mensagem: NFAg substituída com tipo de faturamento diferente da NFAg de Substituição
Campos do mesmo grupo — 17
São os campos que ficam ao lado deste no arquivo, dentro de NFAg/infNFAg/ide. Quem
preenche um costuma precisar dos outros na mesma passada.
Perguntas frequentes
O que é o campo finNFAg da NFAg?
Finalidade de emissão da NFAg No XML ele fica em NFAg/infNFAg/ide/finNFAg. Obrigatório, uma vez, com tamanho 1.
finNFAg aparece em quantos lugares da NFAg?
Em 2 posições do esquema oficial: NFAg/infNFAg/ide/finNFAg, nfagProc/NFAg/infNFAg/ide/finNFAg. 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.
Quais valores finNFAg aceita na NFAg?
O esquema oficial restringe a 2 valores: 0, 3. Qualquer outro valor é recusado já na validação do arquivo, antes de qualquer regra de negócio.
Que rejeição finNFAg pode causar na NFAg?
10 regras do manual citam este campo, disparando os códigos 411, 412, 414, 206, 208, 210, 211, 221, 484, 527. ⚠ 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.