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

ICMSTot: como conferir os totais da NF-e e NFC-e

<ICMSTot>total › ICMSTot

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 é o grupo de totais em NFe/infNFe/total que reúne bases e valores de ICMS, ICMS-ST e FCP, além de parcelas como produtos, frete, desconto, PIS, COFINS e valor da nota. Apesar do nome, seu conteúdo não se limita ao imposto ICMS. O grupo é obrigatório no XSD conferido dos modelos 55 e 65.

Localização e representação no XML

O caminho desta ocorrência é /nfeProc/NFe/infNFe/total/ICMSTot. O prefixo de um XPath executável deve ser associado ao namespace http://www.portalfiscal.inf.br/nfe; por exemplo, use nfe: em cada elemento. O envelope nfeProc reúne a NF-e e seu protocolo. Em um XML de envio sem esse envelope, a busca começa em NFe, mantendo o caminho interno da tag.

O grupo e seus filhos devem seguir a sequência declarada no PL 010f v1.04. Ocorrência local não determina, sozinha, incidência ou exigência de negócio. Schemas oficiais NF-e/NFC-e, PL 010f v1.04.

Quais grandezas precisam permanecer separadas

vBC e vICMS tratam do ICMS próprio; vBCST é a base da substituição tributária e vST totaliza o vICMSST dos itens. vICMSDeson registra desoneração. O FCP tem total próprio, total retido por ST, total anteriormente retido e total para a UF de destino. Os campos de destino/remetente vêm de det/imposto/ICMSUFDest, irmão de ICMS, e não de suas alternativas. qBCMono, qBCMonoReten e qBCMonoRet são quantidades; seus pares vICMSMono, vICMSMonoReten e vICMSMonoRet são dinheiro.

Produto, encargos e contribuições também pertencem ao bloco

vProd, vFrete, vSeg, vDesc e vOutro resumem parcelas dos produtos. vII, vIPI e vIPIDevol mantêm tributos e devolução em campos distintos. vPIS e vCOFINS em ICMSTot usam o recorte de itens sujeitos ao ICMS; os homônimos em ISSQNtot atendem aos itens sujeitos ao ISSQN. vTotTrib é uma informação aproximada de tributos e não um valor adicional de imposto a cobrar. MOC 7, Anexo I, pp.58–60 e 120–123.

Como conferir vNF sem somar tudo duas vezes

O valor vNF possui uma composição específica em W16-10/610; ele não corresponde à soma de todos os filhos de ICMSTot. Como ponto de partida, a expressão geral soma produtos, subtrai desconto e considera a desoneração dedutível; acrescenta ICMS-ST, FCP-ST, ICMS monofásico sujeito à retenção, frete, seguro, outras despesas, II, IPI, IPI devolvido, serviços e as parcelas condicionais de PIS-ST e COFINS-ST. ICMS próprio, FCP próprio e tributos anteriormente retidos não são acréscimos automáticos dessa expressão. A seguir estão as condições e exceções que precisam ser lidas antes de aplicar a conta. NT 2023.004 v1.20, pp.15–16.

Parcelas da expressão geral de vNF

Para a regra geral, conserve estas parcelas nomeadas:

vNF = vProd - vDesc - desoneração dedutível
    + vST + vFCPST + vICMSMonoReten
    + vFrete + vSeg + vOutro + vII + vIPI + vIPIDevol
    + vServ
    + PIS-ST dos itens com indSomaPISST = 1
    + COFINS-ST dos itens com indSomaCOFINSST = 1

Aqui vServ vem de ISSQNtot; não é um filho de ICMSTot a inventar. PIS-ST é det/imposto/PISST/vPIS, campo R06, e COFINS-ST é det/imposto/COFINSST/vCOFINS, T06. Seus indicadores são examinados no mesmo grupo do item. Esses valores não são os totais comuns ICMSTot/vPIS e ICMSTot/vCOFINS. A condição de soma deve ser preservada por item, em vez de somar todas as contribuições indiscriminadamente.

