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

vTotTrib de ICMSTot: valor aproximado dos tributos e soma

<vTotTrib>total › ICMSTot › vTotTrib

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

ICMSTot/vTotTrib informa o valor aproximado total de tributos federais, estaduais e municipais. É uma informação estimativa, distinta de uma soma dos impostos destacados na nota e de um valor automaticamente acrescentado à cobrança.

Nesta página:

De onde vem o valor aproximado total

XPath completo: /nfeProc/NFe/infNFe/total/ICMSTot/vTotTrib. 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.

A comparação W16a-10 utiliza os valores M02, det/imposto/vTotTrib, dos itens. Não use uma busca global por vTotTrib, pois ela incluiria o próprio total na soma. Também não substitua a informação aproximada pela adição de vICMS, vIPI, vPIS e outros destaques: definição e finalidade são diferentes. Fonte: MOC 7 Anexo I — leiaute e regras de validação, p.123.

Campo opcional significa ausência igual a zero?

No XSD, vTotTrib é opcional tanto no item quanto no total. W16a-10 manda considerar zero quando não informado para essa comparação. Isso não converte dado desconhecido em imposto materialmente inexistente, nem resolve obrigações legais de transparência. O artigo explica a representação e a soma documentadas, sem afirmar que a omissão seja adequada a qualquer operação. Fonte: MOC 7 Anexo I — leiaute e regras de validação, W16a-10.

Exemplo com um item sem vTotTrib

Hipótese sintética de conferência: um item contém estimativa de R$ 11,30, outro de R$ 8,70 e um terceiro não contém M02. Para W16a-10, o terceiro contribui com zero; o resultado comparado é R$ 20,00. Os R$ 20,00 não autorizam afirmar que esse seja o tributo efetivamente devido ou retido. A fonte e os parâmetros usados para estimar os itens precisam estar documentados no processo de origem. Fonte: MOC 7 Anexo I — leiaute e regras de validação, p.123.

Como representar o total estimado

No PL 010f v1.04, o tipo TDec_1302 usa ponto como separador, sem R$, vírgula, espaço, sinal ou separador de milhar. Para valores com parte decimal, use duas casas, como 12.50. O padrão aceita 0.00. Zero só representa um total conhecido igual a zero; não é substituto de valor ainda não apurado. Fonte: Tipos básicos NF-e/NFC-e.

Fragmento parcial que apresenta somente a tag estudada:

<vTotTrib xmlns="http://www.portalfiscal.inf.br/nfe">20.00</vTotTrib>

No ICMSTot completo, vTotTrib é o último campo, depois de vNF, e pode ser omitido estruturalmente. Uma tag vazia não é uma omissão válida. Fonte: Schemas XML NF-e/NFC-e PL 010f.

Como diagnosticar a rejeição 685

A regra W16a-10 compara o total com M02 dos itens, considerando zero quando a tag não estiver informada; a divergência corresponde à rejeição 685, nas condições documentadas. Leia o código e a mensagem do retorno real antes de atribuir a causa. Liste os itens participantes, preserve os valores efetivamente serializados e some-os com aritmética decimal. Compare esse resultado com a tag de total, procurando item omitido, soma duplicada, ancestral errado ou alteração posterior ao cálculo.

Corrija a origem comprovada do erro no cálculo ou no mapeamento; depois gere uma nova prévia e valide novamente o campo, os itens e o XSD aplicável. Não edite XML já assinado ou autorizado para acertar a soma. A regra é facultativa no MOC para 55/65. Procure estimativa recalculada apenas no total, itens adicionados após o cálculo, soma de campos de imposto destacado ou contagem do próprio total. A aceitação pelo XSD demonstra estrutura, não autorização nem tratamento fiscal correto. Fonte: MOC 7 Anexo I — leiaute e regras de validação.

Esse valor aumenta vNF ou representa recolhimento?

vTotTrib não é uma parcela nomeada na composição W16-10 do valor da nota, nem comprovante de recolhimento. Retenções e impostos destacados têm campos específicos e não são substituídos pela estimativa. Se a dúvida envolver a obrigação legal ou a metodologia de transparência de preços da operação, reúna o tipo de venda, produto/serviço, data e fonte da estimativa para confirmação própria; não determine alíquota ou método a partir desta tag. Fontes: MOC 7 Anexo I — leiaute e regras de validação, pp.122–123; NT 2023.004 — Informações de Pagamentos e Outros, pp.15–16.

O grupo retTrib de retenções federais apresenta valores declarados de outra natureza, distintos da estimativa de tributos.

Referência técnica para integração

XPath completo
/nfeProc/NFe/infNFe/total/ICMSTot/vTotTrib
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_1302 · 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\.[0-9]{2}|[1-9]{1}[0-9]{0,12}(\.[0-9]{2})?
whiteSpace
preserve