TransportOperatorSubsidySettlement

​

Campos

​

Relacionamentos

• Relaciona-se com Cooperative por cooperativeId.
• Relaciona-se com TransportOperator por transportOperatorId.
• Relaciona-se com Route por routeId, quando aplicável.
• Relaciona-se com Trip por tripId, quando o fechamento for unitário.
• Relaciona-se com TransportOperatorRoutePolicy por transportOperatorRoutePolicyId.

​

Regras de Negócio

• O fechamento só considera trips COMPLETED e auditadas.
• O cálculo usa auditedDistanceKm * amountPerKm.
• Quando a política usar PLANNED_ROUTE, auditedDistanceKm normalmente replica Route.distanceKm.
• Quando a regra usar GPS, hodômetro ou auditoria combinada, divergências podem deixar o fechamento em UNDER_REVIEW.
• O fechamento pode ser unitário por Trip ou consolidado por período.
• Fechamentos aprovados não devem ser recalculados silenciosamente; ajustes devem gerar novo fechamento ou revisão auditável.
• Somente fechamentos APPROVED podem ser marcados como PAID.
• Marcar como pago preenche paidBy e paidAt na mesma operação que altera o status.

​

Enums

​

TransportOperatorSubsidySettlementStatus

​

Example

{
  "transportOperatorSubsidySettlementId": "01980d37-a8dc-755a-8a7c-27372a096a7b",
  "cooperativeId": "0197a800-24e6-76a2-90ed-ff0f6fba7b0c",
  "transportOperatorId": "01980d30-6a3c-7a42-9182-17ad6324d3aa",
  "routeId": "0197a80c-4204-7b77-9005-48cc23677587",
  "tripId": "0197a80f-2d8f-7710-b243-b67fb477a1c0",
  "transportOperatorRoutePolicyId": "01980d36-4381-7c81-8786-230f12cb35c0",
  "periodStart": "2026-07-04T08:00:00.000Z",
  "periodEnd": "2026-07-04T12:30:00.000Z",
  "tripCount": 1,
  "auditedDistanceKm": 18.0,
  "amountPerKm": 200,
  "grossAmount": 3600,
  "status": "APPROVED",
  "approvedBy": "0197a806-7a50-7d8d-b2ea-07748f4e38f7",
  "approvedAt": "2026-07-04T14:00:00.000Z",
  "paidBy": null,
  "paidAt": null,
  "createdBy": "0197a805-0910-7eb2-bae7-90a13df2a9b2",
  "createdAt": "2026-07-04T13:30:00.000Z",
  "updatedBy": "0197a806-7a50-7d8d-b2ea-07748f4e38f7",
  "updatedAt": "2026-07-04T14:00:00.000Z"
}