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

# Sorpresas: regalos y descuentos por ciclos para retener suscriptores

> Creá reglas que premian ciclos específicos de una suscripción con productos de regalo o un descuento por única vez, para reducir el churn y premiar la lealtad.

**Sorpresas** premia a tus suscriptores en ciclos específicos: un producto de regalo que viaja gratis en el pedido de ese ciclo, un descuento por única vez en ese cobro, o ambos. Las reglas se administran en **Apps → Reval → Sorpresas**.

## Crear una regla

<Steps>
  <Step title="Nombre">
    Un nombre interno que te diga qué hace, ej. «Regalo en el 2do pedido».
  </Step>

  <Step title="Activador">
    Cuándo se dispara la regla:

    * **Número de pedido específico** — el ciclo N de la suscripción (ej. el 3er cobro). Con **Aplicar por cliente** activado, el conteo suma los pedidos de *todas* las suscripciones del cliente y la recompensa se otorga **una sola vez por cliente**; apagado, cuenta por suscripción y se otorga una vez por suscripción.
    * **Racha de pedidos** — N ciclos seguidos sin interrupción. La racha se corta si pasa más de 1,5× la frecuencia del plan sin un pedido: una pausa larga o un cobro que no se recuperó la reinician; una pausa breve que se reanuda a tiempo la mantiene.
  </Step>

  <Step title="Recompensa">
    Al menos una de las dos (pueden combinarse):

    * **Descuento** — porcentaje o monto fijo sobre **los productos de ese único cobro** (el envío no se descuenta; el impuesto se recalcula). Aplica desde el **pedido 2** en adelante: para descontar el primer pedido está el descuento de primera compra del plan.
    * **Regalos** — uno o más productos/variantes del catálogo que se agregan **a costo \$0** al pedido de ese ciclo.
  </Step>

  <Step title="Condición (opcional)">
    Estados de la suscripción que deben cumplirse al momento de aplicar: **Activa**, o **Cobro fallido** (el ciclo venía de un rechazo y se recuperó). Se cumple con cualquiera de los marcados; sin marcar, aplica siempre.

    Las condiciones se evalúan en el momento del cobro, así que no hay opción «Pausada»: una suscripción pausada tiene el débito pausado en Mercado Pago y no genera cobros.
  </Step>
</Steps>

<Note>
  Si un cliente cumple los criterios de **varias reglas en el mismo ciclo**, se aplican **todas** las recompensas en ese pedido.
</Note>

## Cómo se aplican

* **Regalos**: se suman como líneas a \$0 al pedido de Shopify del ciclo que disparó la regla. El stock del regalo sigue la misma lógica de inventario configurada para ese producto — con una excepción deliberada: un regalo sin stock **nunca retiene** el pedido pagado; se omite (queda registrado en los logs) y el pedido sale igual. Si el regalo se omitió, la recompensa **no** se cuenta como aplicada ni se avisa al cliente, y la regla puede premiarlo en un ciclo posterior.
* **Descuentos**: como Mercado Pago cobra el monto recurrente por adelantado, el descuento se **prepara un ciclo antes** (se baja el monto del débito para ese cobro y se restaura automáticamente después). El pedido de Shopify de ese ciclo se emite con los precios descontados, así que el pedido y el cobro coinciden. Si el monto descontado quedara por debajo del mínimo de Mercado Pago, la regla se omite y queda registrado.
* Cada recompensa entregada queda contada en la regla («Aplicada N veces») y emite el evento **«Sorpresa aplicada»** hacia Klaviyo / Shopify Flow — podés armar un email de aviso, o no comunicar nada y que sea una sorpresa de verdad. El aviso del regalo sale cuando el pedido que lo lleva se creó, no antes.

<Warning>
  Editar o eliminar una regla no afecta recompensas ya aplicadas, ni los regalos de un pedido que todavía espera stock. Pausar una regla (botón «Pausar») la desactiva sin perder su historial.
</Warning>

<Note>
  Si cambiás el precio de una suscripción (cambio de producto, cantidad o actualización masiva de precios) mientras tenía un descuento preparado, el descuento se cancela: manda tu precio nuevo. La regla puede volver a prepararlo en un ciclo posterior.
</Note>