2025-08-19 DLOGPORTOS-22153 | API Recintos | Agendamento de veículos ferroviários

01. DADOS GERAIS

02. SITUAÇÃO/REQUISITO

Na entrada em produção da release VOLGA da API RECINTOS, o evento de agendamento/acesso de veículos para o modal ferroviário passou a consistir o maquinista em eventos que eram enviado a apenas o vagão. Na primeira versão da integração, o sistema TLRA envia um evento de agendamento / entrada por vagão e o maquinista não era enviado.

Com a implementação da consistência na release Volga, o sistema TLRA deverá enviar um evento para toda a composição férrea, ou seja, um evento contendo a locomotiva, o maquinista e todos os vagões.

Para que isso seja possível, o processo ferroviário dentro do TLRA será obrigatório o uso da "Viagem Ferroviária" para o agendamento / entrada no recinto, desta forma permite a montagem da composição contendo a máquina e seus vagões. Também será obrigatório o registro da programação para a LOCOMOTIVA e também o controle da sua entrada no recinto.

Neste requisito, no módulo portaria, deverá ser alterado o "Transit-time" (agendamento ferroviário), para quando ocorrer a liberação da programação ferroviária vinculada a locomotiva, o sistema gere a pendência do agendamento para a API RECINTOS. Para a programação dos vagões não será mais necessário gerar pendências para envio, pois a locomotiva e seus vagões serão enviados em um único evento.

03. SOLUÇÃO

1. No módulo portaria, "transit-time", para o modal ferroviário, foram realizadas as seguintes implementações:
   1. Ao efetua a liberação de uma programação ferroviária para a locomotiva, o sistema gerará a pendência para envio a API RECINTOS referente ao agendamento ferroviário.
      
      Figura 1 | Registro e liberação de programações (agendamentos) | Módulo portaria Vs. 12.1.2507.21
      
      
2. No serviço EAIService, API Recintos, evento de agendamento de veículos, foi implementado as seguintes alterações na criação da mensagem:
   1. Considerar o número da locomotiva como placa.
   2. O Maquinista da locomotiva será enviado como motorista.
   3. Na lista de semirreboques, serão enviado os vagões pertencentes a mesma viagem ferroviária da locomotiva.

  
Figura 2 | Exemplo da mensagem JSON para o agendamento de veículos (modal ferroviário).

04. DEMAIS INFORMAÇÕES

Link de download direcionado para pacote consolidado da solução completa.

05. ASSUNTOS RELACIONADOS

Documento técnico agrupador do projeto:

API Recintos - Adequação para o modal ferroviário