wc_get_coupon_count: contar cupones
Devuelve cuántos cupones existen en cada estado de publicación.
Argumentos
Ninguno.
Permisos
mcp:read y woocommerce:catalog:read, además de manage_woocommerce o edit_shop_coupons.
Qué devuelve
counts, organizado por estado: publish, draft, trash, pending, private, auto-draft y cualquier otro estado registrado en el sitio.
Aparece cada estado registrado, incluidos los que tienen un recuento de cero, de modo que la respuesta es más larga que el número de estados realmente en uso.
Es el total que el listado no te da
wc_get_coupons tiene un límite de 100, no pagina y no informa de ningún total. Esta herramienta es la única forma de saber si un listado estaba completo.
Obtén el recuento de cupones, luego lista los cupones publicados y dime si los he visto todos.
Si publish es 143 y el listado devolvió 100, hay cuarenta y tres cupones activos sin contabilizar. Nada en el listado lo indica.
El recuento de la papelera es el operativamente interesante
Los cupones en la papelera siguen conservando sus códigos. Una tienda con sesenta cupones en la papelera es una tienda donde sesenta códigos no pueden reutilizarse, y donde un intento de recrear uno falla por una razón que no resulta obvia.
Es también lo que compruebas antes de wc_empty_coupon_trash, que purga de forma permanente y de 100 en 100:
¿Cuántos cupones hay en la papelera?
Un recuento superior a 100 significa que la herramienta de purga debe ejecutarse más de una vez.
Los borradores son campañas preparadas
Un recuento elevado de draft normalmente significa cupones preparados para una promoción futura. Son invisibles para el listado predeterminado y son los que una instrucción amplia como «revisa nuestros descuentos» omitirá por completo.
Vale la pena sacarlos a la luz antes de que alguien concluya que la tienda tiene pocas ofertas.
Cuenta, pero no cualifica
La respuesta indica cuántos cupones existen por estado, y nada más sobre ellos. No puede decirte:
- cuántos han caducado: la caducidad es por cupón y solo está en la lectura completa;
- cuántos son realmente canjeables hoy;
- cuántos se han usado.
Así que publish: 143 no es «143 códigos de descuento que funcionan». Son 143 cupones que no son borradores ni están en la papelera, la mayoría de los cuales pueden estar muertos desde hace tiempo. Los datos de canje no están disponibles a través de MCP en absoluto; consulta Orders and customers are not exposed.
Cómo usarlo bien
Al inicio de cualquier trabajo con cupones:
Obtén el recuento de cupones y muéstrame el desglose.
Esa única llamada te dice el tamaño del problema: si los listados estarán completos, si hay un atraso en la papelera y si existen campañas preparadas.
Problemas comunes
| Síntoma | Causa |
|---|---|
| Falta la herramienta | WooCommerce no está activo |
pom_ai_mcp_wc_forbidden |
Falta manage_woocommerce o edit_shop_coupons |
| Estados que no reconoces | Se devuelven todos los estados registrados, incluidos los vacíos |
| Un recuento mayor del que parece tener la tienda | La papelera y los borradores están incluidos |
| No hay cifras de uso ni de canje | Ninguna herramienta MCP las expone |
Relacionados
wc_get_couponswc_empty_coupon_trashwc_get_store_stats— incluye también recuentos de cupones