CAMPO DO XML · NF-E Obrigatório 9 posições 2 regras

vICMS

Valor Total do ICMS

✓ Conferido · 02 de outubro de 2026

Onde fica no arquivo

No documento

NFe/infNFe/total/ICMSTot/vICMS

Obrigatório, uma vez
NFe/infNFe/det/imposto/ICMS/ICMS00/vICMS

Obrigatório, uma vez

Valor do ICMS
NFe/infNFe/det/imposto/ICMS/ICMS10/vICMS

Obrigatório, uma vez

Valor do ICMS
NFe/infNFe/det/imposto/ICMS/ICMS20/vICMS

Obrigatório, uma vez

Valor do ICMS
NFe/infNFe/det/imposto/ICMS/ICMS51/vICMS

Opcional, no máximo uma vez

Valor do ICMS
NFe/infNFe/det/imposto/ICMS/ICMS70/vICMS

Obrigatório, uma vez

Valor do ICMS
NFe/infNFe/det/imposto/ICMS/ICMS90/vICMS

Obrigatório, uma vez

Valor do ICMS
NFe/infNFe/det/imposto/ICMS/ICMSPart/vICMS

Obrigatório, uma vez

Valor do ICMS
NFe/infNFe/det/imposto/ICMS/ICMSSN900/vICMS

Obrigatório, uma vez

Valor do ICMS

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

NFe — Nota Fiscal Eletrônica
└ infNFe — Informações da Nota Fiscal eletrônica
└ total — Dados dos totais da NF-e
└ ICMSTot — Totais referentes ao ICMS
└ vICMS — você está aqui

Dentro do grupo ICMSTot , totais referentes ao ICMS

O que o arquivo aceita neste campo

Ocorrência: 1-1
Tamanho: —
Tipo no esquema: TDec_1302
Formato base: string

Formato exigido: 0|0\.[0-9]{2}|[1-9]{1}[0-9]{0,12}(\.[0-9]{2})? Número decimal: até 13 dígitos na parte inteira e 2 casas decimais, com PONTO como separador. Sem separador de milhar, sem sinal e sem espaço. Expressão do próprio esquema. Valor que não casar com ela é recusado na validação do arquivo, antes de qualquer regra de negócio. ⚠ A leitura acima sai da EXPRESSÃO, não do nome do tipo: nome de tipo se expande por palpite e palpite publica regra errada.

As regras que verificam este campo — 2

O manual cita a tag pelo caminho no XML. Cada regra devolve um código de rejeição, e a ficha do código traz a mensagem que o autorizador exibe.

397 vICMS

Se QR Code versão “100" e Parâmetro Valor do ICMS no QR-Code diverge do Valor Total do ICMS da Nota Fiscal (tag:vICMS, id:W04) (NT 2017.002/ NT 2015.002)

Mensagem: Parâmetro do QR-Code divergente da Nota Fiscal:

546 vICMS

Se NF-e de Devolução (finNFe = 4): (NT 2022.005) - Valor total do ICMS da NF-e de Devolução (tag: vICMS, id:W04) maior que o somatório do valor correspondente das NF-e referenciadas Exceção 1: A RV somente será aplicada se todas as NF-e referenciadas existirem no BD da SEFAZ. Exceção 2: A RV poderá não ser aplicada, se existirem documentos fiscais referenciados com modelo diferente de 55; Exceção 3: A RV não será aplicada se existirem NF de Produtor referenciada, inviabilizando a identificação do valor devolvido; Observação 1: Se a NF-e de devolução tiver muitas NF-e referenciadas, a conferência do valor pode prejudicar a performance do Ambiente de Autorização. Nesses casos, a SEFAZ Autorizadora poderá não aplicar essa RV. Por exemplo, limitar a aplicação da RV somente para as NF-e de devolução com até 5 NF-e referenciadas e/ou com NF-e referenciadas de até 3 meses anteriores. Observação 2: A devolução pode ocorrer para muitos itens de diferentes NF-e, Considerar uma tolerância de até R$ 1,00 na validação.

Mensagem: NF-e de devolução com valor do ICMS superior a NF-e devolvida

O mesmo nome em outros documentos fiscais — 6

vICMS 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	Valor do ICMS	BPeTM/infBPe/detBPeTM/det/imp/ICMS/ICMS00/vICMS
CT-e	Valor do ICMS	CTeSimp/infCte/imp/ICMS/ICMS00/vICMS
CT-e OS	Valor do ICMS	CTeOS/infCte/imp/ICMS/ICMS00/vICMS
NF3e	Valor do ICMS	NF3e/infNF3e/NFdet/det/detItemAnt/vICMS
NFCom	Valor do ICMS	NFCom/infNFCom/det/imposto/ICMS00/vICMS
NFGas	Valor do ICMS	NFGas/infNFGas/det/gNormal/imposto/ICMS00/vICMS

Os campos dos doze documentos fiscais, com filtro →

Campos do mesmo grupo — 28

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

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

Perguntas frequentes

O que é o campo vICMS do NF-e?

Valor Total do ICMS No XML ele fica em NFe/infNFe/total/ICMSTot/vICMS. Obrigatório, uma vez.

vICMS aparece em quantos lugares do NF-e?

Em 9 posições do esquema oficial: NFe/infNFe/total/ICMSTot/vICMS, NFe/infNFe/det/imposto/ICMS/ICMS00/vICMS, NFe/infNFe/det/imposto/ICMS/ICMS10/vICMS, NFe/infNFe/det/imposto/ICMS/ICMS20/vICMS, NFe/infNFe/det/imposto/ICMS/ICMS51/vICMS, NFe/infNFe/det/imposto/ICMS/ICMS70/vICMS e outras. A mesma tag em posições diferentes tem ocorrência própria em cada lugar — o que vale no grupo do emitente não vale automaticamente no do destinatário.

Que formato o campo vICMS exige no NF-e?

Número decimal: até 13 dígitos na parte inteira e 2 casas decimais, com PONTO como separador. Sem separador de milhar, sem sinal e sem espaço. A regra é a expressão do próprio esquema (0|0\.[0-9]{2}|[1-9]{1}[0-9]{0,12}(\.[0-9]{2})?), e ela é verificada antes de qualquer regra de negócio: valor fora do formato faz o arquivo ser recusado na validação, com rejeição genérica de schema — que é a mais difícil de diagnosticar justamente por não citar o campo.

Que rejeição vICMS pode causar no NF-e?

2 regras do manual citam este campo, disparando os códigos 397, 546. ⚠ O número da rejeição não é único entre documentos fiscais: o mesmo código costuma existir na NF-e querendo dizer outra coisa.

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

O nome se repete no leiaute de 6 outros documentos (BP-e, CT-e, CT-e OS, 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.