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

# Promotion Status Sweep

> Rotina que expira promoções fora da janela de validade

Promotion Status Sweep é a rotina periódica que mantém promoções alinhadas ao fim da validade configurada.

## Objetivo

A rotina usa `endsAt` e `status` de [Promotional](/data-modelling/promotion/promotional) para impedir que campanhas vencidas continuem ativas.

## Execução

Ao rodar, a rotina:

1. Busca promoções com `status = ACTIVE`.
2. Filtra promoções com `endsAt` preenchido e vencido.
3. Atualiza `status` para `EXPIRED`.

## Regras

| Regra        | Comportamento                                                            |
| ------------ | ------------------------------------------------------------------------ |
| Expiração    | `endsAt` vencido encerra promoção ativa.                                 |
| Início       | `startsAt` continua sendo validado no catálogo e no checkout.            |
| Publicação   | A rotina não publica promoções `DRAFT` nem reativa promoções `INACTIVE`. |
| Histórico    | Aplicações já registradas em PromotionalUsageHistory permanecem válidas. |
| Idempotência | Promoções já expiradas são ignoradas.                                    |