pesoL na NF-e: peso líquido do veículo em toneladas
<pesoL>det › prod › veicProd › pesoLRevisã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
- Diferença para o campo de volumes
- Exemplo com medida documentada em kg
- Como investigar diferença de mil vezes
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
- MOC 7.0, Anexo I — 7.00, novembro de 2020: p. 22: grupo JA, campo J08 (pesoL); 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/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