Skip to main content
TransportOperatorRoute define quais rotas um TransportOperator pode operar dentro de uma Cooperative.

Campos

CampoTipoDescrição
transportOperatorRouteIdUUIDIdentificador único
cooperativeIdUUIDCooperativa da autorização
transportOperatorIdUUIDPermissionário autorizado
routeIdUUIDRota autorizada
statusTransportOperatorRouteStatusStatus da autorização
approvedByUUID?Usuário que aprovou a autorização
approvedAtDateTime?Data da aprovação
rejectionReasonString?Motivo da rejeição, quando aplicável
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

  • Relaciona-se com Cooperative por cooperativeId.
  • Relaciona-se com TransportOperator por transportOperatorId.
  • Relaciona-se com Route por routeId.
  • Relaciona-se indiretamente com Trip quando a Trip usa o mesmo transportOperatorId e routeId.

Regras de Negócio

  • Não aprova a rota em si. A rota é aprovada em RouteApproval.
  • Autoriza um permissionário a operar uma rota já aprovada.
  • O par transportOperatorId + routeId deve ser único enquanto o vínculo estiver ativo.
  • cooperativeId deve ser o mesmo da Route e do TransportOperator.
  • Uma Trip só pode iniciar se existir autorização ACTIVE para o par transportOperatorId + routeId.
  • A aprovação pode ser feita por MOB/BKO ou por fluxo administrativo equivalente, conforme permission de Authorization.

Enums

TransportOperatorRouteStatus

ValorDescrição
PENDING_APPROVALAutorização solicitada e aguardando análise
ACTIVEPermissionário autorizado a operar a rota
REJECTEDAutorização rejeitada
SUSPENDEDAutorização temporariamente suspensa
EXPIREDAutorização encerrada por prazo ou regra administrativa

Example

{
  "transportOperatorRouteId": "01980d34-4a94-76ef-b826-5c77dc16ca49",
  "cooperativeId": "0197a800-24e6-76a2-90ed-ff0f6fba7b0c",
  "transportOperatorId": "01980d30-6a3c-7a42-9182-17ad6324d3aa",
  "routeId": "0197a80c-4204-7b77-9005-48cc23677587",
  "status": "ACTIVE",
  "approvedBy": "0197a806-7a50-7d8d-b2ea-07748f4e38f7",
  "approvedAt": "2026-07-03T15:45:00.000Z",
  "rejectionReason": null,
  "createdBy": "0197a805-0910-7eb2-bae7-90a13df2a9b2",
  "createdAt": "2026-07-03T15:35:00.000Z",
  "updatedBy": "0197a806-7a50-7d8d-b2ea-07748f4e38f7",
  "updatedAt": "2026-07-03T15:45:00.000Z",
  "deletedBy": null,
  "deletedAt": null
}