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

# Surpresas: brindes e descontos por ciclos para reter assinantes

> Crie regras que premiam ciclos específicos de uma assinatura com produtos de brinde ou um desconto de uma única vez, para reduzir o churn e premiar a lealdade.

**Surpresas** premia os seus assinantes em ciclos específicos: um produto de brinde que vai de graça no pedido daquele ciclo, um desconto de uma única vez naquela cobrança, ou os dois. As regras são administradas em **Apps → Reval → Surpresas**.

## Criar uma regra

<Steps>
  <Step title="Nome">
    Um nome interno que diga o que a regra faz, ex.: "Brinde no 2º pedido".
  </Step>

  <Step title="Disparador">
    Quando a regra é disparada:

    * **Número de pedido específico** — o ciclo N da assinatura (ex.: a 3ª cobrança). Com **Aplicar por cliente** ativado, a contagem soma os pedidos de *todas* as assinaturas do cliente e a recompensa é concedida **uma única vez por cliente**; desativado, a contagem é por assinatura e a recompensa é concedida uma vez por assinatura.
    * **Sequência de pedidos** — N ciclos seguidos sem interrupção. A sequência é quebrada se passar mais de 1,5× a frequência do plano sem um pedido: uma pausa longa ou uma cobrança que não foi recuperada a reiniciam; uma pausa breve retomada em tempo a mantém.
  </Step>

  <Step title="Recompensa">
    Pelo menos uma das duas (podem ser combinadas):

    * **Desconto** — percentual ou valor fixo sobre **os produtos daquela única cobrança** (o frete não recebe desconto; o imposto é recalculado). Aplica-se a partir do **pedido 2** em diante: para dar desconto no primeiro pedido existe o desconto de primeira compra do plano.
    * **Brindes** — um ou mais produtos/variantes do catálogo que são adicionados **a custo R\$ 0** ao pedido daquele ciclo.
  </Step>

  <Step title="Condição (opcional)">
    Status da assinatura que devem ser atendidos no momento de aplicar: **Ativa**, ou **Cobrança falhada** (o ciclo vinha de uma recusa e foi recuperado). É atendida por qualquer um dos marcados; sem marcar nenhum, aplica-se sempre.

    As condições são avaliadas no momento da cobrança, então não existe a opção "Pausada": uma assinatura pausada tem o débito pausado no Mercado Pago e não gera cobranças.
  </Step>
</Steps>

<Note>
  Se um cliente atende aos critérios de **várias regras no mesmo ciclo**, **todas** as recompensas são aplicadas naquele pedido.
</Note>

## Como são aplicadas

* **Brindes**: são somados como linhas a R\$ 0 ao pedido da Shopify do ciclo que disparou a regra. O estoque do brinde segue a mesma lógica de inventário configurada para aquele produto — com uma exceção deliberada: um brinde sem estoque **nunca retém** o pedido pago; ele é omitido (fica registrado nos logs) e o pedido sai de todo modo. Se o brinde foi omitido, a recompensa **não** é contada como aplicada nem é comunicada ao cliente, e a regra pode premiá-lo em um ciclo posterior.
* **Descontos**: como o Mercado Pago cobra o valor recorrente antecipadamente, o desconto é **preparado um ciclo antes** (o valor do débito é reduzido para aquela cobrança e restaurado automaticamente depois). O pedido da Shopify daquele ciclo é emitido com os preços com desconto, então o pedido e a cobrança coincidem. Se o valor com desconto ficasse abaixo do mínimo do Mercado Pago, a regra é omitida e isso fica registrado.
* Cada recompensa entregue fica contada na regra ("Aplicada N vezes") e emite o evento **"Surpresa aplicada"** para o Klaviyo / Shopify Flow — você pode montar um e-mail de aviso, ou não comunicar nada e fazer com que seja uma surpresa de verdade. O aviso do brinde sai quando o pedido que o leva foi criado, e não antes.

<Warning>
  Editar ou excluir uma regra não afeta recompensas já aplicadas, nem os brindes de um pedido que ainda espera estoque. Pausar uma regra (botão "Pausar") a desativa sem perder o histórico dela.
</Warning>

<Note>
  Se você mudar o preço de uma assinatura (troca de produto, quantidade ou atualização em massa de preços) enquanto ela tinha um desconto preparado, o desconto é cancelado: o seu preço novo prevalece. A regra pode voltar a prepará-lo em um ciclo posterior.
</Note>