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

vProd de ICMSTot: indTot e o total de produtos e serviços

<vProd>total › ICMSTot › vProd

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/vProd reúne os valores de produtos e serviços do recorte previsto para esse total. O indicador det/prod/indTot controla a participação: a comparação W07-10 considera somente itens com indTot=1. O valor não é necessariamente o total a pagar.

Nesta página:

Onde localizar valor e indicador

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

O valor de origem é det/prod/vProd (I11), e o indicador fica em det/prod/indTot (I17b). O MOC 7 descreve itens sujeitos ao ICMS. A NT 2025.002 v1.52, p.70, documenta o recorte como itens sujeitos ao ICMS ou IBS/CBS/IS, conservando o filtro indTot=1. Ao conferir uma emissão, use a versão de regras efetivamente aplicável, sem retroagir uma atualização ao XML histórico. Fontes: MOC 7 Anexo I — leiaute e regras de validação, p.121; NT 2025.002 RTC, p.70.

Exemplo em que somar todos os vProd dá errado

Hipótese sintética: itens participantes com valores de R$ 120,00 e R$ 80,00, ambos indTot=1; outro item de R$ 40,00 está corretamente documentado com indTot=0. O total W07 é R$ 200,00, não R$ 240,00. O exemplo pressupõe que os indicadores já foram definidos conforme a operação; não recomenda excluir item para baixar o total. Se a participação for duvidosa, confirme a natureza da operação e os documentos antes de mudar o indicador. Fonte: MOC 7 Anexo I — leiaute e regras de validação, W07-10.

Por que vServ e vNF são diferentes

ISSQNtot/vServ é verificado pela soma de prod/vProd dos itens sujeitos ao ISSQN, com regra própria W18-10. Já ICMSTot/vNF tem composição com descontos, acréscimos e tributos sob condições específicas. total/vNFTot é outro campo, relacionado ao total dos itens vItem na RTC. Assim, não copie vNF para vProd nem some os totais de grupos distintos sem considerar seus recortes. Fontes: MOC 7 Anexo I — leiaute e regras de validação, pp.122–123; NT 2025.002 RTC, p.71.

Como a NT 2026.008 altera a composição de vProd

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.

O total ICMSTot/vProd continua sendo conferido com os valores I11 dos itens do recorte W07-10; não se adiciona uma segunda vez IBS/CBS/IS por fora desse somatório. Os novos valores líquidos vUnComLiq, vProdLiq e vProdLiqTot são campos distintos previstos na NT, não substitutos automáticos de vProd nem declarações do PL 010f v1.04 aqui conferido.

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 representar o total de produtos

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.

Projeção parcial de ICMSTot, sem os outros campos obrigatórios:

<vProd xmlns="http://www.portalfiscal.inf.br/nfe">200.00</vProd>

vProd é obrigatório e antecede vFrete; a sequência do pacote deve ser respeitada. Não use subtotal comercial de uma tela sem conferir a correspondência com os itens serializados. Fonte: Schemas XML NF-e/NFC-e PL 010f.

Como diagnosticar a rejeição 564

A rejeição 564 está associada a W07-10. Faça uma tabela por nItem contendo vProd, indTot e grupos tributários existentes, depois some somente o recorte da regra aplicável. Procure itens duplicados, exclusão indevida, preço/quantidade divergentes e total calculado antes de uma alteração do item. Não mude indTot apenas para eliminar a diferença.

O MOC indica aplicação facultativa; a NT 2025.002 documenta a classificação obrigatória e o recorte ampliado. W07-10 já consta entre as alterações da v1.40, cujo cronograma documental indica produção em 03/08/2026. A edição consolidada v1.52 não transforma essa regra anterior em uma novidade de outubro. O aviso ENCAT de 05/10 adiou as mudanças então previstas da v1.52 para 26/10 em homologação e 16/11 em produção; ele não adia indistintamente todos os campos ou regras anteriores da NT, nem ativa regras marcadas como futuras. Confira versão e ambiente do retorno concreto. Fontes: MOC 7 Anexo I — leiaute e regras de validação; NT 2025.002 RTC, pp.5–6 e 70; ENCAT — alteração de datas.

O vServ de ISSQNtot detalha o total próprio dos serviços e sua comparação W18-10.

Referência técnica para integração

XPath completo
/nfeProc/NFe/infNFe/total/ICMSTot/vProd
Namespace
http://www.portalfiscal.inf.br/nfe
Leiaute
4.00 · PL_010e_v1.02
Ocorrências no XSD
1–1 no contexto do elemento pai
Tipo
TDec_1302 · string
Preenchimento no catálogo
Obrigatório

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