vTotTrib do item: estimativa de tributos e rejeição 685
<vTotTrib>det › imposto › vTotTribRevisão editorial em 14 de out. de 2026. As versões e condições das regras estão indicadas ao longo do artigo.
vTotTrib em det/imposto informa o valor aproximado total de tributos federais, estaduais e municipais de um item. É uma estimativa informativa em moeda, distinta dos valores de ICMS, IPI, PIS e COFINS destacados nos grupos próprios.
A estrutura descrita usa o pacote oficial PL_010f_v1.04, publicado em 31/08/2026. Esse pacote não altera a versão selecionada de um XML histórico na consulta; para arquivos de outra versão, confira a declaração correspondente e as regras vigentes na data e no ambiente do documento.
Neste artigo:
- Qual vTotTrib está sendo consultado
- Como obter a estimativa sem somar tributos diferentes
- O que a rejeição 685 compara
- Exemplo XML do valor aproximado
- Como conferir ausência, zero e divergência
Qual vTotTrib está sendo consultado
O campo desta página é /nfeProc/NFe/infNFe/det/imposto/vTotTrib, identificado como M02 no MOC. A mesma grafia também aparece em total/ICMSTot/vTotTrib, W16a. O primeiro pertence ao item; o segundo é o valor aproximado agregado na nota. Procure pelo caminho completo e pelo nItem, pois uma busca global por vTotTrib pode retornar ambos.
O XSD admite zero ou uma ocorrência no item, no início de imposto. Trata-se de tipo monetário TDec_1302: represente R$ 30,00 como 30.00, sem símbolo de moeda, separador de milhar ou vírgula decimal. A opcionalidade estrutural não resolve sozinha as obrigações de informação ao consumidor aplicáveis ao caso.
Schemas NF-e/NFC-e PL_010f_v1.04 Tipos básicos do leiaute NF-e MOC 7.0 — Anexo I
Como obter a estimativa sem somar tributos diferentes
O leiaute define o que o valor representa, mas não estabelece uma alíquota aproximada única por produto nem permite deduzi-la de uma descrição comercial. Para conferir a origem, identifique a fonte da estimativa, sua versão/data, classificação do produto, origem e parâmetros efetivamente usados pelo emissor. Uma tabela ou percentual sem essa referência não permite reproduzir o resultado.
Não some bases de cálculo e alíquotas com valores de tributos. Mesmo somar apenas valores destacados não comprova a estimativa: eles descrevem a tributação da operação nos grupos próprios, enquanto vTotTrib é uma informação aproximada com finalidade e metodologia próprias.
Como demonstração aritmética condicionada, suponha uma fonte já validada para o exemplo que determine 30% sobre R$ 100,00: 100 × 30 ÷ 100 = R$ 30,00. O exemplo não determina a fonte, a base ou o percentual de uma empresa. Quando a fonte separar parcelas federais, estaduais e municipais, conserve a memória dessas parcelas e confira sua soma antes de gerar o valor agregado.
MOC 7.0 — Anexo I Schemas NF-e/NFC-e PL_010f_v1.04
O que a rejeição 685 compara
W16a-10, para modelos 55 e 65, compara o total W16a com o somatório dos itens M02 e descreve a rejeição 685. O MOC marca a validação como facultativa, o que não significa que a empresa pode ignorar um retorno real dessa regra.
Para essa comparação específica, o manual manda considerar zero quando o campo opcional estiver ausente. Isso é uma convenção do validador para a soma, não uma prova de que o tributo aproximado seja zero nem uma autorização para preencher informação desconhecida com zero.
Exemplo: item 1 com R$ 30,00 e item 2 com R$ 12,50 produzem total de R$ 42,50. Se o XML tem R$ 42,00 no total, há diferença de R$ 0,50. Confira os valores serializados de cada item e o agregador que gerou o total. W16a-10 não descreve filtro por indTot; não transporte para essa soma filtros de outras regras. O trecho da regra consultado não oferece uma tolerância monetária a ser inventada.
Exemplo XML do valor aproximado
O fragmento sintético abaixo demonstra apenas a posição e o formato de R$ 30,00. O grupo é válido isoladamente no XSD atual, cujos demais ramos são opcionais estruturalmente; sua ausência aqui não indica dispensa fiscal em uma nota real.
<imposto xmlns="http://www.portalfiscal.inf.br/nfe">
<vTotTrib>30.00</vTotTrib>
</imposto>
O documento completo continua precisando dos grupos tributários pertinentes, dos dados do item e dos totais. vTotTrib não se transforma em parcela a cobrar só por estar informado: é separado do valor comercial do item e dos impostos destacados.
Schemas NF-e/NFC-e PL_010f_v1.04 Tipos básicos do leiaute NF-e MOC 7.0 — Anexo I
Como conferir ausência, zero e divergência
Se o campo não existe, verifique se a fonte de estimativa foi obtida e se houve perda no mapeamento para imposto. Se contém 0.00, examine a origem desse zero: ele pode ser um resultado documentado ou um fallback indevido. Se o item está correto e o total diverge, investigue a agregação, a associação do item e o arredondamento realizado antes da serialização.
Guarde XML, nItem, memória por parcela, fonte e data da estimativa. Confirme com o responsável contábil a metodologia e os parâmetros apropriados ao produto e à operação. A conferência técnica reproduz os dados definidos e a soma; não escolhe a metodologia fiscal do leitor nem atesta regularidade tributária.
MOC 7.0 — Anexo I Schemas NF-e/NFC-e PL_010f_v1.04
Leitura relacionada
Fontes oficiais
- Schemas NF-e/NFC-e PL_010f_v1.04, 010f v1.04, publicado em 31/08/2026 — /infNFe/det/imposto/vTotTrib; sequência e cardinalidade dos ancestrais.
- Tipos básicos do leiaute NF-e, PL_010f_v1.04 — TString; TDec_1302; TDec_0302Max100 conforme o campo.
- MOC 7.0 — Anexo I, 7.00, novembro/2020 — MOC 7.0 p.25 M02; p.59 W16a; p.123 W16a-10/685.
Referência técnica para integração
- XPath completo
/nfeProc/NFe/infNFe/det/imposto/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