Gestionar las variaciones de producto
Las variaciones multiplican todo: un producto con tres tallas y cuatro colores tiene doce de ellas, cada una con su propio precio y existencias. Eso las convierte en el mejor caso para delegar en un asistente y en el lugar más fácil para cometer doce errores a la vez.
Requisitos
Igual que los productos: WooCommerce activo, Allow WooCommerce catalog writes abierto, ámbitos de lectura y escritura del catálogo, capacidad de gestión de la tienda y una copia de seguridad.
Las herramientas
| Herramienta | Hace |
|---|---|
wc_get_product_variations |
Lista las variaciones de un producto |
wc_get_variation |
Lee una |
wc_create_variation |
Crea una |
wc_update_variation |
Actualiza una |
wc_delete_variation |
Elimina una |
wc_batch_update_variations |
Actualiza varias en una sola llamada |
Ten en cuenta que las variaciones, a diferencia de los productos, sí se pueden eliminar mediante MCP. La eliminación no se puede recuperar desde la papelera.
Los atributos van primero
Las variaciones existen en función de los atributos de un producto variable. Antes de crear cualquiera:
- Confirma que el producto es variable —
wc_get_product. - Lee sus atributos —
wc_get_product_attributesywc_get_attribute_terms. - Confirma que los atributos están marcados como usados para variaciones.
Un asistente que crea variaciones contra atributos que el producto no tiene produce variaciones que nunca coinciden con la selección de un cliente. Leer primero lo evita. Consulta Gestionar el catálogo de productos.
Lee el conjunto existente
Lista las variaciones del producto 219 con sus IDs, atributos, precios y existencias, y detente.
Para un producto con muchas variaciones, este listado es la referencia contra la que trabajarás y el registro de los valores antiguos si algo necesita restaurarse.
La herramienta por lotes es potente y contundente
wc_batch_update_variations actualiza varias variaciones en una sola llamada. Es la herramienta adecuada para «sube el precio de cada variación un 5 %» y la herramienta equivocada para cualquier cosa que no hayas verificado antes en una sola variación.
La secuencia segura:
- Actualiza una variación con
wc_update_variation, usando una simulación (dry run). - Comprueba el resultado en la tienda.
- Después procesa el resto por lotes.
Usa primero una simulación (dry run) en la variación 2204 y muéstrame el antes y el después.
Un lote que aplica la regla equivocada a doce variaciones son doce correcciones manuales, y solo tendrás los valores antiguos si los listaste primero.
El precio y las existencias son cuestiones separadas
Cada variación tiene su propio precio normal, precio de oferta, estado de existencias y cantidad de existencias — y puede heredar del producto padre para algunos de ellos.
Sé explícito sobre cuál estás cambiando:
Actualiza solo el precio normal en estas variaciones. No cambies los precios de oferta, las cantidades de existencias ni el estado de existencias.
Las existencias en particular tienen una dimensión oculta: cambiar el estado de existencias a «en existencias» sin una cantidad, o establecer una cantidad mientras la gestión de existencias está desactivada, produce un estado en la tienda que no coincide con lo que pretendías.
Eliminar variaciones
wc_delete_variation elimina una de forma permanente. Antes de eliminar:
- confirma que la variación no se usa de verdad, no que simplemente esté agotada;
- comprueba si algún enlace de cliente o feed apunta a ella;
- prefiere marcarla como agotada u oculta si no estás seguro.
Eliminar una variación que un cliente tiene en un carrito o en una lista de deseos produce un error para él, no para ti.
Después de cualquier cambio en las variaciones
- Vuelve a leer las variaciones.
- Abre la página del producto en la tienda.
- Selecciona cada variación cambiada en el formulario del producto y confirma el precio y la disponibilidad mostrados.
- Comprueba que el rango de precios mostrado en las páginas de listado se actualizó.
- Purga la caché y luego la CDN.
El paso 3 es el que importa. Que los datos almacenados sean correctos no garantiza que el selector que ve el cliente se comporte correctamente, especialmente después de cambios en los atributos.
Problemas comunes
| Síntoma | Causa |
|---|---|
pom_ai_mcp_wc_variation_not_found |
ID incorrecto, o la variación fue eliminada |
| Las variaciones no aparecen en la tienda | Los atributos no están marcados como usados para variaciones |
| Una variación no se puede seleccionar | Su combinación de atributos no coincide con los atributos del producto |
| El rango de precios en los listados está desactualizado | La caché no se purgó |
| Un lote aplicó la regla equivocada | No se probó primero en una sola variación |
| Las existencias se muestran incorrectamente | La configuración de gestión de existencias frente a la cantidad escrita |