Skip to main content

​
Campos

CampoTipoDescrição
transportOperatorIdUUIDIdentificador único
cooperativeIdUUIDCooperativa responsável pelo permissionário
legalNameStringNome legal do permissionário
tradeNameString?Nome fantasia, quando existir
documentStringDocumento normalizado
documentTypeDocumentTypeTipo do documento
statusTransportOperatorStatusStatus cadastral e operacional
regularityStatusTransportOperatorRegularityStatusSituação de regularidade para operação
blockedReasonString?Motivo do bloqueio, quando aplicável
approvedByUUID?Usuário que aprovou o permissionário
approvedAtDateTime?Data de aprovação
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

  • 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.
  • Cotas e subsídios são configurados por TransportOperator e, quando aplicável, por rota/período.

​
Enums

​
TransportOperatorStatus

ValorDescrição
PENDING_APPROVALCadastro criado e aguardando análise
ACTIVEPermissionário ativo
INACTIVEPermissionário inativo para novas operações
BLOCKEDPermissionário bloqueado operacionalmente
REJECTEDCadastro rejeitado

​
TransportOperatorRegularityStatus

ValorDescrição
PENDING_REVIEWRegularidade ainda em análise
REGULARApto a operar, respeitando demais regras
IRREGULARIrregular; operação deve ser bloqueada

​
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
}