Skip to main content
TransportOperatorRoutePolicy reúne o limite de viagens e o subsídio por quilômetro aplicáveis a um permissionário em uma rota durante uma única vigência.

Dados gerais

CampoUso
transportOperatorIdPermissionário sujeito à política.
routeIdRota em que a política é aplicada.
startAtInício da vigência.
endAtFim da vigência.

Subsídio

valor do subsídio = distância auditada * subsidyAmountPerKm
distanceSource define se a distância vem da rota planejada, GPS, hodômetro ou auditoria combinada.

Limite operacional

tripLimit define quantas viagens o permissionário pode executar na rota durante a vigência.
MomentoEfeito
Trip SCHEDULEDNão consome limite definitivo.
Trip IN_PROGRESSPode reservar uma vaga.
Trip COMPLETEDConsome uma vaga e pode gerar subsídio.
Trip CANCELLEDLibera a reserva quando ainda não concluída.

Regras

  • O escopo é sempre transportOperatorId + routeId + vigência.
  • Vigências do mesmo permissionário e rota não podem se sobrepor.
  • A mesma política governa o limite operacional e a apuração financeira.
  • Apenas Trips dentro da vigência são elegíveis.
  • O consumo do limite deve ser idempotente por Trip.
  • A apuração fica em TransportOperatorSubsidySettlement.
  • A geração do fechamento é feita por Transport Operator Subsidy Settlement Generation.
Veja a entidade em TransportOperatorRoutePolicy.