Volumes na NF-e: como organizar quantidade, embalagem, peso e lacres

O grupo vol descreve os volumes transportados na operação. Ele reúne a quantidade, a espécie e a identificação das embalagens, os pesos e, quando informados, seus lacres. Seu caminho é /nfeProc/NFe/infNFe/transp/vol. A pergunta central é quais volumes reais esse registro representa: dez caixas podem estar em um único grupo com qVol=10, enquanto duas espécies de embalagem podem precisar de registros distintos para conservar suas informações.

O MOC 7.0, campos X26 a X34 documenta até 5.000 grupos vol dentro de transp. Essa capacidade é um limite de registros XML; não é a quantidade de caixas permitida no transporte. Cada grupo tem seu próprio qVol e seus próprios pesos. O XML não transforma automaticamente linhas de produtos em volumes.

De onde vêm os dados dos volumes

Use a conferência da expedição, a relação de embalagens e as pesagens que efetivamente correspondem à carga documentada. Uma nota com 120 unidades comerciais pode ser expedida em dez caixas. Nesse caso, a quantidade comercial do produto e a quantidade de volumes respondem a perguntas diferentes. Não copie qCom para qVol apenas porque ambos são quantidades.

A preparação da carga também pode mudar a organização originalmente prevista: separar uma caixa, consolidar pacotes ou incluir uma embalagem altera os dados físicos. Confirme a situação real antes de gerar o documento. Esta página explica como representar os dados confirmados; não determina como embalar a mercadoria nem qual enquadramento fiscal aplicar.

O papel de cada campo

Os seis campos simples são opcionais no leiaute consultado. lacres também é opcional, mas cada grupo lacres criado deve conter um nLacre. A existência de um volume não obriga, pelo XSD, a inventar uma marca ou um lacre. A opcionalidade estrutural tampouco dispensa conferir as informações exigíveis no contexto real.

Um grupo pode representar várias caixas

Suponha, apenas para ilustrar a organização, que a expedição confirmou dez caixas identificadas de CX001 a CX010, com peso líquido conjunto de 100 kg e peso bruto conjunto de 108 kg. O trecho parcial seria:

<vol xmlns="http://www.portalfiscal.inf.br/nfe">
  <qVol>10</qVol>
  <esp>CAIXAS</esp>
  <nVol>CX001 A CX010</nVol>
  <pesoL>100.000</pesoL>
  <pesoB>108.000</pesoB>
</vol>

A identificação é texto ilustrativo, não uma sintaxe oficial de faixa. Os pesos são os valores correspondentes ao conjunto descrito neste grupo. Não multiplique novamente 108 kg por dez ao consolidar os dados: isso contaria o mesmo peso dez vezes. Se o cadastro informa peso por caixa, a transformação em peso do conjunto precisa conservar a quantidade e a origem da medição, sem aplicar uma fórmula a embalagens que tenham pesos diferentes.

O exemplo omite o restante da nota e não serve para transmissão. A presença de quilogramas é explicada no texto; kg não é escrito dentro das tags numéricas.

Quando separar registros

Se a carga tiver dez caixas e dois tambores, um único texto CAIXAS E TAMBORES não permite atribuir separadamente quantidade, peso e identificação a cada espécie. Quando a documentação da expedição distingue os conjuntos, dois grupos podem preservar essa diferença:

<vol xmlns="http://www.portalfiscal.inf.br/nfe">
  <qVol>10</qVol>
  <esp>CAIXAS</esp>
  <pesoL>100.000</pesoL>
  <pesoB>108.000</pesoB>
</vol>
<vol xmlns="http://www.portalfiscal.inf.br/nfe">
  <qVol>2</qVol>
  <esp>TAMBORES</esp>
  <pesoL>80.000</pesoL>
  <pesoB>90.000</pesoB>
</vol>

São dois fragmentos irmãos, não um arquivo XML completo. Nesta hipótese, os conjuntos são distintos: a soma física é de 12 volumes, 180 kg líquidos e 198 kg brutos. Essa conferência aritmética depende de não haver sobreposição. Registrar as mesmas caixas uma vez isoladas e outra vez dentro de um palete pode duplicar quantidade e peso; a simples aceitação pelo schema não detecta esse problema operacional.

Lacres e ordem de geração

No XSD real PL_010c consultado, a sequência dentro de vol é qVol, esp, marca, nVol, pesoL, pesoB e os grupos lacres. Campos opcionais ausentes são pulados, mas os presentes conservam essa ordem. Um pesoB antes de pesoL, quando ambos existem, pode provocar falha estrutural mesmo com pesos corretos.

Cada lacre usa um grupo próprio com um nLacre; a repetição permitida é de até 5.000 grupos lacres por vol. Essa quantidade não estabelece um lacre por caixa. Conserve a associação registrada na expedição e não mova uma lista de lacres para todos os grupos indistintamente. Veja a organização dos lacres para os exemplos dessa estrutura.

Como diagnosticar uma divergência

Quando a quantidade parecer errada, compare qVol com a relação de embalagens, e não com o número de linhas da nota. Quando os pesos divergirem, confira a unidade de origem, a abrangência da pesagem e a duplicação de grupos. Se o erro mencionar conteúdo inválido, examine o XML efetivamente gerado: quantidade fracionária, vírgula decimal nos pesos, tags vazias e ordem incorreta são problemas diferentes.

Identifique o caminho completo no erro. Um nVol alfanumérico não deve passar pela mesma validação de qVol; um número de lacre também é texto. Não atribua uma rejeição numérica específica a esses casos sem o retorno real da autorização e a regra correspondente. A leitura estrutural do PL_010c, confrontada com o MOC e os documentos posteriores catalogados até 26/09/2026, explica o grupo; não comprova que qualquer XML está apto à autorização em determinada UF.

Para detalhes próprios de cada dado, consulte quantidade de volumes, numeração dos volumes, peso líquido e peso bruto.