finNF3e
Finalidade de emissão da NF3e
Onde fica no arquivo
No documento
-
NF3e/infNF3e/ide/finNF3e
Obrigatório, uma vez
-
nf3eProc/NF3e/infNF3e/ide/finNF3e
Obrigatório, uma vez
O caminho até aqui, nível a nível
Dentro do grupo ide , identificação da NF3e
O que o arquivo aceita neste campo
- Ocorrência
- 1-1
- Tamanho
- 1
- Tipo no esquema
- TFinNF3e
- Formato base
- string
Valores aceitos — 3
- 1
- 2
- 3
Lista fechada do esquema oficial: qualquer outro valor é recusado na validação do arquivo.
As regras que verificam este campo — 32
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 NF3e = 2 (Substituição) (tag: finNF3e): - O grupo de informações da substituição (grupo: gSub) deve ser informado
Mensagem: Grupo NF3e de Substituição deve ser informado para a NF3e de Substituição
Se o Tipo da NF3e = 2 (Substituição) (tag: finNF3e): - Verificar se tipo de NF3e é permitida na UF do emitente
Mensagem: UF não permite NF3e de Substituição
Se o Tipo da NF3e = 1 (Normal) ou 3 (Normal com Ajustes) (tag: finNF3e): - O grupo de informações da substituição (grupo: gSub) NÃO deve ser informado
Mensagem: Grupo NF3e de Substituição não deve ser informado para NF3e Normal ou de Ajuste
Se Tipo da NF3e = 2 (Substituição) (tag: finNF3e) e o motivo da substituição (tag: motSub) for diferente de 03 (Decisão Judicial): - Rejeitar se a data da emissão da NF3e informada ou a competência da NF papel forem anteriores a 5 anos da data atual
Mensagem: NF3e ou NF substituída com data de emissão anterior a 5 anos da data atual
Se Tipo da NF3e = 2 (Substituição) (tag: finNF3e) e informada chave de acesso da NF3e substituída: - Validar chave de acesso da NF3e substituída. 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 da NF3e substituída inválida
Se Tipo da NF3e = 2 (Substituição) (tag: finNF3e) e informada chave de acesso da NF3e substituída: - NF3e 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 NF3e [chNF3e: 99999999999999999999999999999999999999999999] [nProt:999999999999999][dhAut: AAAA-MM-DDTHH:MM:SS TZD]
Mensagem: NF3e substituída com diferença de Chave de Acesso [chNF3e: 99999999999999999999999999999999999999999999]
Se Tipo da NF3e = 2 (Substituição) (tag: finNF3e) e informada chave de acesso da NF3e substituída: - A NF3e substituída deve existir Acesso BD NF3e (Chave: CNPJ Emit, Modelo, Série, Nro)
Mensagem: NF3e a ser substituída inexistente
Se Tipo da NF3e = 2 (Substituição) (tag: finNF3e) e informada chave de acesso da NF3e substituída: - A NF3e substituída não pode estar cancelada
Mensagem: NF3e a ser substituída não pode estar cancelada
Se Tipo da NF3e = 2 (Substituição) (tag: finNF3e) e informada chave de acesso da NF3e substituída: - A NF3e substituída não pode estar substituída
Mensagem: NF3e a ser substituída não pode ter sido substituída anteriormente
Se Tipo da NF3e = 2 (Substituição) (tag: finNF3e) e informada chave de acesso da NF3e substituída: - A NF3e substituída não pode ter sido ajustada
Mensagem: NF3e a ser substituída não pode ter sido ajustada anteriormente
Se Tipo da NF3e = 2 (Substituição) (tag: finNF3e): - CNPJ do emitente da NF3e substituta deve ser igual ao informado na NF3e substituída 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 substituta deve ser igual ao informado na NF3e substituída
Se Tipo da NF3e = 2 (Substituição) (tag: finNF3e) e informada NF substituída em papel (grupo: gNF): - Competência da emissão da NF substituída deve ser anterior a obrigatoriedade de emissão de NF3e na UF
Mensagem: Indicação de NF papel substituída é limitada ao prazo da Obrigatoriedade da NF3e
Se Tipo da NF3e = 2 (Substituição) (tag: finNF3e) e informada NF substituída em papel (grupo: gNF): - O Hash do convênio 115 (hash115) deverá ser preenchido.
Mensagem: O hash do convênio 115 deve ser informado para NF substituída
Se tipo da NF3e = 3 (Normal com Ajustes) (tag: finNF3e): - Verificar se tipo de NF3e é permitida na UF do emitente
Mensagem: UF não permite NF3e normal com ajustes
Se tipo da NF3e diferente de 3 (Normal com Ajustes) (tag: finNF3e): - Verificar foi informada mais de uma NF3e no detalhamento dos Produtos e Serviços (grupo: NFdet) ou se foi informado um item de NF3e Anterior (grupo:detItemAnt) ou se foi indicada uma chave de acesso de NF3e anterior (atributo: chNF3eAnt)
Mensagem: NF3e Normal e Substituição não permite informar NF3e anterior
Se tipo da NF3e = 3 (Normal com Ajustes) (tag: finNF3e): - Devem ser informados no mínimo duas ocorrências do grupo de detalhamento dos Produtos e Serviços (grupo: NFdet).
Mensagem: NF3e Normal com ajuste deve ter no mínimo duas NF3e informadas no detalhamento de produtos
Se tipo da NF3e = 3 (Normal com Ajustes) (tag: finNF3e): - Verificar se foi informada chave de acesso da NF3e (chNF3eAnt) ou o HashCode do Modelo 6 (mod6HashAnt) anterior no detalhamento dos Produtos e Serviços (grupo: NFdet)
Mensagem: Chave de acesso anterior deve ser informada para NF3e normal com ajustes
Se tipo da NF3e = 3 (Normal com Ajustes) (tag: finNF3e): - Verificar se foi informado somente a chave de acesso da NF3e anterior (chNF3eAnt) ou o HashCode da Modelo 6 Anterior (mod6HashAnt).
Mensagem: Só um dos campos pode ser informado: chave de acesso ou hashCode da nota anterior
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 o motivo do ajuste (tag: motAjuste) for diferente de 03 (Decisão Judicial): - Rejeitar se a data da emissão da NF3e anterior informada ou a competência da NF papel forem anteriores a 5 anos da data atual
Mensagem: NF3e ou NF anterior informada com data de emissão anterior a 5 anos da data atual
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
Se Tipo da NF3e = 3 (Normal com Ajustes) (tag: finNF3e) deve ser informado o grupo gAjusteNF3eAnt
Mensagem: Grupo de ajuste da NF3e anterior deve ser informado para NF-3 normal com ajuste
Se Tipo da NF3e diferente de 3 (Normal com Ajustes) (tag: finNF3e) não deve ser informado o grupo de identificação do ajuste do item de NF3e anterior (grupo: gAjusteNF3eAnt)
Mensagem: Grupo de ajuste da NF3e anterior não deve ser informado para NF3e normal e substituição
Se tipo da NF3e = 3 (Normal com Ajuste) (tag: finNF3e), total do ICMS difere do somatório dos valores dos itens menos o somatório dos valores de detItemAnt/vICMS.
Mensagem: Total do ICMS da NF3e de ajuste difere do somatório dos valores de ICMS dos itens, menos o somatório dos valores de ICMS dos itens de NF3e anteriores
Se tipo da NF3e = 3 (Normal com Ajuste) (tag: finNF3e): valor total da NF (vNF) difere do somatório de: (+) vProd (-) vRetPIS (-) vRetCofins (-) vRetCSLL (-) vIRRF (-) somatório dos detItemAnt/vProd
Mensagem: Total da NF3e de ajuste difere do somatório dos valores que compõe o valor total da NF3e ajuste
Se Tipo da NF3e = 2 (Substituição) (tag: finNF3e): - Identificação do destinatário da NF3e substituta deve ser igual ao informado na NF3e substituída (tags: CNPJ/CPF/idOutros)
Mensagem: Destinatário da NF3e substituição deve ser igual a NF3e original
Se o Tipo da NF3e = 1 (Normal) (tag: finNF3e): - O grupo de informações da substituição (grupo: gSub) NÃO deve ser informado
Mensagem: Grupo NF3e de Substituição não deve ser informado para NF3e Normal
Campos do mesmo grupo — 16
São os campos que ficam ao lado deste no arquivo, dentro de NF3e/infNF3e/ide. Quem
preenche um costuma precisar dos outros na mesma passada.
Perguntas frequentes
O que é o campo finNF3e da NF3e?
Finalidade de emissão da NF3e No XML ele fica em NF3e/infNF3e/ide/finNF3e. Obrigatório, uma vez, com tamanho 1.
finNF3e aparece em quantos lugares da NF3e?
Em 2 posições do esquema oficial: NF3e/infNF3e/ide/finNF3e, nf3eProc/NF3e/infNF3e/ide/finNF3e. 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 finNF3e aceita na NF3e?
O esquema oficial restringe a 3 valores: 1, 2, 3. Qualquer outro valor é recusado já na validação do arquivo, antes de qualquer regra de negócio.
Que rejeição finNF3e pode causar na NF3e?
32 regras do manual citam este campo, disparando os códigos 411, 477, 412, 413, 414, 206, 208, 210, 211, 219, 221, 234. ⚠ 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.