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

# Cupones y descuentos en Nubea

> Cómo funcionan los cupones en Nubea: de dónde salen, cómo se crean en Tiendanube y se vinculan, qué ve el cliente y cómo se combinan (o no) con otros descuentos.

Nubea no crea cupones por su cuenta: **los cupones siempre se crean en tu
tienda** (Tiendanube o Shopify) y Nubea se encarga de **entregárselos al
visitante** en el momento justo. Esta guía explica de dónde salen los
cupones que ves en Nubea, cómo crearlos y vincularlos, qué ve el cliente
final y cómo se combinan (o no) con otros descuentos.

<Note>
  La regla más importante: **el código del cupón vive en tu tienda**. Nubea
  lo muestra, lo copia y lo recuerda — pero el descuento real lo valida y lo
  aplica Tiendanube en el checkout. Si el cupón no existe o está vencido en
  Tiendanube, el cliente "lo recibe" pero no funciona al pagar.
</Note>

***

## De dónde salen los cupones

En Nubea hay tres lugares desde donde un visitante puede recibir un cupón.
En los tres casos el código se crea antes en tu tienda.

<CardGroup cols={3}>
  <Card title="Ruleta de descuentos" icon="dharmachakra" href="/funcionalidades/ruleta">
    El visitante deja su email/teléfono, gira y "gana" un cupón aleatorio.
    Cada porción de la ruleta apunta a un cupón distinto.
  </Card>

  <Card title="Popup con cupón" icon="window-restore" href="/funcionalidades/popups">
    El popup clásico en formato "formulario con cupón": el visitante deja
    sus datos y recibe **un solo cupón fijo**.
  </Card>

  <Card title="Cupones propios" icon="tag">
    Los cupones que ya usás en tu tienda para campañas, fechas especiales
    o clientes específicos. Nubea los reutiliza como premio o incentivo.
  </Card>
</CardGroup>

