total na NF-e: grupos de consolidação e diferenças entre vNF e vNFTot

total, em /nfeProc/NFe/infNFe/total, reúne as consolidações da nota. É um grupo obrigatório, não um campo monetário único. O valor devido, os impostos, as bases e as retenções têm campos separados e não podem ser somados indiscriminadamente.

Identidade técnica: tag; XPath /nfeProc/NFe/infNFe/total.

Para consultas XPath com prefixos, associe n a http://www.portalfiscal.inf.br/nfe em cada elemento. Em XML cuja raiz é NFe, retire o ancestral nfeProc da consulta; não remova namespaces do documento original.

Nesta página:

• Quais grupos podem aparecer
• Por que vNF e vNFTot não são sinônimos
• Como conciliar a nota por grandeza
• Exemplo XML e hipóteses do fragmento
• vItem e vProd: duas notas técnicas com escopos temporais diferentes
• Versão e cronograma: o que conferir no ambiente
• Leituras relacionadas

Quais grupos podem aparecer

No XSD PL 010f v1.04, a sequência começa por ICMSTot, obrigatório, e admite depois ISSQNtot, retTrib, ISTot, IBSCBSTot e vNFTot, cada qual conforme sua estrutura e condição. A ordem é relevante. ICMSTot reúne campos tradicionais, inclusive vNF; ISSQNtot corresponde a serviços sujeitos a ISSQN na nota; retTrib registra retenções; ISTot consolida IS; IBSCBSTot consolida IBS/CBS e componentes próprios.

Esses grupos não são intercambiáveis. ISSQNtot da NF-e não é uma NFS-e nacional. vTotTrib informa carga tributária estimada no contexto próprio; não é um substituto do imposto efetivo ou um valor a acrescentar novamente.

Por que vNF e vNFTot não são sinônimos

vNF fica em total/ICMSTot. vNFTot fica diretamente em total e representa o total com IBS/CBS/IS no leiaute RTC. A NT 2025.002 v1.52, p.29–30, identifica esses novos tributos como por fora. Isso não autoriza uma integração a usar uma fórmula universal vNF mais qualquer tag de imposto: parcelas e transição precisam seguir as regras correspondentes.

W60-05 trata ausência de vNFTot quando IBSCBSTot existe; W60-10 trata a comparação de vNFTot com o somatório de vItem. Ambas, p.71, estão expressamente como implementação futura. Um campo existe no schema antes de toda validação se tornar ativa. Não confunda W60, que é o identificador do campo, com W60-05 ou W60-10.

Como conciliar a nota por grandeza

Monte uma tabela por det/@nItem com os campos que alimentam cada total. Separe produto, frete, desconto, base de cada tributo, imposto, diferimento, devolução e crédito. Depois some apenas os campos correspondentes e compare com o XML bruto, não só com o DANFE ou um relatório que arredonda na exibição.

Exemplo didático: dois itens com CBS já calculada de R$ 9,00 e R$ 4,50 produzem total gCBS/vCBS de R$ 13,50. Isso não significa acrescentar 13,50 novamente a um total que já incorporou a parcela no cálculo adotado. Para diferença, investigue duplicação de itens, composição e escala antes de ajustar o total. Não aplique a regra indTot de vProd automaticamente aos demais tributos: cada somatório tem seu próprio critério.

Exemplo XML e hipóteses do fragmento

Considere exclusivamente um cenário sintético sem campos RTC nos itens, produto total R$100,00 e demais parcelas fiscais/financeiras efetivamente apuradas como zero. vNF=R$100,00 nessa hipótese. Os grupos opcionais não aplicáveis foram omitidos; ICMSTot contém todos os filhos estruturalmente obrigatórios. Isso não define enquadramento nem incidência real. O grupo total está completo em si e é parcial em relação à nota.

<total xmlns="http://www.portalfiscal.inf.br/nfe">
  <ICMSTot>
    <vBC>0.00</vBC>
    <vICMS>0.00</vICMS>
    <vICMSDeson>0.00</vICMSDeson>
    <vFCP>0.00</vFCP>
    <vBCST>0.00</vBCST>
    <vST>0.00</vST>
    <vFCPST>0.00</vFCPST>
    <vFCPSTRet>0.00</vFCPSTRet>
    <vProd>100.00</vProd>
    <vFrete>0.00</vFrete>
    <vSeg>0.00</vSeg>
    <vDesc>0.00</vDesc>
    <vII>0.00</vII>
    <vIPI>0.00</vIPI>
    <vIPIDevol>0.00</vIPIDevol>
    <vPIS>0.00</vPIS>
    <vCOFINS>0.00</vCOFINS>
    <vOutro>0.00</vOutro>
    <vNF>100.00</vNF>
  </ICMSTot>
</total>

A validação desse fragmento é estrutural e limitada à declaração do seu caminho. Não equivale à validação da nota completa, à assinatura ou à autorização.

vItem e vProd: duas notas técnicas com escopos temporais diferentes

A NT 2025.002 v1.52, p.68–69, apresenta as composições futuras VB01-10/20 com parcelas de novos tributos separadas. Naquele texto, a exceção dos anos 2025 e 2026 exclui a soma de vIBS, vCBS e vIS; no ramo geral VB01-10 também exclui vTotIBSMonoItem e vTotCBSMonoItem. As duas regras permanecem marcadas como implementação futura.

A NT 2026.008 v1.00, pp. 4, 6 e 9–10, altera essas composições. A observação de I11 na p.6 estabelece que, a partir de 2027, IBS/CBS/IS compõem o valor bruto vProd, exceto nas notas de importação; não descreve uma inclusão automática em 2026. Nas composições VB01, descreve vProd como contendo esses tributos e risca os acréscimos separados e a antiga exceção temporal. A observação de implementação futura continua. Não apresente a fórmula e a exceção da NT anterior como regra universal para qualquer emissão em 2026, nem some novamente tributos que a composição aplicável já contém no valor do produto.

O aviso ENCAT de 5/10/2026 inclui expressamente a NT 2026.008 no adiamento para 26/10 em homologação e 16/11 em produção. Esse cronograma da rodada não ativa por si as regras que continuam futuras. Em 14/10/2026, a documentação publicada e o pacote XSD PL 010f usado nos exemplos são objetos diferentes: o pacote conferido não contém os novos campos vProdLiq/vProdLiqTot daquela NT. Para uma nota concreta, confirme pacote, data, regras implementadas e memória de cálculo; preserve a versão histórica de sua conferência.

Versão e cronograma: o que conferir no ambiente

A estrutura descrita foi conferida no PL 010f v1.04. O snapshot da ficha pode oferecer PL 010e v1.02; uma afirmação sobre o pacote mais novo não deve ser atribuída automaticamente a todo arquivo histórico.

A NT 2025.002 v1.52 é a edição de setembro de 2026, publicada no catálogo em 1º/10/2026. O aviso ENCAT de 5/10/2026 adiou as alterações dessa rodada para 26/10/2026 em homologação e 16/11/2026 em produção. Essas datas não suspendem todas as regras anteriores nem tornam ativas as regras que continuam marcadas como implementação futura. Em 14/10/2026, os dois novos marcos ainda eram futuros.

Separe a existência de uma tag no schema, a condição fiscal da operação e a ativação da regra de negócio. A condição legal não se deduz da ausência de rejeição, e o cronograma não comprova implantação em cada autorizadora. Registre data, modelo, ambiente, pacote usado e retorno para interpretar uma divergência concreta.

Leituras relacionadas

IBSCBSTot separa os componentes RTC dos demais totais. IBSCBSTot — /nfeProc/NFe/infNFe/total/IBSCBSTot.