qVolEmb na NF-e: conteúdo do produto por embalagem

qVolEmb informa o volume ou a quantidade do produto por embalagem, na unidade indicada em uEmb. Ele pertence a infProdEmb, em /nfeProc/NFe/infNFe/det/prod/infProdEmb/qVolEmb.

Se uma caixa contém 3 kg, a quantidade do campo é 3 e a unidade é kg. Se a remessa tem 10 caixas, o número 10 não substitui esse conteúdo por embalagem.

Antes do cálculo: o grupo é aplicável?

A NT 2021.002 v1.12, pp.8 e 22, restringe infProdEmb à Nota Fiscal Fácil ou nota avulsa e prevê 833 para presença indevida. No caso da NFF, a tabela observa preenchimento somente com modBC=1, pauta.

No diagnóstico de 833, os indicadores conferíveis na NT, p.22, são tpEmis=3 para NFF ou procEmi=1/procEmi=2 para nota avulsa. Eles precisam corresponder ao processo real; não devem ser alterados para habilitar a embalagem.

Essas condições não são escolhidas por haver caixas ou sacos. O processo de emissão e o tratamento fiscal devem estar previamente confirmados. Não acrescente o grupo a uma NF-e comercial comum apenas para registrar a embalagem logística; transp/vol tem outro papel.

Quantidade e unidade precisam ser lidas juntas

O trio é xEmb para a descrição, qVolEmb para o conteúdo e uEmb para a unidade. Um valor 3 sem unidade pode significar massa, volume, comprimento ou quantidade; por isso, o grupo exige os três filhos quando informado.

Não presuma equivalência com qCom ou qTrib. Se a unidade comercial for caixa, a quantidade comercial pode contar caixas; se for kg, pode medir conteúdo em massa. A conversão exige informação real e não deve ser usada para decidir a unidade fiscal por conveniência.

Também não copie peso bruto: ele pode incluir embalagem e possui outro significado. O conteúdo por embalagem não é automaticamente a cubagem externa nem o número de volumes transportados.

Precisão no schema atual

O PL 010f v1.04 torna qVolEmb obrigatório uma vez dentro de infProdEmb, com tipo TDec_0803v. O padrão admite até 8 dígitos inteiros e, para positivos com fração, de 1 a 3 casas decimais. Admite 0 e a forma zero com três casas; para frações menores que 1, a expressão exige três casas.

A tabela da NT 2021.002 apresenta 7v2. O tipo real atual deve ser conferido ao integrar: não rejeite uma medida de três casas só por um limite local baseado na tabela antiga.

Zero admitido pelo tipo não comprova embalagem vazia ou informação fiscal correta. Não transforme uma medida desconhecida em zero.

Exemplo de conteúdo e total físico

Fragmento sintético parcial sob hipótese de embalagem com 2,5 kg; não é nota pronta para transmissão:

<qVolEmb xmlns="http://www.portalfiscal.inf.br/nfe">2.500</qVolEmb>

No grupo correspondente, xEmb=caixa e uEmb=kg explicam o valor. Oito caixas idênticas conteriam 8 × 2,5 = 20 kg. A conta depende de todas terem o mesmo conteúdo confirmado; não descreve peso bruto nem determina uma base de imposto.

Como investigar medida ou formato incorretos

Confira se o dado de origem é conteúdo por embalagem ou quantidade de embalagens. Compare unidade, cadastro do produto, especificação da embalagem e XML enviado. Em schema, confira separador decimal, quantidade de casas, presença do filho e ordem entre xEmb e uEmb.

Para 833, a causa é a aplicação do grupo, não o arredondamento da quantidade. Para divergência física, obtenha a medida ou conversão documentada antes de alterar valores. Corrija a origem comprovada; não distribua uma diferença de peso em qVolEmb sem evidência de conteúdo por embalagem.