pesoB na NF-e: peso bruto total do veículo em toneladas
<pesoB>det › prod › veicProd › pesoBRevisão editorial em 14 de out. de 2026. As versões e condições das regras estão indicadas ao longo do artigo.
pesoB, em veicProd, representa o peso bruto total do veículo novo. O MOC orienta expressá-lo em toneladas, com quatro casas decimais. Esse dado técnico do veículo não é o peso bruto dos volumes transportados, que aparece em outro caminho e usa outra unidade.
O caminho no XML processado é /nfeProc/NFe/infNFe/det/prod/veicProd/pesoB. Sem o envelope nfeProc, a leitura começa em NFe. O namespace é http://www.portalfiscal.inf.br/nfe; consultas XPath precisam associá-lo a um prefixo.
- Peso bruto do veículo e dos volumes
- MOC e XSD têm alcances diferentes
- Conversão sintética de quilogramas para toneladas
- Como diagnosticar unidade ou valor incorreto
Peso bruto do veículo e dos volumes
O campo J09 é o peso bruto total do veículo. Deve refletir a especificação documental da configuração faturada. veicProd/pesoL, por sua vez, é o peso líquido do veículo. O leiaute não fornece neste campo uma fórmula universal que forme o peso bruto somando passageiros, carga ou acessórios ao peso líquido; use a informação técnica correspondente, sem estimar essas parcelas.
Em transp/vol/pesoB, o homônimo representa o peso bruto dos volumes em quilogramas. Copiar o valor numérico sem considerar o XPath pode multiplicar a grandeza por mil ou usar o peso da carga no lugar da característica do veículo. A quantidade comercial do item também não transforma veicProd/pesoB em total de veículos de uma nota.
MOC e XSD têm alcances diferentes
O MOC 7.0, p. 22, publica toneladas e quatro casas decimais, enquanto o XSD 010f declara pesoB como TString de um a nove caracteres. Portanto, o schema não é um tipo decimal que imponha sozinho a unidade e as quatro casas. Essa permissividade estrutural não torna a tag um campo de texto livre nem autoriza omitir a precisão material indicada pelo MOC.
A aplicação é restrita ao detalhamento de veículo novo, no grupo veicProd do item. Dentro desse grupo, o campo ocorre uma vez e é obrigatório; a ausência do grupo em uma operação diferente não torna este filho exigível isoladamente. A regra J01-10, mensagem 736, rejeita o grupo em NFC-e e em NF-e com DANFE Simplificado Tipo 2 (tpImp=6). A ampliação consta da NT 2026.002, com produção prevista em 03/08/2026; ela restringe o grupo inteiro, não o conteúdo deste campo.
Antes de serializar, confirme a unidade do dado recebido. Não acrescente “kg” ou “t” ao conteúdo. Se a representação ultrapassar nove caracteres, investigue grandeza, unidade e origem; não trunque uma medida verdadeira nem descarte casas por conveniência.
Conversão sintética de quilogramas para toneladas
Suponha que a especificação confirme peso bruto total de 1750 kg. Como 1 tonelada corresponde a 1000 kg, a conta é 1750 ÷ 1000=1,75 t. Com quatro casas, a representação do exemplo fica 1.7500:
<pesoB xmlns="http://www.portalfiscal.inf.br/nfe">1.7500</pesoB>
A conversão apenas muda a unidade de uma medida documental assumida; não calcula nem estima o PBT real. O exemplo é parcial e sintético: pesoB fica depois de pesoL e antes de nSerie, e os outros filhos obrigatórios foram omitidos. Não é nota pronta para transmissão.
Como diagnosticar unidade ou valor incorreto
Compare o PBT documental, sua unidade, o cadastro e o conteúdo efetivo do XML. Um valor 1750.0000 em toneladas não representa a hipótese de 1750 kg: a falta da conversão é material mesmo que a string caiba no schema. Já um valor correto com sufixo de unidade exige corrigir a serialização.
Confira também se o dado veio do peso da carga, do peso líquido ou do grupo de volumes. A passagem pelo XSD não elimina esses erros. Corrija apenas a origem ou conversão comprovadamente divergente e confira a nova geração. Mensagem 736 está ligada à vedação do grupo, não é prova de peso incorreto. Esta conferência não determina capacidade de carga permitida nem tributação.
Campos relacionados
Fontes oficiais
- MOC 7.0, Anexo I — 7.00, novembro de 2020: p. 22: grupo JA, campo J09 (pesoB); p. 96 J01-10, complementada pela NT 2026.002; p. 61 pesos de volumes em kg.
- Schemas XML NF-e, PL_010f_v1.04 — 010f v.1.04, publicado em 31/08/2026: declaração veicProd e seus 24 filhos; escolha exclusiva; campos 1-1 na sequência.
- NT 2026.002, DANFE Simplificado Tipo 2 — 1.11, setembro 2026, catálogo 01/10/2026: p. 3 cronograma; p. 12 J01-10/736.
- Tipos básicos do schema NF-e — PL_010f_v1.04: tipo TString: whiteSpace preserve e padrão sem espaços nas extremidades.
Referência técnica para integração
- XPath completo
/nfeProc/NFe/infNFe/det/prod/veicProd/pesoB- Namespace
http://www.portalfiscal.inf.br/nfe- Leiaute
- 4.00 · PL_010e_v1.02
- Ocorrências no XSD
- 1–1 no contexto do elemento pai
- Tipo
- inline:TString · TString
- 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.
- maxLength
9- minLength
1- pattern
[!-ÿ]{1}[ -ÿ]{0,}[!-ÿ]{1}|[!-ÿ]{1}- whiteSpace
preserve