Pular para o conteúdo
Fiscal ProBiblioteca
NF-e e NFC-e · Totais

vNFTot na NF-e: soma de vItem e versões da composição

<vNFTot>total › vNFTot

Revisão editorial em 14 de out. de 2026. As versões e condições das regras estão indicadas ao longo do artigo.

total/vNFTot é o valor total da NF-e/NFC-e no contexto do leiaute com IBS, CBS e Imposto Seletivo. A regra W60-10 documenta sua conferência pela soma dos totais de item det/vItem. O campo não é sinônimo de ICMSTot/vNF nem uma ordem para somar todos os tributos novamente.

Nesta página:

Onde fica vNFTot e qual tipo usar

XPath completo: /nfeProc/NFe/infNFe/total/vNFTot. Se o arquivo contém apenas a raiz NFe, retire /nfeProc do início. Em consultas XPath, associe um prefixo, por exemplo n, ao namespace http://www.portalfiscal.inf.br/nfe e use esse prefixo em cada elemento. Buscar apenas pelo nome da última tag pode misturar item e total ou grupos tributários diferentes.

No PL 010f v1.04, a tag é opcional, de zero a uma ocorrência, tipo TDec_1302, diretamente em total, depois de IBSCBSTot quando este existir. Não fica dentro de IBSCBSTot ou ICMSTot. O tipo aceita zero, diferentemente de TDec_1302Opc de alguns outros totais. O pacote e a declaração efetivamente usados pelo emissor precisam ser identificados antes de interpretar uma ficha de versão anterior. Fonte: Schemas XML NF-e/NFC-e PL 010f.

W60 é campo; W60-05 e W60-10 são validações

Identificação O que documenta Condição / estado na NT 1.52
W60 Campo vNFTot no leiaute Ocorrência estrutural 0–1.
W60-05 / 1004 Falta de vNFTot Quando IBSCBSTot foi informado; observação de implementação futura.
W60-10 / 1094 Total difere da soma dos itens Quando vNFTot foi informado; observação de implementação futura.

As regras são descritas para 55/65. A coluna obrigatória não remove a observação de implementação futura. Também não é correto afirmar que vNFTot só se relaciona a IS: W60-05 cita expressamente o grupo IBSCBSTot. A existência da tag no schema não prova que sua exigência de presença esteja ativa em determinada emissão. Fonte: NT 2025.002 RTC, pp.30 e 71.

Como a soma dos totais de item deve ser conferida

W60-10 compara vNFTot com a soma de det/vItem, identificado como VB01. Primeiro confira o valor de cada item; depois consolide esses valores, sem recalcular todas as bases e alíquotas diretamente no total.

Não some prod/vProd no lugar de vItem: vProd é o valor do produto/serviço, enquanto vItem tem composição própria. W07-10 contém filtro expresso indTot=1 para vProd total; W60-10 descreve a soma de vItem. Não transfira automaticamente um filtro de uma validação para a outra. Identifique os itens e valores que a regra efetivamente compara. Fonte: NT 2025.002 RTC, pp.68–71.

Composição histórica: o ramo geral da NT 2025.002

VB01-10 descreve o ramo em que não há faturamento direto de veículos novos, isto é, tpOp ausente ou diferente de 2. A composição documentada tem:

Operação Parcelas do item
Somar vProd, vICMSST, vICMSMonoReten, vFCPST, vFrete, vSeg, vOutro, vII, vIPI, vIPIDevol e vServ.
Subtrair vDesc; vICMSDeson somente se indDeduzDeson=1.
Somar sob indicador PIS-ST, PISST/vPIS, somente se indSomaPISST=1; COFINS-ST, COFINSST/vCOFINS, somente se indSomaCOFINSST=1.
Novos tributos previstos vIBS, vCBS, vIS, vTotIBSMonoItem e vTotCBSMonoItem, observada a exceção de ano abaixo.

Não abrevie PIS-ST e COFINS-ST como uma única parcela de ST, nem confunda com PIS/COFINS próprios. A regra de item possui observação de implementação futura. Fonte: NT 2025.002 RTC, p.68 VB01-10.

Composição histórica: 2025/2026 e faturamento direto

Na redação da NT 2025.002 v1.52, VB01-10 trazia a condição: em 2025 e 2026 não somar vIBS, vCBS, vIS, vTotIBSMonoItem e vTotCBSMonoItem. A descrição de impostos por fora não elimina essa exceção.

