Pular para o conteúdo
Fiscal ProBiblioteca
NF-e e NFC-e · Produtos e serviços

pesoB na NF-e: peso bruto total do veículo em toneladas

<pesoB>det › prod › veicProd › pesoB

Revisã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

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

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