wc_get_variation: obtener una variación
Lee una única variación por completo, incluido su stock.
Argumentos
| Argumento | Obligatorio | Significado |
|---|---|---|
id |
Sí | El ID de la variación |
Permisos
mcp:read y woocommerce:catalog:read, más manage_woocommerce o edit_products.
Qué devuelve
id, parent_id, sku, price, regular_price, sale_price y attributes — más description y stock_quantity, que el listado omite.
Es la única forma de ver el stock de una variación
wc_get_product_variations no devuelve el stock. Por tanto, auditar el stock de un producto implica una llamada por variación.
Para un producto con veinte variaciones, eso son veinte llamadas de lectura — factible dentro del límite de tasa de lectura, pero conviene planificarlo:
Lista las variaciones del producto 219 y, a continuación, lee cada una y muéstrame una tabla con el SKU, el precio y el stock.
Verifica que la variación es una variación
La herramienta comprueba el tipo y devuelve pom_ai_mcp_wc_variation_not_found para cualquier cosa que no lo sea. Eso la hace más estricta que el listado, que devuelve silenciosamente nada para un ID incorrecto.
Si no estás seguro de si un ID es una variación o un producto, esta herramienta te lo dice.
parent_id confirma en qué producto estás
Útil cuando trabajas con una lista de IDs de variaciones recopilados antes: confirma que cada uno sigue perteneciendo al producto que tú crees.
Lee antes de cada escritura
Las variaciones no tienen historial de revisiones. Los valores que aparecen aquí son tu único registro de lo que una escritura está a punto de reemplazar.
Muéstrame el precio y el stock actuales de la variación 2204 y, a continuación, actualiza el precio.
Esto importa más en las variaciones que en los productos, porque el trabajo con variaciones suele ser plural — y un lote que sale mal necesita los valores anteriores de cada elemento, no solo de uno.
El stock son dos cosas
stock_quantity es un número, pero que WooCommerce lo use depende de que la gestión de stock esté activada — lo cual es un ajuste del producto padre, no un campo de la variación, y no se informa aquí.
Así que una variación que informa de una cantidad en un producto con la gestión de stock desactivada está mostrando un número sobre el que nada actúa. Comprueba el padre con wc_get_product.
Cómo usarla bien
Lee la variación 2204 y muéstrame todos los campos.
Muéstrame el stock de cada variación del producto 219.
Antes de un lote:
Lee cada variación del producto 219 y dame una tabla que pueda usar para restaurarlas.
Problemas comunes
| Síntoma | Causa |
|---|---|
pom_ai_mcp_wc_variation_not_found |
ID incorrecto, o el ID es un producto |
pom_ai_mcp_wc_forbidden |
Falta la capacidad de tienda |
| Un número de stock que no hace nada | La gestión de stock está desactivada en el padre |
price difiere de regular_price |
Hay un precio de oferta activo en esta variación |
| No hay precio en absoluto | La variación no es comprable |
Relacionado
Permisos de objetos
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 con variaciones también comprueban su producto padre. 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. Cada escritura usa el flujo de aprobación.