Para faturamento direto de veículos novos, tpOp=2, VB01-20 possui outra composição: vProd menos vDesc e menos vICMSDeson se indDeduzDeson=1, mais vFrete, vSeg, vOutro, vII, vIPI, vServ, PIS-ST se indSomaPISST=1 e COFINS-ST se indSomaCOFINSST=1, além dos novos valores vIBS, vCBS e vIS sob a exceção própria. Em 2025 e 2026, esse ramo também manda não somar vIBS, vCBS e vIS. Não transplante vICMSST, vFCPST, vICMSMonoReten, vIPIDevol ou parcelas monofásicas do ramo geral para a fórmula especial, pois elas não estão na lista de VB01-20.

VB01-20 também está marcada como implementação futura. Essa exceção e os acréscimos separados de novos tributos foram posteriormente rasurados na revisão VB01 da NT 2026.008, conforme a seção seguinte. Não os aplique como fórmula universal vigente. Fonte: NT 2025.002 RTC, pp.68–69.

A revisão posterior da NT 2026.008

A NT 2026.008 v1.00, posterior na sequência documental, altera VB01-10 e VB01-20. Sua p.9 informa vProd contendo vIBS, vCBS e vIS e risca os acréscimos separados desses tributos; também risca os totais monofásicos adicionais do ramo geral e a exceção de 2025/2026. A p.6 delimita que, a partir de 2027, IBS, CBS e IS compõem o valor bruto de vProd, exceto nas notas de importação. A p.4 explica que IBS/CBS já compreendidos em vProd não são novamente adicionados a vNFTot e que sua inclusão no preço não define a base desses tributos. Essa mudança de composição não autoriza duplicar impostos nem aplicar a observação de 2027 a toda emissão de 2026. Fonte: NT 2026.008 — Valor Líquido do Produto, pp.4,6,9–10.

No ramo geral revisto de VB01-10, conservam-se vProd, desconto, desoneração sob indicador, ICMS-ST, ICMS monofásico sujeito à retenção, FCP-ST, frete, seguro, outras despesas, II, IPI, IPI devolvido, serviços e PIS-ST/COFINS-ST sob seus indicadores. Retiram-se os acréscimos separados de vIBS/vCBS/vIS e dos totais monofásicos de IBS/CBS. No ramo de veículos VB01-20, conservam-se suas parcelas próprias, sem os acréscimos separados de vIBS/vCBS/vIS. O valor do produto já representa a composição pertinente à observação de ano e à operação.

Exemplo sob a redação histórica, sem antecipar a revisão

Hipótese exclusivamente sintética: nota de 2026, sem faturamento direto de veículos. Item 1: vProd R$ 100,00, desconto R$ 5,00, frete R$ 10,00 e seguro R$ 2,00. Todas as demais parcelas da fórmula geral são conhecidas como zero ou não participam pelos indicadores já definidos. O cálculo é 100 - 5 + 10 + 2 = 107.

Suponha ainda que seus novos tributos já estejam definidos em R$ 1,00 de IBS, R$ 2,00 de CBS e R$ 3,00 de IS. Sob a redação histórica de VB01-10 da NT 2025.002 v1.52, a exceção de 2026 explicava não acrescentar esses R$ 6,00 ao vItem desse exemplo. A demonstração não anuncia a vigência universal dessa redação após a NT 2026.008. Não se está escolhendo incidência ou alíquota; são entradas hipotéticas para explicar a exclusão temporal.

Item 2: vItem já conferido de R$ 50,00. Logo a soma dos itens é 107 + 50 = 157. Fragmento parcial do campo vNFTot em total:

<vNFTot xmlns="http://www.portalfiscal.inf.br/nfe">157.00</vNFTot>

O trecho não contém os itens, totais irmãos, identificação, assinatura ou protocolo. Não é documento pronto para transmissão nem comprova autorização. Fonte: NT 2025.002 RTC, VB01-10 e W60-10.

Exemplo da composição prevista a partir de 2027

Hipótese sintética de leitura da NT 2026.008, em cenário de 2027 fora de importação, com os parâmetros já confirmados: a composição de vProd resulta em R$ 106,00, incluindo R$ 1,00 de IBS, R$ 2,00 de CBS e R$ 3,00 de IS. Frete R$ 10,00, seguro R$ 2,00, desconto R$ 5,00 e demais parcelas participantes conhecidas como zero produzem 106 - 5 + 10 + 2 = 113.

Os R$ 6,00 já compreendidos em vProd não são somados de novo a vItem. Com um segundo item cujo vItem conferido seja R$ 50,00, a soma para vNFTot é R$ 163,00. Este cenário demonstra ausência de duplicação sob as premissas e a redação indicadas; não define a base de IBS/CBS, alíquotas ou a entrada em vigor da validação futura. Fonte: NT 2026.008 — Valor Líquido do Produto, pp.4,6,9–10.

