NCM Buscador
Buscar
CAMPO DO XML · NF3E Opcional 6 posições 1 regra

vICMSST

Valor do ICMS ST retido

✓ Conferido · 12 de outubro de 2026 NF3e (modelo 66): leiaute do XML e regras de validação — MOC NF3e — Anexo I: Leiaute e Regras de Validação, versão 1.00a · Portal Nacional dos DF-e / SVRS

Onde fica no arquivo

No documento

  • NF3e/infNF3e/NFdet/det/detItemAnt/vICMSST

    Opcional, no máximo uma vez

  • NF3e/infNF3e/NFdet/det/detItem/gProcRef/vICMSST

    Obrigatório, uma vez

  • nf3eProc/NF3e/infNF3e/NFdet/det/detItemAnt/vICMSST

    Opcional, no máximo uma vez

  • NF3e/infNF3e/NFdet/det/detItem/imposto/ICMS10/vICMSST

    Obrigatório, uma vez

  • nf3eProc/NF3e/infNF3e/NFdet/det/detItem/gProcRef/vICMSST

    Obrigatório, uma vez

  • nf3eProc/NF3e/infNF3e/NFdet/det/detItem/imposto/ICMS10/vICMSST

    Obrigatório, uma vez

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

  1. NF3e — Nota Fiscal Eletrônica de Energia Elétrica
  2. └ infNF3e — Informações da NF3e
  3. └ NFdet — Detalhamento de Produtos e Serviços
  4. └ det — Detalhamento de Produtos e Serviços
  5. └ detItemAnt — Grupo de informações referentes a item da NF3e anterior
  6. └ vICMSST — você está aqui

Dentro do grupo detItemAnt , grupo de informações referentes a item da NF3e anterior

O que o arquivo aceita neste campo

Ocorrência
0-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 — 1

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.

485 detItemAnt/vICMSST Validações da NF-3 de Ajuste (Banco de Dados)

- Acessar BD e verificar se o valor do ICMS ST (tag: detItemAnt/vICMSST) é igual ao valor do ICMS ST do item da NF3e anterior

Mensagem: Valor do ICMS ST da NF3e de ajuste é diferente do valor do ICMS ST do item ajustado na NF3e anterior

O mesmo nome em outros documentos fiscais — 3

vICMSST 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á
CT-e Valor do ICMS ST evEPECCTe/vICMSST
NF-e Valor do ICMS ST NFe/infNFe/det/imposto/ICMS/ICMS10/vICMSST
NFGas Valor do ICMS ST retido NFGas/infNFGas/det/gNormal/imposto/ICMS10/vICMSST

Os campos dos doze documentos fiscais, com filtro →

Campos do mesmo grupo — 17

São os campos que ficam ao lado deste no arquivo, dentro de NF3e/infNF3e/NFdet/det/detItemAnt. Quem preenche um costuma precisar dos outros na mesma passada.

cClass Código de classificação indDevolucao Indicador de devolução do valor do item nItemAnt Número do item da NF3e anterior que este item está substituindo. Deve sempre existir um… pICMS Alíquota do ICMS qFaturada Quantidade Faturada retTrib Grupo de informações de retenção de tributos federais do item anterior vBC BC do ICMS vBCST BC do ICMS ST vCOFINS Valor do COFINS vCOFINSEfet Total do Valor Efetivo do COFINS vFCP Valor Total do FCP (Fundo de Combate à Pobreza). vFCPST Valor Total do FCP (Fundo de Combate à Pobreza) retido por substituição tributária. vICMS Valor Total do ICMS vItem Valor unitário do item vPIS Valor do PIS vPISEfet Total do Valor Efetivo do PIS vProd Valor Total dos produtos e serviços

Perguntas frequentes

O que é o campo vICMSST da NF3e?

Valor do ICMS ST retido No XML ele fica em NF3e/infNF3e/NFdet/det/detItemAnt/vICMSST. Opcional, no máximo uma vez.

vICMSST aparece em quantos lugares da NF3e?

Em 6 posições do esquema oficial: NF3e/infNF3e/NFdet/det/detItemAnt/vICMSST, NF3e/infNF3e/NFdet/det/detItem/gProcRef/vICMSST, nf3eProc/NF3e/infNF3e/NFdet/det/detItemAnt/vICMSST, NF3e/infNF3e/NFdet/det/detItem/imposto/ICMS10/vICMSST, nf3eProc/NF3e/infNF3e/NFdet/det/detItem/gProcRef/vICMSST, nf3eProc/NF3e/infNF3e/NFdet/det/detItem/imposto/ICMS10/vICMSST. 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 vICMSST exige na NF3e?

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 vICMSST pode causar na NF3e?

1 regra do manual cita este campo, disparando o código 485. ⚠ 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.

vICMSST na NF3e é o mesmo campo dos outros documentos fiscais?

O nome se repete no leiaute de 3 outros documentos (CT-e, NF-e, 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 da NF3e?

Do esquema XML oficial (PL_NF3E_1.00a_NT2026.004_RTC_1.00). 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