Pular para o conteúdo
Fiscal ProBiblioteca
NF-e e NFC-e · Transporte

Peso bruto dos volumes na NF-e: unidade, formato e conferência de pesoB

<pesoB>transp › vol › pesoB

Revisão editorial em 26 de set. de 2026. As versões e condições das regras estão indicadas ao longo do artigo.

pesoB informa o peso bruto, em quilogramas, dos volumes descritos no grupo vol. O caminho é /nfeProc/NFe/infNFe/transp/vol/pesoB. O dado precisa corresponder ao conjunto identificado nesse grupo. Não é automaticamente o peso de uma embalagem individual, o peso bruto do caminhão nem o peso de toda a carga quando a nota separa diversos conjuntos.

O MOC 7.0, X32 documenta o campo como peso bruto em kg, com ocorrência de zero a um e tamanho 12v3. O PL_010c efetivamente consultado usa TDec_1203. São referências de unidade e formato; a medição e o que ela abrange precisam ser conferidos nos registros da carga.

Peso bruto e peso líquido: confirme a mesma abrangência

A comparação entre bruto e líquido só é útil quando ambos correspondem aos mesmos volumes e ao mesmo critério de medição. O peso bruto contempla o peso registrado para o conjunto com a embalagem considerada nessa apuração; o peso líquido distingue a parcela correspondente à mercadoria conforme o critério aplicável. Não estime o peso da embalagem a partir de uma diferença entre registros que tratam de conjuntos diferentes.

Em seu manual aduaneiro, a Receita Federal distingue mercadoria, embalagem para transporte e unidade de carga. Nesse contexto, o bruto acrescenta a embalagem de transporte ao peso da mercadoria; a embalagem de apresentação comercial pode integrar a mercadoria, e a função de paletes precisa ser examinada caso a caso. Essa orientação é de declarações aduaneiras. Não transfira automaticamente suas regras de volumes ou precisão decimal para pesoB da NF-e, nem presuma que qualquer contêiner ou palete deva ser somado ao campo.

Se houver dúvida sobre o que integra o peso dos volumes na operação, esclareça a abrangência com os responsáveis pela expedição e pela documentação. O MOC do campo não cria uma lista universal de embalagens a incluir ou uma regra para estimar tara.

Onde obter o valor

Confira a pesagem e a relação de volumes que sustentam o peso bruto informado. Verifique se o documento de origem está em quilogramas, gramas ou toneladas, e se a medição é do conjunto inteiro ou de uma unidade. Um tíquete com caminhão carregado e tara do veículo não deve ser copiado para pesoB como se seu peso bruto fosse o peso bruto dos volumes: são objetos de medição diferentes.

Se a origem estiver em gramas, converta para quilogramas preservando a informação confirmada. Por exemplo, 204.000 gramas correspondem a 204 kg. Se estiver em toneladas, 0,204 t também corresponde a 204 kg. A conversão de unidade não permite inferir um peso ausente nem acrescentar uma embalagem desconhecida.

A quantidade comercial dos produtos também não estabelece o peso bruto. Para multiplicar um peso por quantidade, é necessário saber o que o valor de origem representa e se as unidades têm aquela massa efetiva. Não aplique um peso cadastral médio a todos os volumes como se fosse uma pesagem comprovada.

Exemplo com peso do conjunto

A expedição fictícia confirmou oito sacos, com peso líquido total de 200 kg e peso bruto total de 204 kg. Os valores já se referem aos oito sacos juntos:

<vol xmlns="http://www.portalfiscal.inf.br/nfe">
  <qVol>8</qVol>
  <esp>SACOS</esp>
  <pesoL>200.000</pesoL>
  <pesoB>204.000</pesoB>
</vol>

O fragmento é parcial e sintético, sem uso para transmissão. pesoB=204.000 significa 204 kg, não 204 gramas e não 204 mil kg. Não multiplique esse valor por oito ao totalizar: o peso do conjunto já inclui a quantidade informada. A diferença de 4 kg é apenas a diferença aritmética entre as duas medições assumidas; não cria um parâmetro de embalagem para outras cargas.

Se houver outros conjuntos em outros grupos vol, cada peso precisa ter sua abrangência própria. Somar pesos dos grupos só representa o conjunto da nota quando os grupos são distintos e não sobrepostos. Copiar 204 kg para cada linha pode duplicar o peso, mesmo que cada número satisfaça o XSD.

Como escrever quilogramas no XML

TDec_1203 admite zero e inteiros; quando há parte decimal, o padrão exige três casas. Para um valor de 204 kg, 204.000 é uma representação ilustrativa com três casas; o tipo também admite 204. O padrão comporta até 12 algarismos na parte inteira de um valor positivo, sem sinal negativo. A apresentação numérica usa ponto decimal e não usa separador de milhares, espaço ou sufixo de unidade.

Texto no campo Leitura ou problema
204.000 204 kg
1.234 1,234 kg; o ponto é decimal
1234.000 1.234 kg na escrita corrente em português
204,000 Vírgula incompatível com o padrão XML
204.00 Duas casas decimais, incompatíveis com este padrão quando há fração
204 kg Texto de unidade dentro do valor numérico

Não corte nem arredonde automaticamente uma medição com mais precisão sem esclarecer o tratamento do dado. Esta página não define tolerância de peso nem um método universal de arredondamento. Zero é admitido pelo formato, mas não significa “não pesado”; ausência e valor conhecido zero são situações diferentes.

Diagnóstico de valor incoerente ou falha de schema

Quando bruto e líquido parecerem invertidos, confira os rótulos da origem, a unidade e o conjunto antes de trocar campos. Quando o bruto for menor que o líquido, isso pede investigação de abrangência e medição; não se afirma aqui um código automático de rejeição para essa comparação. Uma falha de formato exige conferir o XML real, ponto, casas decimais, sinal e tags vazias.

Dentro de vol, pesoB vem depois de pesoL, se informado, e antes dos grupos lacres. O campo é opcional no leiaute consultado, mas <pesoB/> não é um número válido. A opcionalidade estrutural não resolve exigências da operação concreta nem autoriza substituir peso desconhecido por zero.

A leitura do MOC e do PL_010c foi confrontada com documentos posteriores consultados até 26/09/2026. Esses registros explicam o campo; não comprovam pesagem física, implantação da UF ou autorização do documento completo. Para a outra parcela da conferência, consulte peso líquido; para organizar conjuntos, consulte volumes transportados.

Referência técnica para integração

XPath completo
/nfeProc/NFe/infNFe/transp/vol/pesoB
Namespace
http://www.portalfiscal.inf.br/nfe
Leiaute
4.00 · PL_010e_v1.02
Ocorrências no XSD
0–1 no contexto do elemento pai
Tipo
TDec_1203 · string
Preenchimento no catálogo
Condicional

A ocorrência vale dentro da estrutura XML: um campo obrigatório em um grupo opcional não torna esse grupo obrigatório. A aplicação fiscal depende da operação e da versão da regra.

pattern
0|0\.[0-9]{3}|[1-9]{1}[0-9]{0,11}(\.[0-9]{3})?
whiteSpace
preserve