El módulo Cupones te permite crear códigos de descuento que tus clientes escriben al pagar: en el checkout de tu tienda en línea o en la página de una factura que les envías. Tú decides cuánto descuentan, a qué productos aplican, desde qué monto, cuántas veces se pueden usar y hasta cuándo.
1. ¿Qué es un cupón?
Un cupón es un código (por ejemplo VERANO15) con unas reglas. Cuando el cliente lo aplica, el descuento queda dentro del pedido o de la factura, antes de impuestos, y el total a pagar se recalcula al instante.
- Para tiendas: campañas de temporada, bienvenida a nuevos clientes, liquidar una categoría o premiar compras grandes.
- Para servicios: un descuento en una factura que el cliente paga en línea (por ejemplo, por pronto pago acordado o una promoción).
Se conecta con otros módulos:
- Tienda On-line: el comprador ve el enlace «¿Tienes un código de descuento?» en el checkout.
- Facturas: el cliente puede aplicar el código en la página pública de su factura antes de pagarla.
- Finanzas y Reportes: ves cuánto descuento otorgaste y cuánto vendiste con cada cupón.
2. Acceso y vista general
- Menú lateral → CRM → Ventas → Cupones. También hay un acceso directo desde la Tienda On-line.
- Arriba ves cuántos cupones están disponibles (activos y programados), cuántos no disponibles (vencidos, agotados o inactivos) y el resultado del mes: usos con el descuento otorgado y ventas con cupón con el ticket promedio. Las dos primeras tarjetas filtran la lista.
- En la lista ves el código (con botón para copiarlo), el descuento, dónde se puede usar (tienda o facturas), los usos con su barra de avance, la vigencia y el estado.
- En el celular la lista se muestra como tarjetas y el filtro por estado en chips deslizables.
3. Estados de un cupón
| Estado | Qué significa |
|---|---|
| Activo | Se puede usar hoy. |
| Programado | Está activo pero su fecha de inicio aún no llega. |
| Vencido | Pasó su fecha de fin (vence a las 23:59, hora de tu cuenta). |
| Agotado | Alcanzó su límite de usos. |
| Inactivo | Lo desactivaste tú. El código deja de funcionar al instante. |
4. Crear un cupón
4.1 Desde una idea
Si aún no tienes cupones, la pantalla te propone tres ideas listas para ajustar: 10 % de bienvenida, monto fijo en compras desde un mínimo (en la moneda de tu cuenta) y 15 % en una categoría. Al elegir una se abre el editor con todo precargado; revisa y guarda.
4.2 Desde cero
- Toca Nuevo cupón. El editor te sugiere un código aleatorio; puedes escribir el tuyo o tocar Generar (los códigos generados evitan letras que se confunden, como 0/O o 1/I).
- Valor del descuento: elige Porcentaje (entre 0,01 % y 99,99 %) o Monto fijo (en la moneda de tu cuenta).
- Aplica a: todo el pedido, productos específicos o categorías de tu tienda.
- Dónde se puede usar: Tienda en línea, Pago de facturas o ambos.
- Requisito mínimo (opcional): monto mínimo de compra sobre los productos a los que aplica, sin envío ni impuestos.
- Límite de usos (opcional): cuántas veces en total se puede usar.
- Vigencia: fecha de inicio y, si quieres, fecha de fin.
- Nombre interno (opcional): solo lo ves tú, por ejemplo «Campaña de verano».
- Guarda con el botón Guardar o con
Ctrl + S.
A la derecha, el Resumen te dice en palabras lo que configuraste y la sección Así lo verá tu cliente muestra un ejemplo con subtotal, descuento y total. En el celular el resumen aparece arriba, plegable.
El código es único
5. Cómo lo usa tu cliente
5.1 En la tienda
- En el checkout, junto al resumen del pedido, toca ¿Tienes un código de descuento?
- Escribe el código y toca Aplicar.
- El resumen muestra la línea Descuento (CÓDIGO) y el nuevo total, sin recargar la página. Con Quitar lo retira.
Si el cliente vuelve al carrito y cambia productos, el cupón se revisa de nuevo: si ya no cumple (por ejemplo, la compra quedó bajo el mínimo), se quita y se le avisa. En el celular el resumen con el código aparece antes de los datos de pago.
5.2 En la página de una factura
Cuando envías una factura, el cliente ve el mismo enlace debajo de los botones de pago. Al aplicar el código, la factura se actualiza con el descuento y el botón Pagar muestra el nuevo monto.
Solo antes de emitir y sin pagos
6. Reglas importantes
- Un descuento por documento: el cupón no se combina con un descuento manual. Si la factura ya tiene uno, no se ofrece el código.
- Antes de impuestos: el descuento reduce la base y el impuesto se calcula sobre el monto con descuento.
- Moneda de tu cuenta: el monto fijo y la compra mínima van en la moneda de tu cuenta (dólares en Panamá, pesos en Colombia).
- Suscripciones: en productos de suscripción el descuento aplica solo al primer cobro.
- Monto fijo mayor que la compra: si el cupón es de $10 y la compra elegible es de $8, el código no se aplica y el cliente ve el motivo.
7. Usos y reservas
La pestaña Usos de cada cupón muestra en qué pedidos o facturas se aplicó, el descuento, el total pagado y la fecha.
| Estado del uso | Qué significa |
|---|---|
| Reservado | Se aplicó a un pedido o factura que aún no se paga. Cuenta para el límite de usos durante 48 horas. |
| Canjeado | El documento recibió su primer pago. Es un uso definitivo. |
| Liberado | El cliente o tú lo quitaron, se cambió por otro código o dejó de cumplir las condiciones. |
Gracias a la reserva, dos compradores no pueden llevarse a la vez el último uso disponible, y un carrito abandonado lo libera solo pasadas 48 horas.
8. Editar, desactivar, duplicar y eliminar
- Desde el menú … de cada fila puedes editar, activar o desactivar, copiar el código, duplicar y eliminar.
- Cuando un cupón ya se usó, su código y su tipo quedan fijos para que el historial siga siendo correcto. El valor, los límites y la vigencia sí puedes cambiarlos y aplican a los usos siguientes.
- Duplicar crea una copia inactiva con el código terminado en «-2», lista para ajustar.
- Si un cupón ya tiene usos, te recomendamos desactivarlo en vez de eliminarlo: deja de funcionar igual y conservas su historial a la vista. Eliminar tampoco cambia los pedidos ni facturas que ya lo usaron.
9. Un cupón dentro de una factura en el panel
Al abrir en el panel un pedido o factura con cupón, el resumen muestra Subtotal, la línea Cupón CÓDIGO y el total. Los descuentos manuales quedan bloqueados mientras el cupón esté aplicado. Si cambias productos o cantidades, el cupón se recalcula al guardar; con Quitar lo retiras y la factura vuelve a sus precios sin descuento.
10. Resultados en Finanzas
- En Finanzas → Reportes → Cupones de descuento ves, por cupón y por periodo: usos, descuento otorgado, ventas con cupón y ticket promedio.
- Lo facturado en Finanzas ya es el monto con descuento: no se cuenta dos veces.
11. Límites por plan
| Plan | Cupones activos a la vez |
|---|---|
| Gratis | 3 |
| Avanzado y Agencia | 100 |
Los cupones inactivos, vencidos o eliminados no cuentan. Si llegas al límite, desactiva uno o mejora tu plan.
12. API y agentes de IA
Puedes gestionar cupones desde Claude, ChatGPT u otro agente conectado a tu panel (ver API y conexión con agentes de IA). Las herramientas son coupon_list, coupon_get, coupon_create y coupon_update, y por API REST /api/coupons. Usan el permiso de Facturas de tu llave de acceso.
Ejemplo de instrucción: «Crea un cupón NAVIDAD25 de $25 para la tienda, con compra mínima de $150, válido del 1 al 26 de diciembre y máximo 50 usos».
13. Mejores prácticas
- Usa códigos cortos y fáciles de dictar por WhatsApp o teléfono.
- Ponle fecha de fin a las promociones de temporada para no olvidar apagarlas.
- Con monto fijo, define una compra mínima para proteger tu margen.
- Revisa cada mes el reporte de cupones: si un código no genera ventas, cámbialo o desactívalo.
14. Solución de problemas frecuentes
| Lo que ve el cliente | Por qué pasa |
|---|---|
| «Este código no es válido» | El código no existe, está inactivo o fue eliminado. Revisa que esté bien escrito. |
| «Este código venció el…» | Pasó la fecha de fin. Edita la vigencia si quieres extenderlo. |
| «Este código estará disponible a partir del…» | El cupón está programado: su fecha de inicio aún no llega. |
| «Ya alcanzó su límite de usos» | Se agotaron los usos (incluye reservas de pedidos sin pagar de las últimas 48 horas). |
| «Te faltan $X para usar este código» | La compra no llega al mínimo configurado. |
| «No aplica a los productos de tu compra» | El cupón es para productos o categorías que no están en el carrito. |
| «No se puede combinar con un código» | La factura ya tiene un descuento manual. |
| «Este documento ya no admite códigos» | La factura ya se emitió o tiene pagos. |
| No aparece el enlace del código | No hay cupones activos para ese canal (tienda o facturas), o la factura ya no los admite. |
15. Recursos y soporte
- Emyi, tu asistente de IA en MGPanel, puede ayudarte a diseñar una promoción.
- Guías relacionadas: Tienda On-line, Facturas y Resumen Finanzas.

