> ## Documentation Index
> Fetch the complete documentation index at: https://docs.devmob.app.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Transport Operator Route Policies

> Política operacional e financeira de um permissionário em uma rota.

`TransportOperatorRoutePolicy` reúne o limite de viagens e o subsídio por quilômetro aplicáveis a um permissionário em uma rota durante uma única vigência.

## Dados gerais

| Campo                 | Uso                                |
| --------------------- | ---------------------------------- |
| `transportOperatorId` | Permissionário sujeito à política. |
| `routeId`             | Rota em que a política é aplicada. |
| `startAt`             | Início da vigência.                |
| `endAt`               | Fim da vigência.                   |

## Subsídio

```text theme={null}
valor do subsídio = distância auditada * subsidyAmountPerKm
```

`distanceSource` define se a distância vem da rota planejada, GPS, hodômetro ou auditoria combinada.

## Limite operacional

`tripLimit` define quantas viagens o permissionário pode executar na rota durante a vigência.

| Momento            | Efeito                                       |
| ------------------ | -------------------------------------------- |
| Trip `SCHEDULED`   | Não consome limite definitivo.               |
| Trip `IN_PROGRESS` | Pode reservar uma vaga.                      |
| Trip `COMPLETED`   | Consome uma vaga e pode gerar subsídio.      |
| Trip `CANCELLED`   | Libera a reserva quando ainda não concluída. |

## Regras

* O escopo é sempre `transportOperatorId + routeId + vigência`.
* Vigências do mesmo permissionário e rota não podem se sobrepor.
* A mesma política governa o limite operacional e a apuração financeira.
* Apenas Trips dentro da vigência são elegíveis.
* O consumo do limite deve ser idempotente por Trip.
* A apuração fica em [TransportOperatorSubsidySettlement](/data-modelling/billing/transport-operator-subsidy-settlement).
* A geração do fechamento é feita por [Transport Operator Subsidy Settlement Generation](/scheduler/transport-operator-subsidy-settlement-generation).

Veja a entidade em [TransportOperatorRoutePolicy](/data-modelling/operations/transport-operator-route-policy).