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

pesoL na NF-e: peso líquido do veículo em toneladas

<pesoL>det › prod › veicProd › pesoL

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

pesoL, no grupo veicProd, informa o peso líquido do veículo novo. O MOC indica toneladas e quatro casas decimais. Para interpretar o valor corretamente, é preciso considerar esse caminho: existe também pesoL no grupo de volumes transportados, cujo referencial é quilograma.

O caminho no XML processado é /nfeProc/NFe/infNFe/det/prod/veicProd/pesoL. 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.

Qual peso deve ser conferido

O campo J08 se refere à característica do veículo vinculado ao item. Obtenha o peso líquido da documentação técnica correspondente ao chassi/configuração. A descrição comercial, o peso da carga transportada e uma medida de outro modelo não substituem esse dado.

pesoB é o peso bruto total do veículo; CMT, a capacidade máxima de tração. São grandezas separadas. O leiaute não autoriza usar PBT ou CMT como substituto do peso líquido, nem apresenta uma fórmula universal para inferi-lo por subtração de carga presumida. Conferir essas diferenças evita que uma informação estruturalmente aceitável descreva outra característica.

Diferença para o campo de volumes

transp/vol/pesoL descreve o peso líquido dos volumes em kg. prod/veicProd/pesoL descreve o veículo em toneladas. Antes de reutilizar um mapeamento, uma regra ou uma conversão pelo nome da tag, confira os ancestrais e a unidade documental. Não totalize este campo multiplicando-o pela quantidade comercial como se fosse o peso global da carga.

O MOC publica formato 9v4 com quatro casas em toneladas; o XSD 010f usa TString de um a nove caracteres. A diferença precisa ser preservada: a validação de string não impõe unidade nem precisão, mas também não revoga a orientação material do manual. Escrever um texto ou uma unidade na tag não atende ao significado do campo.

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.

Exemplo com medida documentada em kg

Assuma peso líquido de 1250 kg na documentação de um veículo fictício. A conversão é 1250 ÷ 1000=1,25 t. A representação com quatro casas é:

<pesoL xmlns="http://www.portalfiscal.inf.br/nfe">1.2500</pesoL>

O exemplo converte uma medida assumida, sem calcular o peso real de qualquer veículo. pesoL vem depois de cilin e antes de pesoB; os demais filhos obrigatórios não aparecem neste recorte parcial. O fragmento não é uma nota pronta para transmissão.

Como investigar diferença de mil vezes

Confira o documento, o cadastro e o XML do mesmo chassi. Se a origem estiver em kg e o XML registrar 1250.0000 no campo do veículo, falta a conversão na hipótese do exemplo. Se a origem já estiver em toneladas e o integrador dividir por 1000 novamente, ocorrerá erro no sentido inverso. A unidade precisa acompanhar o dado durante todo o mapeamento.

Se o problema for tamanho, confirme medida, unidade e precisão antes de cortar caracteres. Se a fonte estiver ausente, obtenha o peso oficial em vez de usar zero ou o PBT. Corrija a causa demonstrada e confira novamente estrutura e conteúdo. Mensagem 736 limita o grupo por modelo/DANFE, não diagnostica peso líquido. Validação XSD não comprova o peso real nem define capacidade legal de carga.

Campos relacionados

Fontes oficiais

Referência técnica para integração

XPath completo
/nfeProc/NFe/infNFe/det/prod/veicProd/pesoL
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