Hipótese sintética: produtos de R$ 100,00, sem outras parcelas; PIS-ST de R$ 10,00 com indicador 1 e COFINS-ST de R$ 20,00 com indicador 0. A expressão acrescenta somente os R$ 10,00 de PIS-ST e resulta em R$ 110,00. A hipótese não define incidência nem qual indicador é apropriado para um contribuinte; demonstra a conferência depois que esses parâmetros foram confirmados. NT 2023.004 v1.20, p.15.

Quando a desoneração muda a dedução

O total vICMSDeson continua sendo a soma da desoneração dos itens. Já a dedução em vNF depende de indDeduzDeson e das exceções pertinentes. A exceção 4 da NT 2023.004 v1.20 determina não rejeitar a falta de subtração da desoneração de itens com indicador 0 ou não informado. A antiga exceção 3, que dispensava a subtração genericamente, está rasurada nessa versão: não deve ser apresentada como permissão geral vigente.

Hipótese sintética: produtos de R$ 100,00; item 1 com R$ 12,00 desonerados e indicador 1; item 2 com R$ 18,00 desonerados e indicador 0; sem outros componentes. O total desonerado permanece R$ 30,00, enquanto a conferência da dedução indicada resulta em vNF de R$ 88,00. Conferir o total e conferir a dedução são, portanto, tarefas distintas. O motivo da desoneração e o indicador precisam refletir o tratamento documentado da operação. NT 2023.004 v1.20, p.16.

Faturamento direto de veículos e importação têm exceções

A exceção 1 de W16-10 é para faturamento direto de veículos novos, identificado por det/prod/veicProd/tpOp=2. Na expressão desse ramo, conforme a tabela da NT 2023.004 v1.20, p.15, não entram vST, vFCPST, vIPIDevol e vICMSMonoReten; permanecem produtos, desconto, desoneração conforme a condição, frete, seguro, outras despesas, II, IPI, serviços e as somas condicionais de PIS-ST/COFINS-ST. A parcela vICMSMonoReten está rasurada nesse ramo do PDF e não deve ser mantida a partir da extração linear de texto. Esse tpOp pertence ao grupo de veículo do item, não à finalidade da nota nem a um indicador genérico de operação. Não aplique o ramo a qualquer venda de veículo.

Hipótese aritmética delimitada: produtos de R$ 100,00, frete de R$ 5,00 e ICMS-ST informado de R$ 10,00, sem outras parcelas. A expressão geral soma R$ 115,00; o ramo de faturamento direto indicado soma R$ 105,00 porque não acrescenta os R$ 10,00 de ST. O exemplo serve para distinguir as expressões, sem decidir o tratamento fiscal do faturamento.

A exceção 2 estabelece que W16-10 não se aplica às operações de importação com CFOP iniciado por 3. A dispensa dessa comparação não autoriza valores arbitrários, não elimina os outros totalizadores e não determina a tributação da importação. Para diagnosticar 610, confira primeiro se a operação pertence ao recorte da regra. NT 2023.004 v1.20, p.15.

ICMSTot e o total com IBS/CBS são grupos diferentes

O grupo IBSCBSTot é irmão de ICMSTot e guarda seus próprios somatórios. O campo total/vNFTot também é distinto de ICMSTot/vNF. Na NT 2025.002 v1.52, W60-05 e W60-10 aparecem como implementação futura; VB01-10 ainda contém, naquela edição, a exceção de 2025/2026 para não acrescentar separadamente IBS, CBS, IS e os totais monofásicos de IBS/CBS. Esse texto precisa ser confrontado com a mudança posterior; não é uma fórmula universal atual. NT 2025.002 v1.52, pp.68 e 71.

