<vItem> Valor total do item da NF-e (vItem)
Registra o total do item segundo a composição definida pelas regras da Reforma Tributária.
O que é
vItem é opcional no XSD e usa TDec_1302: zero ou valor positivo com até 13 dígitos inteiros e duas casas decimais. As regras VB01-05, VB01-10 e VB01-20 estão expressamente marcadas como implementação futura na NT 2025.002 v1.50. VB01-05 exige o campo quando gIBSCBS existir; VB01-10 verifica a composição geral quando tpOp é nulo ou diferente de 2; VB01-20 usa composição própria para faturamento direto de veículo novo com tpOp=2. A ficha documenta as regras, mas não calcula, estima nem preenche o total sem todos os componentes reais.
Quando usar
Informe quando a operação estiver alcançada pela regra vigente e o total puder ser apurado com todos os componentes fiscais reais do item.
Quando não usar
Não antecipe regra futura, não some valores ausentes, não estime tributos e não copie vProd como fallback.
Contrato XML
- XPath
/nfeProc/NFe/infNFe/det/vItem- Namespace
http://www.portalfiscal.inf.br/nfe- Layout
- 4.00
- Versão
- PL_010e_v1.02
- Repetível
- Sim
- Condicional no XSD
- Não
- Tipo-base
string
- pattern
0|0\.[0-9]{2}|[1-9]{1}[0-9]{0,12}(\.[0-9]{2})? - whiteSpace
preserve
O schema oficial contém uma anotação estrutural para esta variante.
Exemplo XML
projecao_contextual<vItem xmlns="http://www.portalfiscal.inf.br/nfe">100.00</vItem>Trecho contextual de uma fixture sintética completa; não é um documento XML standalone.
Fontes e referências
- Nota Técnica 2025.002 v1.50Portal Nacional da NF-e · Seção 6, Grupo VB, campo VB01 (vItem), p. 30; regras VB01-05, VB01-10 e VB01-20 e respectivas observações de implementação futura, pp. 69–70.
- Schemas XML NF-e 010e v1.02 — NT 2025.002 v1.40, NT 2026.002 v1.00 e NT 2026.003 v1.00Portal Nacional da NF-e · PL_010e_v1.02/NFe/leiauteNFe_v4.00.xsd, elemento det/vItem opcional e tipo TDec_1302, linhas 5289–5293; tiposBasico_v4.00.xsd, TDec_1302, linhas 301–309.
- Schemas XML NF-e 010d v1.03 — CNPJ Alfanumérico — NT 2026.004 v1.01Portal Nacional da NF-e · PL_010d_v1.03/NFe/leiauteNFe_v4.00.xsd, elemento det/vItem opcional e tipo TDec_1302, linhas 5260–5264; tiposBasico_v4.00.xsd, TDec_1302, linhas 301–309.