TransportOperatorQuotaUsage

​

Campos

​

Relacionamentos

• Relaciona-se com TransportOperatorRoutePolicy por transportOperatorRoutePolicyId.
• Relaciona-se com Cooperative por cooperativeId.
• Relaciona-se com TransportOperator por transportOperatorId.
• Relaciona-se com Route por routeId.
• Relaciona-se com Trip por tripId.

​

Regras de Negócio

• RESERVE é criado quando uma Trip entra em IN_PROGRESS.
• CONSUME é criado quando uma Trip entra em COMPLETED.
• RELEASE é criado quando uma Trip reservada é cancelada antes de consumir cota definitiva.
• idempotencyKey deve ser única para transportOperatorRoutePolicyId + tripId + type.
• A mesma Trip não pode consumir a mesma cota mais de uma vez.
• Movimentos são append-only. Correções devem criar novo movimento compensatório.

​

Enums

​

TransportOperatorQuotaUsageType

​

TransportOperatorQuotaUsageStatus

​

Example

{
  "transportOperatorQuotaUsageId": "01980d35-f7cd-79e0-9e2a-b2a974a61d52",
  "transportOperatorRoutePolicyId": "01980d36-4381-7c81-8786-230f12cb35c0",
  "cooperativeId": "0197a800-24e6-76a2-90ed-ff0f6fba7b0c",
  "transportOperatorId": "01980d30-6a3c-7a42-9182-17ad6324d3aa",
  "routeId": "0197a80c-4204-7b77-9005-48cc23677587",
  "tripId": "0197a80f-2d8f-7710-b243-b67fb477a1c0",
  "type": "CONSUME",
  "status": "APPLIED",
  "periodStart": "2026-07-01T00:00:00.000Z",
  "periodEnd": "2026-07-31T23:59:59.999Z",
  "idempotencyKey": "policy-consume-01980d36-4381-7c81-8786-230f12cb35c0-0197a80f-2d8f-7710-b243-b67fb477a1c0",
  "createdBy": "0197a805-0910-7eb2-bae7-90a13df2a9b2",
  "createdAt": "2026-07-04T12:30:00.000Z"
}