Gestionar cupones
Un cupón es una promesa de regalar dinero. Uno equivocado lo descubren los clientes antes que tú, así que este es el flujo de trabajo con menos tolerancia a un error que parezca plausible.
Requisitos
- WooCommerce activo.
- Allow WooCommerce catalog writes abierto — los cupones comparten la puerta del catálogo.
woocommerce:catalog:readywoocommerce:catalog:write.- Capacidad de gestión de la tienda.
- Una copia de seguridad, y un entorno de pruebas para todo lo masivo.
Las herramientas
| Herramienta | Hace |
|---|---|
wc_get_coupons |
Listar cupones |
wc_get_coupon |
Leer uno |
wc_get_coupon_count |
Contar sin listar |
wc_create_coupon |
Crear uno |
wc_update_coupon |
Actualizar uno |
wc_delete_coupon |
Eliminar uno |
wc_empty_coupon_trash |
Vaciar la papelera de cupones |
Lee antes de escribir, y lee el cupón entero
Lee el cupón "SPRING25" y muéstrame el tipo de descuento, el importe, la caducidad, los límites de uso y las restricciones.
Un cupón es un conjunto de reglas que interactúan, y las interesantes son las restricciones, no el importe. Antes de cambiar nada, conoce:
- El tipo de descuento. Porcentaje o importe fijo — 25 como porcentaje y 25 como suma fija son promesas muy distintas.
- La fecha de caducidad. Un cupón caducado se comporta de forma distinta a uno sin caducidad.
- Los límites de uso. Por cupón y por usuario.
- El gasto mínimo y máximo.
- Las restricciones de productos y categorías.
- Si permite envío gratuito.
La simulación no es opcional aquí
wc_create_coupon y wc_update_coupon la admiten:
Usa una simulación y muéstrame cada campo del cupón resultante antes de crearlo.
Lee el resultado entero, no solo el campo que pediste cambiar. El modo de fallo no suele ser un importe incorrecto — es un importe correcto al que le falta una restricción, lo que convierte una promoción dirigida en un descuento para todo el sitio.
Crear un cupón
Indica cada restricción explícitamente. Todo lo que no se indique adopta valores predeterminados, y los predeterminados son permisivos:
Crea un cupón "SPRING25": 25 % de descuento, caduca el 30 de abril, limitado a un uso por cliente, 200 usos en total, gasto mínimo 50, se aplica solo a la categoría "Outdoor", no se puede combinar con otros cupones.
Después comprueba la simulación contra esa lista, elemento por elemento, antes de crearlo.
Restricciones ausentes que debes vigilar:
- sin fecha de caducidad, así que funciona para siempre;
- sin límite de uso, así que puede compartirse públicamente y usarse sin límite;
- sin gasto mínimo, así que se aplica a un pedido de un solo artículo;
- sin restricción de producto, así que se aplica a todo el catálogo;
- uso individual no activado, así que se acumula con otros cupones.
Actualizar un cupón
Los cupones en circulación se han entregado a clientes. Cambiar uno cambia lo que esos clientes pueden canjear.
Amplía la caducidad al 31 de mayo. No cambies nada más.
Considera si un cambio debería ser en realidad un cupón nuevo: reducir el valor de un cupón activo o endurecer sus restricciones es, en la práctica, retirar algo que ya se había ofrecido.
Eliminar y la papelera
wc_delete_coupon elimina un cupón. wc_empty_coupon_trash elimina permanentemente todo lo que hay en la papelera de cupones.
Ten clara la diferencia: el primero normalmente es recuperable desde la papelera; el segundo no es recuperable en absoluto. wc_empty_coupon_trash es una operación de mantenimiento, no una forma de quitar un solo cupón.
Antes de vaciar la papelera, mira qué contiene. A veces los cupones se mandan a la papelera para pausarlos.
Verifica en la tienda
Que los datos almacenados sean correctos no demuestra que el cupón se comporte bien. Después de crear o cambiar uno:
- Vuelve a leerlo.
- Pon un artículo que cumpla los requisitos en un carrito de la tienda y aplica el código. Confirma que el descuento es el que pretendías.
- Prueba un caso que no cumpla los requisitos — por debajo del gasto mínimo, o un producto fuera de la restricción — y confirma que se rechaza.
- Purga la caché.
El paso 3 es el que detecta una restricción ausente, y es el que la gente se salta.
Trabajo masivo
Cuenta primero con wc_get_coupon_count y luego haz una prueba piloto con uno:
Lista los cupones que caducan este mes con sus códigos e importes, y luego detente.
No apliques nunca un cambio masivo a cupones sin comprobar antes un resultado en la tienda. Una regla aplicada a cuarenta cupones son cuarenta ofertas en vivo.
Problemas comunes
| Síntoma | Causa |
|---|---|
pom_ai_mcp_wc_coupon_not_found |
Código o ID incorrecto |
| La escritura se rechaza | Puerta de escritura del catálogo cerrada, o capacidad insuficiente |
| El descuento es mayor de lo previsto | Porcentaje frente a importe fijo |
| Se aplica a todo | No se estableció ninguna restricción de producto o categoría |
| No caduca nunca | No se estableció ninguna fecha de caducidad |
| Los clientes lo comparten ampliamente | No se estableció ningún límite de uso |
| Se acumula con otras ofertas | No se activó el uso individual |
| La tienda no lo reconoce | Caché no purgada, o el cupón no está publicado |