<qVolEmb> Volume do produto na embalagem (qVolEmb)
Registra quanto produto existe em cada embalagem, na unidade declarada em uEmb.
O que é
qVolEmb é obrigatório quando infProdEmb existe. A tabela da NT 2021.002 o descreve como 7v2, mas os dois XSDs oficiais travados no catálogo usam TDec_0803v, que aceita zero ou valor positivo com até oito dígitos inteiros e até três casas decimais. A validação estrutural segue os XSDs atuais e a divergência editorial não autoriza ampliar ou reduzir o valor real. Seu significado depende de uEmb; por exemplo, caixa com 3 kg usa xEmb=caixa, qVolEmb=3 e uEmb=kg.
Quando usar
Informe a quantidade real por embalagem sempre que infProdEmb for usado.
Quando não usar
Não informe isoladamente, sem infProdEmb, e não confunda volume por embalagem com qCom ou qTrib do item.
Contrato XML
- XPath
/nfeProc/NFe/infNFe/det/prod/infProdEmb/qVolEmb- Namespace
http://www.portalfiscal.inf.br/nfe- Layout
- 4.00
- Versão
- PL_010e_v1.02
- Repetível
- Sim
- Condicional no XSD
- Sim
- Tipo-base
string
- pattern
0|0\.[0-9]{3}|[1-9]{1}[0-9]{0,7}(\.[0-9]{1,3})? - whiteSpace
preserve
O schema oficial contém uma anotação estrutural para esta variante.
Exemplo XML
projecao_contextual<qVolEmb xmlns="http://www.portalfiscal.inf.br/nfe">3.000</qVolEmb>Trecho contextual de uma fixture sintética completa; não é um documento XML standalone.
Fontes e referências
- Nota Técnica 2021.002 v1.12Portal Nacional da NF-e · Seção 3.3, Grupo I87, campo I87b (qVolEmb), p. 8.
- 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 infProdEmb/qVolEmb obrigatório no grupo e tipo TDec_0803v, linhas 1490–1498.
- 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 infProdEmb/qVolEmb obrigatório no grupo e tipo TDec_0803v, linhas 1461–1469.