> ## 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 Subsidy Settlement Generation

> Rotina que gera apurações de subsídio por quilômetro

Transport Operator Subsidy Settlement Generation é a rotina periódica que apura subsídios de permissionários a partir de viagens concluídas.

## Objetivo

A rotina transforma regras de subsídio por quilômetro em registros conciliáveis de apuração.

## Execução

Ao rodar, a rotina:

1. Busca Trips `COMPLETED` ainda não apuradas.
2. Localiza a [TransportOperatorSubsidyRule](/data-modelling/operations/transport-operator-subsidy-rule) aplicável por permissionário, rota e período.
3. Calcula o valor bruto usando `Route.distanceKm` e o valor por quilômetro.
4. Cria ou atualiza [TransportOperatorSubsidySettlement](/data-modelling/billing/transport-operator-subsidy-settlement).

## Regras

| Regra           | Comportamento                                                                  |
| --------------- | ------------------------------------------------------------------------------ |
| Base de cálculo | Usa a distância da Route completa.                                             |
| Elegibilidade   | Apenas Trips concluídas entram na apuração.                                    |
| Vigência        | A regra precisa estar ativa no período da Trip.                                |
| Idempotência    | A mesma Trip não pode gerar subsídio duplicado.                                |
| Ajustes         | Correções devem ser registradas como ajuste de settlement, não como nova Trip. |