Peso bruto dos volumes na NF-e: unidade, formato e conferência de pesoB
<pesoB>transp › vol › pesoBRevisã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