wc_get_coupon: obtener un cupón
Lee un cupón en su totalidad — incluida la fecha de caducidad y las restricciones que el listado omite.
Argumentos
| Argumento | Obligatorio | Significado |
|---|---|---|
id |
Sí | El ID del cupón |
Ten en cuenta que esto recibe el ID numérico, no el código. Para pasar de SUMMER25 a un ID, primero lista los cupones.
Permisos
mcp:read y woocommerce:catalog:read, además de manage_woocommerce o edit_shop_coupons.
Qué devuelve
Los cinco campos del listado — id, code, discount_type, amount, usage_limit — más:
| Campo | Significado |
|---|---|
description |
La nota interna que explica para qué sirve el código |
individual_use |
Si se puede combinar con otros cupones |
product_ids |
Los productos a los que está restringido, si los hay |
date_expires |
Cuándo deja de funcionar, como marca de tiempo ISO, o null |
date_expires es el campo por el que viniste
null significa que el cupón nunca caduca. No es un valor por defecto neutral — es un código que seguirá funcionando dentro de tres años, en cualquier campaña en la que se filtre.
Una tienda llena de cupones que no caducan es una tienda con exposición ilimitada a descuentos, y esta es la única herramienta que lo muestra.
Lee todos los cupones y dime cuáles no tienen fecha de caducidad.
Cuando hay una fecha, es una marca de tiempo exacta, de modo que un cupón puede estar activo ahora y caducar esta misma tarde. Compárala con la hora del propio sitio, no con la tuya.
individual_use decide si los descuentos se acumulan
Con él desactivado, el cliente puede combinar este cupón con otros y los descuentos se acumulan. Normalmente no es lo que pretende una campaña.
El listado no lo indica, así que un problema de acumulación pasa desapercibido hasta que alguien encuentra la combinación. Leerlo aquí es la comprobación.
product_ids delimita el cupón
Una lista vacía significa que el cupón se aplica a todo el carrito. Una lista con contenido lo restringe a esos productos.
Cuidado con la situación inversa: WooCommerce también admite productos excluidos, gasto mínimo, límites por usuario y restricciones de correo electrónico — y ninguno de ellos es visible aquí, porque MCP no los expone. Así que esta lectura te muestra solo parcialmente el alcance de un cupón.
Un cupón puede estar mucho más restringido de lo que sugiere esta respuesta. Comprueba el administrador de WooCommerce antes de concluir que un código no tiene límites.
usage_limit es un total, no por cliente
Limita cuántas veces se puede canjear el código en toda la tienda. El límite independiente por cliente no está expuesto por estas herramientas.
null o 0 significa ilimitado. Combinado con una caducidad null, es un código sin techo de ningún tipo.
Lee antes de cada escritura
Los cupones no tienen historial de revisiones. Esta respuesta es el único registro de lo que una actualización está a punto de sustituir.
Lee el cupón 812 y muéstrame todos los campos; después aplica el cambio.
Esto importa más que en la mayoría de los contenidos, porque los valores son comerciales: una cantidad sobrescrita por accidente es dinero.
Cómo usarlo bien
Lee el cupón 812 y dime si es válido actualmente.
Para cada cupón publicado, muéstrame el código, la cantidad, el tipo y la caducidad en una tabla.
Problemas comunes
| Síntoma | Causa |
|---|---|
pom_ai_mcp_wc_coupon_not_found |
ID incorrecto, o pasaste el código en su lugar |
pom_ai_mcp_wc_forbidden |
Falta manage_woocommerce o edit_shop_coupons |
date_expires es null |
El cupón nunca caduca |
| Las restricciones que configuraste están ausentes | MCP expone solo una parte de los ajustes de un cupón |
| El cupón funciona pese a parecer restringido | Hay ajustes no expuestos en juego |
Relacionado
wc_get_coupons— encuentra el IDwc_update_coupon- Herramientas de cupones
Permisos de objeto
El acceso al catálogo por sí solo no autoriza todos los objetos. Las actualizaciones y las lecturas privadas comprueban el objeto seleccionado; las operaciones de variación también comprueban su producto principal. La eliminación requiere capacidades de borrado. Crear un cupón requiere capacidades de creación y publicación de cupones; crear un atributo global requiere manage_product_terms. Toda escritura utiliza el flujo de aprobación.