vTotTrib de ICMSTot: valor aproximado dos tributos e soma
<vTotTrib>total › ICMSTot › vTotTribRevisã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
- Campo opcional significa ausência igual a zero?
- Exemplo com um item sem vTotTrib
- Como representar o total estimado
- Como diagnosticar a rejeição 685
- Esse valor aumenta vNF ou representa recolhimento?
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