Por que vNF não deve ser copiado automaticamente

ICMSTot/vNF é W16, conferido pela composição própria de W16-10, com parcelas e exceções como importação, faturamento direto e desoneração. vNFTot é W60, ligado a vItem na RTC. Em um cenário particular eles podem coincidir, mas igualdade numérica não torna os contratos equivalentes.

Também não subtraia indiscriminadamente retTrib para obter vNFTot: bases de IRRF/Previdência e valores retidos têm funções próprias. Confira nota fiscal, memória de cálculo e valor financeiro em seus contextos. A NT 2023.004 v1.20 atualiza W16-10; ela não substitui a regra W60-10 por uma cópia de vNF. Fontes: MOC 7 Anexo I — leiaute e regras de validação, p.122; NT 2023.004 — Informações de Pagamentos e Outros, pp.15–16; NT 2025.002 RTC, p.71.

Vigência: o que está publicado e o que está futuro

A NT 2025.002 v1.52 é de setembro/2026. Na data de corte de 14/10/2026, sua publicação não comprova implantação de todas as alterações em produção. O aviso ENCAT de 05/10/2026 adiou as mudanças com implantação então prevista para 05/10: homologação em 26/10 e produção em 16/11. O aviso não fornece uma data de ativação para regras que a NT identifica separadamente como implementação futura, nem desfaz cronogramas de campos já existentes. Fontes: NT 2025.002 RTC; ENCAT — alteração de datas.

Em particular, W60-05/W60-10 da NT 2025.002 e VB01-10/VB01-20 na revisão da NT 2026.008 possuem observação própria de implementação futura. Não atribua a elas automaticamente a data geral de um pacote ou a nova data do aviso. Use a versão documental, o ambiente e o retorno real para qualificar o diagnóstico.

O PDF da NT 2026.008 traz 05/10/2026 em homologação e 03/11/2026 em produção para o conjunto inicial. O aviso ENCAT de 05/10/2026 inclui expressamente NT 2026.008 v1.00, além de NT 2025.002 v1.52, no adiamento para 26/10/2026 em homologação e 16/11/2026 em produção. Em 14/10/2026 esses marcos eram futuros. As linhas VB01-10 e VB01-20 continuam com observação de implementação futura na NT 2026.008; não lhes atribua ativação automática em 16/11. Distingua publicação, implantação técnica do conjunto, regra específica e ano de composição do valor. Fontes: NT 2026.008 — Valor Líquido do Produto, p.3 e pp.9–10; ENCAT — alteração de datas.

Como investigar 1004, 1094 ou falha de schema

Para 1004, verifique se o retorno real identifica a regra e se IBSCBSTot está presente; então examine a geração de vNFTot, sem confundir a condição documentada com comprovação de ativação. Para 1094, registre cada nItem/vItem e some os totais finais, investigando omissões, duplicações ou cálculo anterior à última edição de item. Se o erro for schema, confira tipo, posição e formato: ponto, sem moeda, até 13 dígitos inteiros e duas casas quando houver decimais; TDec_1302 aceita zero.

Se a divergência nasceu no item, confira ano, ramo de faturamento, desoneração e indicadores de PIS-ST/COFINS-ST antes de mexer no total. Corrija a origem comprovada, gere nova prévia e valide o XML aplicável. Não edite XML assinado nem altere parâmetros fiscais verdadeiros para obter aceitação. Quando faltar uma definição fiscal, reúna documentação da operação, produto/serviço, data, regime, partes e memória de cálculo para confirmação específica.

O grupo total do Imposto Seletivo ISTot detalha a presença e a soma de IS, separadas da composição do total geral.

Referência técnica para integração

XPath completo
/nfeProc/NFe/infNFe/total/vNFTot
Namespace
http://www.portalfiscal.inf.br/nfe
Leiaute
4.00 · PL_010e_v1.02
Ocorrências no XSD
0–1 no contexto do elemento pai
Tipo
TDec_1302Opc · string
Preenchimento no catálogo
Condicional

A ocorrência vale dentro da estrutura XML: um campo obrigatório em um grupo opcional não torna esse grupo obrigatório. A aplicação fiscal depende da operação e da versão da regra.

pattern
0\.[0-9]{1}[1-9]{1}|0\.[1-9]{1}[0-9]{1}|[1-9]{1}[0-9]{0,12}(\.[0-9]{2})?
whiteSpace
preserve