Cupones: crear, limitar, publicar y diagnosticar un descuento

Qué problema resuelve

Cupones permite crear un código que el cliente ingresa para obtener un descuento. El cupón no es una promoción automática: requiere que el código exista, esté activo y cumpla sus reglas.

Usalo cuando necesitás una condición comercial explícita como una campaña, beneficio a clientes o código distribuido por un canal.

Antes de crear uno

Definí primero cuatro cosas: qué descuento querés dar, a qué productos aplica, en qué canal se puede usar y durante qué período. Si no necesitás que el cliente ingrese un código, evaluá Promociones automáticas en lugar de un cupón.

La pantalla está protegida por la capability de plan correspondiente. Si la API devuelve un bloqueo de plan, Structura muestra el estado de feature bloqueada en lugar del editor.

Paso 1 — Tipo y valor

El código es el identificador que utilizará el cliente. Evitá códigos ambiguos o difíciles de comunicar.

En porcentaje, 100 representa un descuento del 100%. En monto fijo, el valor representa dinero y no porcentaje.

Paso 2 — Alcance

Podés elegir:

• Toda la tienda: cualquier ítem elegible del carrito.
• Productos específicos: seleccionás productos mediante el selector de alcance.
• Categorías específicas: seleccionás categorías mediante el selector de alcance.

Cuando elegís productos o categorías, la selección pasa a ser parte de la regla del cupón. No alcanza con haber creado el cupón: los productos del carrito deben coincidir con ese alcance.

Paso 3 — Límites y audiencia

Canal de venta

Los valores disponibles son:

• Todos
• Tienda + POS
• Solo tienda online
• Solo POS
• Solo empresas (B2B)

Si elegís B2B podés restringir además mediante IDs de canales B2B separados por coma.

Lista de precios

El selector permite restringir el cupón a determinadas listas. Sin selección significa todas las listas de precios. Esto es importante: dejar vacío no equivale a desactivar el cupón.

Vigencia

• Válido desde: opcional.
• Válido hasta: opcional.

Dejar las fechas vacías permite que no exista una ventana temporal explícita.

Usos

• Máximo de usos totales: vacío significa sin límite.
• Usos por cliente: sin límite, 1 uso, 2 usos o personalizado.

El límite total controla el cupón globalmente; el límite por cliente evita que una misma persona lo utilice indefinidamente.

Paso 4 — Pop-up

El pop-up es opcional y está separado de la regla de descuento. Activarlo agrega una presentación promocional; no cambia por sí mismo el valor del descuento.

La configuración contempla imagen, título, cuerpo y CTA. El CTA inicial es Usar cupón.

No confundas el contenido del pop-up con la condición comercial: una pieza visual puede anunciar el cupón, pero la aplicación real depende de las reglas configuradas.

Guardar y estados

Al guardar:

1. Structura envía toda la configuración del formulario a la API de cupones.
2. Si es nuevo, crea el cupón.
3. Si se está editando, actualiza el existente.
4. La lista se vuelve a cargar desde servidor.
5. El editor se cierra cuando la operación termina correctamente.

Cada cupón puede editarse, activarse/desactivarse o eliminarse. Cambiar el estado usa una operación específica; eliminar requiere confirmación.

Cómo verificar que funciona

No pruebes solamente que aparece en la lista. Hacé una prueba con:

1. un producto que coincida con el alcance;
2. el canal correcto;
3. una lista de precios permitida;
4. una fecha dentro de la vigencia;
5. el código exacto;
6. un carrito que cumpla el mínimo configurado.

Después verificá el descuento aplicado y que el pedido conserve el canal y contexto esperado.

Errores y diagnóstico

El cupón existe pero no aplica: revisá alcance, canal, lista de precios, fechas y límites de uso antes de crear otro cupón.

El descuento parece demasiado alto: verificá si elegiste porcentaje o monto fijo y revisá el valor.

B2B no funciona: comprobá que el canal de venta sea B2B y que los IDs restringidos correspondan al canal real.

No puedo abrir la pantalla: puede existir un bloqueo por plan/capability; el editor no debe ser forzado desde el cliente.

El cupón desaparece después de guardar: volvé a cargar la lista. Si la API no devuelve el registro, tratá el problema como persistencia/backend, no como un problema visual.

Qué no hacer

• No crear varios cupones para compensar un alcance mal configurado.
• No usar una promoción automática si la estrategia depende de un código.
• No asumir que un pop-up hace aplicable el descuento.
• No dejar límites o fechas ambiguos si la campaña tiene una ventana comercial concreta.