TransportOperator

​

Campos

​

Relacionamentos

• Relaciona-se com Cooperative por cooperativeId.
• Relaciona-se com múltiplos TransportOperatorRoute.
• Relaciona-se com múltiplas TransportOperatorRoutePolicy por transportOperatorId.
• Relaciona-se com múltiplos DriverTransportOperator.
• Relaciona-se com múltiplos VehicleTransportOperator.
• Relaciona-se com múltiplas Trip.
• Relaciona-se com múltiplas TripReview.
• Relaciona-se com múltiplos CashSettlement originados por vendas nas suas Trips.

​

Regras de Negócio

• Representa o permissionário: quem tem autorização operacional para executar transporte dentro da cooperativa.
• Pode representar pessoa física, MEI ou empresa permissionária, conforme regra do negócio.
• Não é o mesmo que User: usuários acessam o sistema; o TransportOperator recebe autorização, bloqueio, cota, subsídio e auditoria operacional.
• Não é o mesmo que Driver: motorista dirige uma Trip; TransportOperator é o titular autorizado da operação.
• A relação principal é Cooperative 1:N TransportOperator.
• Um TransportOperator só pode operar uma rota se existir TransportOperatorRoute ativo.
• A materialização e o start da Trip devem bloquear operação quando status = BLOCKED ou regularityStatus = IRREGULAR.
• Limite de viagens e subsídio são configurados em uma TransportOperatorRoutePolicy por rota e vigência.

​

Enums

​

TransportOperatorStatus

​

TransportOperatorRegularityStatus

​

Example

{
  "transportOperatorId": "01980d30-6a3c-7a42-9182-17ad6324d3aa",
  "cooperativeId": "0197a800-24e6-76a2-90ed-ff0f6fba7b0c",
  "legalName": "João Silva Transportes Ltda",
  "tradeName": "Silva Transportes",
  "document": "12345678000190",
  "documentType": "CNPJ",
  "status": "ACTIVE",
  "regularityStatus": "REGULAR",
  "blockedReason": null,
  "approvedBy": "0197a806-7a50-7d8d-b2ea-07748f4e38f7",
  "approvedAt": "2026-07-03T15:00:00.000Z",
  "createdBy": "0197a805-0910-7eb2-bae7-90a13df2a9b2",
  "createdAt": "2026-07-03T14:30:00.000Z",
  "updatedBy": "0197a806-7a50-7d8d-b2ea-07748f4e38f7",
  "updatedAt": "2026-07-03T15:00:00.000Z",
  "deletedBy": null,
  "deletedAt": null
}