NCM Buscador

ICMSTot

Totais referentes ao ICMS

✓ Conferido · 02 de outubro de 2026Esquema XML da NF-e (leiaute) — enums oficiais de campo — Pacote de Liberação PL_010f_v1.04, publicado em 31/08/2026 (NT 2025.002 v1.50 e NT 2026.007 v1.00) · Receita Federal / ENCAT

Onde fica no arquivo

No documento

  • NFe/infNFe/total/ICMSTot

    Obrigatório, uma vez

O caminho até aqui, nível a nível

  1. NFe — Nota Fiscal Eletrônica
  2. └ infNFe — Informações da Nota Fiscal eletrônica
  3. └ total — Dados dos totais da NF-e
  4. └ ICMSTot — você está aqui

Dentro do grupo total , dados dos totais da NF-e

O que o arquivo aceita neste campo

Ocorrência
1-1
Tamanho
—
Tipo no esquema
grupo
Formato base
grupo

O mesmo nome em outros documentos fiscais — 4

ICMSTot aparece no leiaute de outros documentos, e isso não quer dizer que seja o mesmo campo: cada um tem manual, regra e às vezes tipo próprios. Aplicar a regra de um documento no outro é o erro que esta lista existe para evitar. Cada linha traz o caminho no arquivo daquele documento, que é onde a diferença aparece primeiro.

Documento O que o leiaute dele diz Caminho lá
BP-e Totais referentes ao ICMS BPeTM/infBPe/total/ICMSTot
NF3e Totais referentes ao ICMS NF3e/infNF3e/total/ICMSTot
NFCom Totais referentes ao ICMS NFCom/infNFCom/total/ICMSTot
NFGas Totais referentes ao ICMS NFGas/infNFGas/total/ICMSTot

Os campos dos doze documentos fiscais, com filtro →

O que vai dentro deste grupo — 29

ICMSTot é um grupo: ele não carrega valor próprio, agrupa os campos abaixo. A obrigatoriedade de cada um vale dentro do grupo — campo obrigatório num grupo opcional só é exigido quando o grupo é informado.

Campo O que é Ocorrência
qBCMono Valor total da quantidade tributada do ICMS monofásico próprio Opcional, no máximo uma vez
qBCMonoRet Valor total da quantidade tributada do ICMS monofásico retido anteriormente Opcional, no máximo uma vez
qBCMonoReten Valor total da quantidade tributada do ICMS monofásico sujeito a retenção Opcional, no máximo uma vez
vBC BC do ICMS Obrigatório, uma vez
vBCST BC do ICMS ST Obrigatório, uma vez
vCOFINS Valor do COFINS Obrigatório, uma vez
vDesc Valor do desconto da fatura Opcional, no máximo uma vez
vFCP Valor Total do FCP (Fundo de Combate à Pobreza). Obrigatório, uma vez
vFCPST Valor Total do FCP (Fundo de Combate à Pobreza) retido por substituição tributária. Obrigatório, uma vez
vFCPSTRet Valor Total do FCP (Fundo de Combate à Pobreza) retido anteriormente por substituição tributária. Obrigatório, uma vez
vFCPUFDest Valor total do ICMS relativo ao Fundo de Combate à Pobreza (FCP) para a UF de destino. Opcional, no máximo uma vez
vFrete Valor Total do Frete Opcional, no máximo uma vez
vICMS Valor Total do ICMS Obrigatório, uma vez
vICMSDeson Valor Total do ICMS desonerado Obrigatório, uma vez
vICMSMono Valor total do ICMS monofásico próprio Opcional, no máximo uma vez
vICMSMonoRet Valor do ICMS monofásico retido anteriormente Opcional, no máximo uma vez
vICMSMonoReten Valor total do ICMS monofásico sujeito a retenção Opcional, no máximo uma vez
vICMSUFDest Valor total do ICMS de partilha para a UF do destinatário Opcional, no máximo uma vez
vICMSUFRemet Valor total do ICMS de partilha para a UF do remetente Opcional, no máximo uma vez
vII Valor Total do II Obrigatório, uma vez
vIPI Valor Total do IPI Obrigatório, uma vez
vIPIDevol Valor Total do IPI devolvido. Deve ser informado quando preenchido o Grupo Tributos Devolvidos na emissão de nota finNFe=4 (devolução) nas operações… Obrigatório, uma vez
vNF Valor Total da NF-e Obrigatório, uma vez
vOutro Outras despesas acessórias Opcional, no máximo uma vez
vPIS Valor do PIS Obrigatório, uma vez
vProd Valor bruto do produto ou serviço. Obrigatório, uma vez
vSeg Valor Total do Seguro Opcional, no máximo uma vez
vST Valor Total do ICMS ST Obrigatório, uma vez
vTotTrib Valor estimado total de impostos federais, estaduais e municipais Opcional, no máximo uma vez

Campos do mesmo grupo — 5

São os campos que ficam ao lado deste no arquivo, dentro de NFe/infNFe/total. Quem preenche um costuma precisar dos outros na mesma passada.

Perguntas frequentes

O que é o campo ICMSTot do NF-e?

Totais referentes ao ICMS No XML ele fica em NFe/infNFe/total/ICMSTot. É um grupo: não carrega valor próprio, agrupa outros campos. Obrigatório, uma vez.

O que vai dentro do grupo ICMSTot do NF-e?

29 campos: qBCMono, qBCMonoRet, qBCMonoReten, vBC, vBCST, vCOFINS, vDesc, vFCP, vFCPST, vFCPSTRet, vFCPUFDest, vFrete, vICMS, vICMSDeson, vICMSMono, vICMSMonoRet, vICMSMonoReten, vICMSUFDest, vICMSUFRemet, vII e outros. Grupo não carrega valor próprio — ele existe para agrupar esses campos, e a obrigatoriedade de cada um vale dentro dele.

ICMSTot no NF-e é o mesmo campo dos outros documentos fiscais?

O nome se repete no leiaute de 4 outros documentos (BP-e, NF3e, NFCom, NFGas), e isso não quer dizer que seja o mesmo campo: cada documento tem manual próprio, regra própria e às vezes tipo diferente. Aplicar a regra de um no outro é erro comum e caro.

De onde vem esta descrição do NF-e?

Do esquema XML oficial (PL_010f_v1.04). O Buscador NCM lê a árvore do próprio arquivo: tipo, tamanho, ocorrência e domínio saem sem interpretação. O manual manda na REGRA de validação; o esquema manda no CAMPO.

Voltar ao topo