Skip to main content
TransportOperatorSubsidyRule define quanto um permissionário recebe por quilômetro executado e auditado.

​
Campos

CampoTipoDescrição
transportOperatorSubsidyRuleIdUUIDIdentificador único
cooperativeIdUUIDCooperativa da regra
transportOperatorIdUUIDPermissionário contemplado
routeIdUUID?Rota específica, quando a regra for por rota
amountPerKmIntValor por quilômetro em centavos
distanceSourceSubsidyDistanceSourceFonte usada para calcular a distância subsidiada
startsAtDateTimeInício da vigência
endsAtDateTime?Fim da vigência
statusTransportOperatorSubsidyRuleStatusStatus da regra
createdByUUID?Usuário que criou o registro, quando aplicável
createdAtDateTimeData de criação
updatedByUUID?Usuário que fez a última atualização, quando aplicável
updatedAtDateTimeData da última atualização
deletedByUUID?Usuário que removeu o registro, quando aplicável
deletedAtDateTime?Data de remoção

​
Relacionamentos

​
Regras de Negócio

  • A regra pode ser geral para o permissionário ou específica para uma rota.
  • Quando existir regra específica para a rota, ela tem prioridade sobre a regra geral do permissionário.
  • O subsídio só é calculado para Trip concluída e auditada.
  • A distância subsidiada deve vir da fonte definida em distanceSource.
  • O valor é armazenado em centavos por quilômetro.
  • Exemplo: amountPerKm = 200 representa R$ 2,00 por km.

​
Enums

​
SubsidyDistanceSource

ValorDescrição
PLANNED_ROUTEUsa Route.distanceKm aprovado
GPS_AUDITEDUsa distância auditada por GPS
ODOMETER_AUDITEDUsa distância auditada por hodômetro
COMBINED_AUDITUsa regra combinada entre rota, GPS e hodômetro

​
TransportOperatorSubsidyRuleStatus

ValorDescrição
ACTIVERegra ativa
INACTIVERegra inativa
EXPIREDRegra vencida

​
Example

{
  "transportOperatorSubsidyRuleId": "01980d36-4381-7c81-8786-230f12cb35c0",
  "cooperativeId": "0197a800-24e6-76a2-90ed-ff0f6fba7b0c",
  "transportOperatorId": "01980d30-6a3c-7a42-9182-17ad6324d3aa",
  "routeId": "0197a80c-4204-7b77-9005-48cc23677587",
  "amountPerKm": 200,
  "distanceSource": "COMBINED_AUDIT",
  "startsAt": "2026-07-01T00:00:00.000Z",
  "endsAt": null,
  "status": "ACTIVE",
  "createdBy": "0197a805-0910-7eb2-bae7-90a13df2a9b2",
  "createdAt": "2026-07-01T09:30:00.000Z",
  "updatedBy": "0197a805-0910-7eb2-bae7-90a13df2a9b2",
  "updatedAt": "2026-07-01T09:30:00.000Z",
  "deletedBy": null,
  "deletedAt": null
}