<Info>
  La ruleta y el popup son **los dos formatos de la misma feature** (Campaña
  popup). Cambia la mecánica de entrega: el popup da un cupón fijo, la ruleta
  da uno aleatorio entre varios. Si todavía no elegiste cuál usar, mirá la
  [comparación en la guía de Popup
  →](/funcionalidades/popups#elegi-el-formato-popup-o-ruleta).
</Info>

***

## 1. Creá el cupón en tu tienda

Este es el paso que más se saltea — y el motivo número uno de "el cliente se
suscribe pero no ve nada para usar". **Primero creás el cupón en Tiendanube,
después lo vinculás en Nubea.**

<Steps>
  <Step title="Entrá a Cupones en Tiendanube" icon="ticket">
    En tu panel de Tiendanube, andá a **Marketing → Cupones de descuento** y
    hacé click en **Crear cupón**.
  </Step>

  <Step title="Definí el código y el descuento" icon="percent">
    Elegí un **código** fácil de leer (ej: `BIENVENIDA10`, `RULETA5`) y el
    tipo de descuento (porcentaje, monto fijo o envío gratis). Ese código
    es exactamente el que después vas a cargar en Nubea.
  </Step>

  <Step title="Ponele vigencia y condiciones" icon="clock">
    Configurá fecha de vencimiento, monto mínimo de compra o límite de usos
    si querés. Para cupones de captura, una vigencia corta (24-72h) suele
    convertir mejor.
  </Step>

  <Step title="Guardá y dejalo activo" icon="check">
    Guardá el cupón y asegurate de que quede **activo** en Tiendanube. Un
    cupón pausado o vencido no se aplica aunque Nubea lo muestre.
  </Step>
</Steps>

<Warning>
  El código que cargás en Nubea tiene que ser **idéntico** al de Tiendanube
  (mismas letras, mismos números, respetá mayúsculas si tu tienda las
  distingue). Si en Nubea ponés `RULETA5` pero en Tiendanube el cupón se
  llama `Ruleta-5`, el cliente copia un código que no existe.
</Warning>

***

## 2. Vinculá el cupón en Nubea

Una vez que el cupón existe en tu tienda, lo conectás según el formato que
estés usando.

### Activar los códigos de la ruleta

<Steps>
  <Step title="Abrí la configuración de premios" icon="dharmachakra">
    En tu panel de Nubea, en la campaña de **Ruleta**, andá a la sección de
    premios. Cada porción de la ruleta es un premio que necesita su cupón.
  </Step>

  <Step title="Cargá el código en cada premio" icon="ticket">
    En cada premio, pegá el **código del cupón** que creaste en Tiendanube
    (ej: la porción "10% off" lleva el cupón `RULETA10`). La ruleta no genera
    códigos: sólo muestra los que vos le cargás.
  </Step>

  <Step title="Ajustá las probabilidades y activá" icon="bolt">
    Repartí la probabilidad de cada premio (que sumen 100%) y prendé el
    toggle de la ruleta. Listo: cuando el visitante gane, va a ver el código
    asociado a esa porción.
  </Step>
</Steps>

<Note>
  Cada premio visible de la ruleta tiene que tener su código cargado y
  vigente en Tiendanube. Si una porción queda sin cupón, el visitante "gana"
  pero el código no funciona en el checkout. Mirá el detalle completo en la
  [guía de Ruleta de descuentos →](/funcionalidades/ruleta).
</Note>

### Vincular el cupón en el popup

<Steps>
  <Step title="Andá a la pestaña Cupón" icon="ticket">
    En la configuración del popup, abrí la pestaña **Cupón** y elegí uno de
    los cupones que tengas creados en tu tienda. Este es el cupón fijo que
    recibe todo el que se suscribe.
  </Step>

  <Step title="Mostrá el código al suscribirse" icon="eye">
    En la pestaña **Mensaje después de dejar los datos**, activá **Mostrar
    código del cupón**. Sin esto, el cliente se suscribe pero no ve ningún
    código (la causa exacta del "puse 5% de descuento y el cliente no ve
    nada para usarlo").
  </Step>
</Steps>

<Warning>
  Tené las dos cosas coherentes: si activás **Mostrar cupón** en el mensaje
  pero no elegiste ningún cupón en la pestaña **Cupón**, el sistema te avisa
  con un cuadro amarillo. O ambos activos, o ambos desactivados.
</Warning>

***

## 3. Qué ve el cliente final

Cuando el visitante deja sus datos (o gira la ruleta), Nubea le muestra el
código con un botón **Copiar**. Así se ve la pantalla de éxito:

<div
  style={{
maxWidth: 360,
padding: 28,
background: '#fff',
border: '1px solid #e5e7eb',
borderRadius: 12,
boxShadow: '0 12px 32px rgba(0,0,0,0.08)',
textAlign: 'center',
position: 'relative'
}}
>
  <div style={{ fontSize: 40, marginBottom: 8 }}>🎉</div>

  <div style={{ fontSize: 18, fontWeight: 700, color: '#111', marginBottom: 6 }}>
    ¡Listo! Acá está tu cupón
  </div>

  <div style={{ fontSize: 13, color: '#6b7280', marginBottom: 20 }}>
    Te lo mandamos también por email
  </div>

  <div
    style={{
  background: '#f9fafb',
  border: '2px dashed #3B82F6',
  borderRadius: 8,
  padding: '14px 16px',
  marginBottom: 16
}}
  >
    <div
      style={{
    fontSize: 11,
    color: '#6b7280',
    textTransform: 'uppercase',
    letterSpacing: 1,
    fontWeight: 600,
    marginBottom: 4
  }}
    >
      Tu cupón
    </div>

    <div
      style={{
    fontSize: 22,
    fontWeight: 700,
    color: '#3B82F6',
    letterSpacing: 2,
    fontFamily: 'monospace'
  }}
    >
      BIENVENIDA10
    </div>
  </div>

  <button
    style={{
  width: '100%',
  background: '#3B82F6',
  color: '#fff',
  border: 0,
  borderRadius: 8,
  padding: '12px',
  fontSize: 14,
  fontWeight: 600,
  cursor: 'pointer',
  marginBottom: 8
}}
  >
    Copiar y empezar a comprar
  </button>

  <div style={{ fontSize: 11, color: '#9ca3af' }}>
    Pegalo en el campo "Cupón de descuento" del checkout
  </div>
</div>

### Dónde lo pega el cliente

El cliente toca **Copiar**, arma su carrito y, al avanzar al checkout, pega
el código en el campo **"Cupón de descuento"** de Tiendanube — justo antes
de pagar. Ahí Tiendanube valida el código y aplica el descuento al total.

<Tip>
  El problema más común no es que el cupón falle, sino que el visitante **lo
  pierde antes de pagar**: cierra el modal, sigue navegando y se olvida del
  código. Para evitarlo, activá la **Barra de cupón** — una barra fija con
  el código y un botón Copiar que acompaña al visitante mientras navega. Está
  explicada paso a paso en la [guía de Ruleta](/funcionalidades/ruleta) y en
  la [guía de Popup](/funcionalidades/popups).
</Tip>

***

## 4. ¿Se suman los cupones? (combinación / stacking)

La pregunta que más repiten los comercios: *"si tengo un cupón extra activado
que no tiene que ver con la ruleta, ¿se suma o no a la compra? Yo necesito que
no se sumen."*

<Warning>
  En Tiendanube se aplica **un solo cupón de descuento por pedido**. El cliente
  pega un código en el campo "Cupón de descuento" del checkout, y si pega otro,
  **reemplaza** al anterior — no se suman dos cupones en la misma compra. Esto
  lo controla Tiendanube, no Nubea.
</Warning>

Qué significa en la práctica:

* **Cupón de Nubea/ruleta + otro cupón tuyo:** el cliente usa uno o el otro,
  nunca los dos a la vez sobre el mismo pedido. Si necesitás que **no se
  sumen**, no tenés que hacer nada especial: el checkout ya impide combinar
  dos cupones.
* **Cupón + una promoción/oferta de la tienda:** un cupón es un descuento
  distinto de las **promociones** que armás en Tiendanube (ej: 2x1, descuento
  por categoría). Un cupón sí puede aplicarse sobre un precio que ya tiene una
  promoción, porque son mecanismos separados. Si no querés que eso pase,
  revisá las condiciones del cupón y de la promoción en tu tienda.

<Tip>
  Si tu objetivo es que un cupón **no se combine con nada**, lo más prolijo es
  manejar las restricciones desde **Tiendanube → Cupones** (monto mínimo,
  vigencia, límite de usos, productos incluidos). Nubea entrega el código tal
  cual lo configuraste: las reglas de cuándo es válido viven en el cupón.
</Tip>

***

## 5. Activar y desactivar

Tanto la ruleta como el popup se prenden y se apagan con un **toggle** desde
su pantalla de configuración en Nubea.

<AccordionGroup>
  <Accordion title="Cómo activo los códigos de la ruleta">
    Cargá el código de cada premio (paso 2), confirmá que cada cupón exista y
    esté activo en Tiendanube, y prendé el **toggle** de la ruleta. Apenas
    quede activa, los visitantes empiezan a ver los premios con sus códigos.
  </Accordion>

  <Accordion title="Cómo desactivo la ruleta de descuentos">
    En tu panel de Nubea, entrá a la campaña de **Ruleta** y apagá el
    **toggle** de la esquina superior derecha (pasa de verde a gris). El
    cambio impacta en la tienda en 1-2 minutos. Los cupones que ya entregaste
    siguen siendo válidos en Tiendanube hasta su vencimiento — desactivar la
    ruleta sólo deja de mostrarla, no anula los códigos ya repartidos.
  </Accordion>

  <Accordion title="Cómo desactivo el popup con cupón">
    Igual que la ruleta: en la campaña de **Popup**, apagá el switch
    **Activado**. Si querés cortar también el descuento, pausá o vencé el
    cupón desde **Tiendanube → Cupones**.
  </Accordion>

  <Accordion title="Tengo ruleta y popup activos a la vez">
    El sistema muestra **uno por visita**. Si tenés los dos prendidos, alguno
    gana y el otro queda invisible. Dejá activo el que quieras usar y pausá el
    otro.
  </Accordion>
</AccordionGroup>

***

## Errores frecuentes con cupones

<AccordionGroup>
  <Accordion title="El cliente se suscribe pero no ve ningún cupón">
    Pasa cuando el cupón no está vinculado o no se está mostrando. Revisá:
    (1) que hayas elegido un cupón en la pestaña **Cupón** del popup, y (2)
    que hayas activado **Mostrar código del cupón** en el mensaje
    post-suscripción. En la ruleta, verificá que el premio que salió tenga
    su código cargado.
  </Accordion>

  <Accordion title="El cliente copia el código pero no funciona en el checkout">
    El código no existe o está vencido en Tiendanube, o no coincide
    carácter por carácter con el que cargaste en Nubea. Entrá a
    **Tiendanube → Cupones**, confirmá que el cupón esté **activo** y que el
    código sea idéntico al de Nubea.
  </Accordion>

  <Accordion title="Quiero que el cupón no se combine con otros descuentos">
    El checkout de Tiendanube ya impide usar dos cupones en el mismo pedido.
    Para limitar la combinación con promociones, ajustá las condiciones del
    cupón (monto mínimo, productos incluidos, vigencia) desde
    **Tiendanube → Cupones**.
  </Accordion>

  <Accordion title="Generé mucha gente suscripta pero pocas la usan">
    Suele ser pérdida del código antes de pagar. Activá la **Barra de cupón**
    para que el código acompañe al visitante mientras navega, y mandáselo
    también por WhatsApp/email. Ver la
    [guía de Ruleta](/funcionalidades/ruleta) o de
    [Popup](/funcionalidades/popups).
  </Accordion>
</AccordionGroup>

***

## Próximos pasos

<CardGroup cols={2}>
  <Card title="Ruleta de descuentos" icon="dharmachakra" href="/funcionalidades/ruleta">
    Configurá premios, probabilidades y la barra de cupón.
  </Card>

  <Card title="Popup con cupón" icon="window-restore" href="/funcionalidades/popups">
    Captura simple con un cupón fijo de bienvenida.
  </Card>
</CardGroup>

Si después de revisar esto el cupón sigue sin funcionar, escribinos por
WhatsApp al asistente de Nubea y te ayudamos a diagnosticarlo.