# Cupones

> Da a cada destinatario de un email su propio código de descuento de un solo uso, o un código para todos, y consulta qué códigos se han asignado y canjeado. Alfa: solo para el equipo de Emailit.

Un cupón pone un código de descuento en tus emails con `{{coupon "key"}}`. Un cupón de **códigos únicos** da a cada destinatario su propio código de un pool, así que los códigos no se pueden compartir. Un cupón de **un código para todos** inserta el mismo código para todos. Emailit reparte los códigos y tu tienda los comprueba al pagar, así que crea los mismos códigos en tu tienda.

> **Comercio electrónico está en alfa:** Comercio electrónico solo está abierto al equipo de Emailit mientras lo probamos. Consulta [Quién puede usar Comercio electrónico](/es/docs/commerce/#who-can-use-commerce).

## Crear un cupón

1. **Abre Coupons.** En **Email Marketing → Commerce**, abre la pestaña **Coupons** y selecciona **Create coupon**.

2. **Completa el cupón.**

   | Campo | Notas |
   | --- | --- |
   | **Name** | Para ti, por ejemplo `Welcome 10%`. |
   | **Key** | Lo que escribes en el contenido: `{{coupon "welcome10"}}`. Letras minúsculas, dígitos, `-` y `_`, hasta 64 caracteres. El contenido que usa una clave antigua no muestra nada, así que no la cambies una vez que el cupón esté en uso. |
   | **Type** | **Unique codes** o **One code for everyone**. |
   | **Code** | En los cupones de un código para todos, el código. |
   | **Fallback code** | En los cupones de códigos únicos, opcional: se envía cuando se agotan los códigos o el cupón ha caducado. Sin él, la etiqueta no muestra nada en esos casos. |
   | **Discount** | Una etiqueta como `10% off`, que se muestra en el panel. |
   | **Expires** | Opcional. A partir de esa fecha, los cupones únicos solo envían el código alternativo. |

3. **Añade códigos** a un cupón único. Ábrelo, selecciona **Add codes** y elige una de estas opciones:
   - **Upload codes** desde tu tienda: un código por línea, o un CSV con los códigos en la primera columna, hasta 10.000 cada vez. Los códigos que ya están en el pool se omiten.
   - **Generate codes**: Emailit crea códigos aleatorios sin caracteres que se confundan entre sí (sin 0, O, 1 ni I), con un prefijo opcional. Después, selecciona **Export CSV** y crea los mismos códigos en tu tienda.

4. **Úsalo en el contenido.** Pon `{{coupon "welcome10"}}` en un email de campaña o de automatización. Consulta [Productos, cupones y el carrito](/es/docs/campaigns/products-and-coupons/#coupon-codes).

## Cómo se reparten los códigos

- Cada destinatario recibe un código por campaña o automatización. Si el mismo email se vuelve a renderizar para él, por ejemplo en la versión web, recibe el mismo código.
- Los códigos se asignan cuando se crea el email, así que una campaña grande gasta tantos códigos como destinatarios tiene. Mantén un pool con más códigos que destinatarios.
- Las vistas previas y los envíos de prueba muestran un código de ejemplo como `WELCOME10-PREVIEW` y no gastan códigos.

## Seguir los canjes

Cuando un [pedido](/es/docs/api-reference/orders/create/) incluye un código en `coupon_codes`, Emailit lo marca como **Redeemed** con ese pedido. Un código que se ha usado en tu tienda antes de que Emailit lo repartiera no se envía nunca. La página del cupón muestra cuántos códigos están **Available**, **Assigned** y **Redeemed**, y lista los códigos con quién los recibió y cuándo. **Export CSV** descarga la lista.

Los segmentos pueden encontrar a los contactos que han usado un cupón con la regla `used_coupon`. Consulta [Reglas de actividad](/es/docs/api-reference/segments/create/#activity-rules).

## Usar la API

| Endpoint | Para qué sirve |
| --- | --- |
| [Crear un cupón](/es/docs/api-reference/coupons/create/) | Crear un cupón único o estático. |
| [Añadir códigos a un cupón](/es/docs/api-reference/coupons/add-codes/) | Subir códigos, o generarlos con una cantidad, un prefijo y una longitud. |
| [Listar los códigos de un cupón](/es/docs/api-reference/coupons/list-codes/) | Leer el pool, filtrado por disponibles, asignados o canjeados. |
| [Listar](/es/docs/api-reference/coupons/list/), [obtener](/es/docs/api-reference/coupons/get/), [actualizar](/es/docs/api-reference/coupons/update/) y [eliminar](/es/docs/api-reference/coupons/delete/) | Gestionar los cupones. |

## Ver también

  - [Productos, cupones y el carrito](/es/docs/campaigns/products-and-coupons/): Todas las etiquetas de comercio electrónico para el contenido de los emails.
  - [Comercio electrónico](/es/docs/commerce/): Conecta tu tienda y consulta los ingresos que generan tus emails.

---
Fuente: https://emailit.com/es/docs/commerce/coupons/