vagao na NF-e: identificação ferroviária e rejeição 758

vagao contém a identificação do vagão no grupo de transporte da NF-e. O caminho é /nfeProc/NFe/infNFe/transp/vagao, com a grafia XML sem acento. Ele não informa a quantidade de vagões do trem, o nome da ferrovia ou a numeração dos volumes carregados.

A informação deve vir da identificação logística do vagão pertinente ao documento. Não use o número do lote de mercadorias ou do contêiner como substituto sem confirmar o que ele identifica na operação.

Um campo textual numa alternativa de transporte

O MOC X25a prevê texto de 1 a 20 caracteres e até uma ocorrência. O campo não é exclusivamente numérico. O schema PL_010c o coloca numa escolha entre a sequência rodoviária de veículo/reboques, vagao e balsa. A opcionalidade isolada não permite somar todas as alternativas. MOC, p.61.

Se um transporte combina ferrovia e rodovia, sua descrição logística não autoriza inserir veicTransp e vagao na mesma escolha. É necessário confirmar o modo de representação aplicável àquele documento e os registros da operação. O campo não determina obrigações adicionais de documentos de transporte.

O limite de uma ocorrência também não muda porque a composição ferroviária possui vários vagões. Não repita a tag ou concatene arbitrariamente identificadores para exceder a capacidade do leiaute. Quando a identificação disponível envolve mais de uma unidade, a representação precisa ser confirmada com a documentação e o contexto antes da geração.

Exemplo com identificação alfanumérica

Fragmento parcial e sintético, não pronto para transmissão. A hipótese é uma NF-e em contexto que admite a alternativa ferroviária e cujo identificador logístico demonstrativo é VAGAO-ALFA-01:

<transp xmlns="http://www.portalfiscal.inf.br/nfe">
  <modFrete>0</modFrete>
  <vagao>VAGAO-ALFA-01</vagao>
</transp>

A modalidade 0 descreve contratação por conta do remetente na hipótese; não é um código para ferrovia. A identificação vem depois dos blocos anteriores de transporte que existirem e antes dos volumes. O hífen do texto do vagão não deve ser confundido com o padrão da placa rodoviária, que é outro campo e outro tipo.

Uma tag vazia ou formada só por espaços não identifica o vagão. No tipo TString, confira também caracteres e espaços nas extremidades; não corte um identificador verdadeiro para caber sem confirmar sua representação.

Quando o grupo causa rejeição 758

X25a-10 do MOC prevê 758 para NFC-e com vagao. A NT 2026.002 v1.10a, p.19 inclui NF-e com DANFE Simplificado Tipo 2 (tpImp=6). O conjunto de transporte está na linha de cronograma com teste em 01/07/2026 e produção em 03/08/2026; isso não comprova implantação consultada em cada UF.

A permissão de frete em entrega em domicílio não libera vagão nesses documentos. O indicador de presença e a vedação do meio de transporte são verificações diferentes. Trocar o identificador do vagão não resolve a presença proibida do campo.

Conferência por tipo de problema

Se houve falha de schema, veja nome da tag, texto vazio, limite de vinte caracteres, ordem e alternativas concorrentes. Uma segunda ocorrência de vagao, ou um trecho de veículo junto dele, é um problema estrutural mesmo com identificadores reais.

Se o retorno foi 758, confira modelo e tpImp no XML enviado e por que a geração incluiu o campo. Se o XML foi aceito, ainda compare o identificador com o registro logístico: schema e autorização não provam correspondência física do vagão.

Corrija apenas a origem ou a geração comprovadamente incorreta. Não altere o modelo, o tipo de impressão ou os fatos do transporte por tentativa de autorização; não edite XML assinado. Para dúvida sobre documento ou representação de operação multimodal, leve a composição e os documentos ao responsável fiscal. Veja balsa para a outra alternativa e transp para os demais blocos.