dist na NF-e: distância entre eixos e limites de preenchimento

dist representa a distância entre eixos do veículo novo no grupo veicProd. O campo identifica uma característica dimensional do veículo; não é a distância de transporte da mercadoria, o trajeto de entrega nem a distância usada para calcular frete.

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

• O que o leiaute define e o que precisa ser confirmado
• Aplicação e localização do campo
• Exemplo apenas da estrutura
• Roteiro de conferência antes de gerar

O que o leiaute define e o que precisa ser confirmado

O MOC 7.0 identifica J14 como distância entre eixos, com tamanho de um a quatro caracteres. A declaração do XSD 010f mantém TString com esse limite. Essas duas fontes não indicam de forma inequívoca a unidade material a usar nesta tag nem uma escala decimal associada a ela.

Por isso não é seguro concluir que 2700 significa milímetros ou que 2.7 deve ser enviado em metros apenas porque cabe no campo. Tamanho de string não define unidade. Uma especificação do fabricante com medida e unidade permite saber qual é a dimensão física, mas a correspondência com a representação exigida pelo contrato de emissão ainda precisa ser confirmada na documentação técnica aplicável.

Esta limitação tem consequência prática: quando a unidade do cadastro e a do contrato não estiverem comprovadas, o próximo passo é confirmar esse mapeamento com o fornecedor da informação e o responsável técnico pelo emissor. Não converter, truncar ou preencher zero para superar a ausência do parâmetro.

Aplicação e localização 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.

Na sequência, dist vem depois de CMT e antes de anoMod. O valor deve corresponder à configuração real do veículo vinculado ao chassi, não a outra versão com entre-eixos diferente. Um mesmo nome comercial pode cobrir configurações dimensionais distintas.

Exemplo apenas da estrutura

O elemento abaixo é sintético e ilustra exclusivamente o limite estrutural de quatro caracteres:

<dist xmlns="http://www.portalfiscal.inf.br/nfe">2700</dist>

Não se atribui uma unidade física a 2700 neste exemplo. Ele não serve como recomendação de preenchimento ou prova de adequação material. Os demais filhos obrigatórios foram omitidos; o recorte não constitui grupo completo nem nota pronta para envio.

Roteiro de conferência antes de gerar

1. Identifique chassi, versão e configuração dimensional do veículo.
2. Obtenha a distância entre eixos e sua unidade na especificação técnica correspondente.
3. Confira a unidade e a escala usadas pela coluna do cadastro e pelo mapeamento do emissor. Registre a fonte que comprova a correspondência; não use apenas um XML anterior como autoridade.
4. Depois de confirmado o contrato, verifique o conteúdo gerado e o limite de um a quatro caracteres. Se exceder, investigue unidade, dado e mapeamento antes de qualquer transformação.

Se a mensagem apontar posição ou comprimento, confira estrutura e serialização. Se apontar 736, examine modelo e tpImp, pois a restrição é do grupo. Aprovação do XSD não resolve a unidade faltante nem comprova a dimensão real. A decisão sobre tributação do veículo permanece fora desta conferência dimensional.

Campos relacionados

• Grupo de veículo novo

Fontes oficiais

• MOC 7.0, Anexo I — 7.00, novembro de 2020: p. 22: grupo JA, campo J14 (dist); p. 96 J01-10, complementada pela NT 2026.002.
• 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.