A NT 2026.008 v1.00, pp. 4 e 6, define a representação dos tributos no valor bruto do produto e explicita, no leiaute I11, que a partir de 2027 IBS, CBS e IS compõem vProd, exceto nas notas de importação. Nas tabelas VB01-10 e VB01-20, pp.9–10, os acréscimos separados desses tributos e a antiga exceção 2025/2026 estão rasurados; a observação de implementação futura permanece. O resultado não pode contar novamente tributos já contidos em vProd. A definição de base fiscal continua distinta do preço bruto: incluir IBS/CBS no campo de produto não os inclui automaticamente em suas próprias bases. NT 2026.008 v1.00.

O PDF da NT 2026.008 previa homologação em 05/10 e produção em 03/11/2026. O aviso ENCAT de 05/10/2026 inclui expressamente essa NT no adiamento para 26/10/2026 em homologação e 16/11/2026 em produção, marcos ainda futuros em 14/10/2026. Não se infere daí a ativação das regras que continuam marcadas como futuras. Na integração, registre a data da nota, o pacote admitido pelo ambiente e a regra aplicável; para documentos históricos, preserve a composição original e evite aplicar retroativamente o modelo de preço da nova rodada. Aviso oficial ENCAT.

Exemplo de grupo completo com premissas delimitadas

Hipótese sintética: nota de mercadorias com dois itens, produtos somados de R$ 100,00, frete R$ 5,00 e desconto R$ 10,00, sem outros acréscimos ou tributos a acrescentar ao valor da nota; as bases e os valores fiscais previstos no exemplo foram efetivamente apurados como zero. Assim, vNF é 100,00 + 5,00 − 10,00 = R$ 95,00. O fragmento abaixo traz todos os filhos obrigatórios do grupo, na ordem do XSD, e omite os opcionais. Ele não recomenda tributação zerada para uma operação real.

Separar erro de estrutura e erro de soma

Valide primeiro namespace, ordem, formatos e presença dos filhos obrigatórios. Depois compare cada total com seu campo de origem, mantendo nItem, tributo, categoria e unidade. Exemplos: W03-10/531 confere base própria; W04-10/532, ICMS próprio; W06-10/534, ICMS-ST; W08-10/535, frete; W10-10/537, desconto. O campo vNF possui a regra W16-10/610 e suas exceções. A aplicação facultativa de algumas regras depende da autorizadora; não torna legítimo manter um total incorreto. Uma nota autorizada deve ser preservada integralmente; divergência descoberta depois exige procedimento fiscal próprio, não edição do XML assinado.

Fragmento XML e limites da conferência

O exemplo é sintético e parcial em relação à nota inteira. Ele contém o grupo completo, com as premissas explicadas acima. Não contém identificação, itens completos, demais totais, assinatura ou protocolo e não está pronto para transmissão.

<ICMSTot xmlns="http://www.portalfiscal.inf.br/nfe">
  <vBC>0.00</vBC>
  <vICMS>0.00</vICMS>
  <vICMSDeson>0.00</vICMSDeson>
  <vFCP>0.00</vFCP>
  <vBCST>0.00</vBCST>
  <vST>0.00</vST>
  <vFCPST>0.00</vFCPST>
  <vFCPSTRet>0.00</vFCPSTRet>
  <vProd>100.00</vProd>
  <vFrete>5.00</vFrete>
  <vSeg>0.00</vSeg>
  <vDesc>10.00</vDesc>
  <vII>0.00</vII>
  <vIPI>0.00</vIPI>
  <vIPIDevol>0.00</vIPIDevol>
  <vPIS>0.00</vPIS>
  <vCOFINS>0.00</vCOFINS>
  <vOutro>0.00</vOutro>
  <vNF>95.00</vNF>
</ICMSTot>

Validar o formato no XSD não comprova cálculo correto, aplicabilidade tributária ou autorização. Para uma divergência, preserve o retorno original e o XML da tentativa; corrija a causa demonstrada na geração ou no cálculo antes de uma nova validação. XML autorizado e assinado não deve ser editado.

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
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
inline:complexType
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.