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

vICMS total: somar o ICMS próprio sem duplicar FCP ou ST

<vICMS>total › ICMSTot › vICMS

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

vICMS em total/ICMSTot é o total do ICMS próprio dos itens. Não reúne todo valor relacionado ao imposto estadual: ICMS-ST, ICMS desonerado, monofasia, FCP e partilha possuem campos próprios.

Localização e representação no XML

XPath da ocorrência: /nfeProc/NFe/infNFe/total/ICMSTot/vICMS.

Propriedade no PL 010f v1.04 Valor
Tipo TDec_1302
Ocorrência no pai 1–1
Namespace http://www.portalfiscal.inf.br/nfe

Até 13 algarismos inteiros e duas casas decimais, com ponto; sem vírgula, sinal ou separador de milhar. A ocorrência local não elimina condições de negócio; valores desconhecidos não devem ser convertidos em zero. Para consultas XPath, associe o prefixo nfe: ao namespace; em arquivos sem nfeProc, comece em NFe. XSD oficial.

O recorte explícito da regra W04-10

W04-10, facultativa para modelos 55/65, compara W04 com N17 dos itens, com rejeição 532. O MOC determina não considerar os valores informados para CST 40, 41 e 50. A origem está em det/imposto/ICMS/<alternativa>/vICMS, nos grupos que contêm o valor. Não crie a tag em grupos que não a preveem. MOC 7, Anexo I, p.120.

Diferimento de item não deve ser deduzido duas vezes

Quando o item possui campos de ICMS da operação, diferido e final, totalize o vICMS que a regra identifica, sem substituir pelo valor da operação e sem retirar novamente o diferimento. O imposto-ST de item vICMSST vai a vST; FCP vai ao total próprio; ICMS monofásico possui seus três valores específicos.

Exemplo de imposto final já apurado

Hipótese sintética: dois itens elegíveis têm vICMS final de R$ 12,00 e R$ 18,00. O total é R$ 30,00. Se um deles registra separadamente R$ 5,00 de diferimento, esse valor não transforma o total em R$ 25,00 por uma segunda dedução. Outros R$ 8,00 de FCP tampouco o elevam a R$ 38,00.

Distinguir 532 de limite de ICMS

Para 532, compare os N17 efetivos, a alternativa/CST e a soma. A W04-20/417 trata de limite de ICMS parametrizável por UF; a mensagem tem causa distinta de uma soma divergente. Reúna UF, modelo, ambiente e retorno completo antes de concluir qual regra falhou. Se os valores dos itens estiverem errados, a classificação, base, alíquota e demais parâmetros precisam ser confirmados na origem fiscal do cálculo.

Fragmento XML e limites da conferência

Fragmento sintético da tag vICMS, no ancestral indicado acima, com o resultado do exemplo. É parcial: não contém o grupo pai completo nem uma nota pronta para transmissão.

<vICMS xmlns="http://www.portalfiscal.inf.br/nfe">30.00</vICMS>

O XSD confere a representação, não a apuração nem a autorização. Preserve o XML autorizado; a correção de divergências exige identificar sua origem e o procedimento fiscal aplicável.

Comparações para aprofundar a conferência

As diferenças essenciais entre as parcelas foram explicadas acima. Para acompanhar os campos relacionados em seu próprio contexto XML:

Referência técnica para integração

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