> ## 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.

# Overview

> Promoções de Company com catálogo para descoberta e regras fixas para validação no checkout.

Promotion controla promoções comerciais criadas por uma Company. A promoção pertence à Company e só pode ser aplicada em compras dessa mesma Company.

## Conceitos

<CardGroup cols={2}>
  <Card title="Promotional Rules" icon="tags" href="/domain/promotion/promotional-rules">
    Regras por rota, ida e volta, quantidade de tickets e baixa demanda.
  </Card>

  <Card title="Data Modelling" icon="database" href="/data-modelling/promotion/promotional">
    Entidades Promotional, regras fixas e histórico de uso.
  </Card>
</CardGroup>

## Regras gerais

* A Company é dona da promoção.
* A promoção tem dados de catálogo para exibição antes do checkout.
* Exibir uma promoção não garante aplicação.
* A aplicação final depende da validação no checkout.
* Cada promoção tem exatamente um tipo.
* Cada promoção deve ter exatamente uma regra ativa compatível com o tipo.
* Cada aplicação confirmada gera histórico.

## Tipos

| Tipo              | Uso                                           |
| ----------------- | --------------------------------------------- |
| `ROUTE`           | Promoção para tickets de uma rota específica. |
| `ROUND_TRIP`      | Promoção para compra de ida e volta.          |
| `MULTI_TICKET`    | Promoção por quantidade de passagens.         |
| `LOW_DEMAND_TIME` | Promoção para dias/horários de menor demanda. |

## Fronteiras

* Promotion é campanha comercial.
* Benefits cobre gratuidades e descontos tarifários por elegibilidade.
* Credit Grant é meio de pagamento interno.
* Sales aplica a promoção durante checkout e emissão.
