wc_delete_variation: eliminar una variación

Elimina una variación. La única herramienta de borrado del conjunto de productos: no hay forma de eliminar un producto en sí a través de MCP.

Argumentos

Argumento Obligatorio Significado
id Sí La variación
force No Eliminar de forma permanente en lugar de enviar a la papelera

Usa dry_run: true para inspeccionar la variación exacta antes de solicitar la aprobación.

Permisos

Allow WooCommerce catalog writes abierto, además del permiso de acceso al catálogo y de eliminación tanto para la variación como para su producto principal. Los ID de producto se rechazan.

force decide si esto es recuperable

Sin él, la variación va a la papelera y puede restaurarse desde el administrador de WordPress.

Con force: true, desaparece. Nada en POM AI puede recuperarla, y las variaciones no tienen historial de revisiones, así que el único registro de su precio, SKU y existencias es lo que hayas leído de antemano.

Por defecto, envía a la papelera. Reserva force para limpiar variaciones que hayas creado por error minutos antes.

Vista previa y aprobación

Lee la variación y luego solicita una vista previa. La vista previa incluye sus campos actuales. Una solicitud de escritura devuelve un enlace de revisión; apruébalo como actor original y vuelve a enviar los mismos argumentos con approval_id. Confirma el valor devuelto de deleted y lee las variaciones restantes.

Eliminar cambia lo que los clientes pueden comprar

Una variación es una combinación comprable. Eliminarla quita esa opción del selector del producto.

Consecuencias que conviene comprobar antes de eliminar:

  • El rango de precios del producto cambia si eliminaste la combinación más barata o la más cara.
  • La combinación deja de estar disponible, y los clientes que la tenían en un carrito o en una lista de deseos la pierden.
  • Los feeds y los marketplaces que hacen referencia al SKU de esa variación empezarán a notificar un artículo faltante.
  • Eliminar todas las variaciones deja un producto variable sin nada que vender: se sigue mostrando, pero no se puede añadir nada al carrito.

Ese último caso es fácil de provocar por accidente con una instrucción como «elimina las tallas descatalogadas».

Confirma cuál es por sus atributos

Los ID tienen un aspecto intercambiable; las combinaciones de atributos no.

Elimina la variación de la talla L en azul del producto 219: dime su ID y confirma los atributos antes de eliminar.

Trabajar a partir de una lista obsoleta de ID es como se termina eliminando la variación equivocada.

Sin existencias no es lo mismo que descatalogado

Si una combinación no está disponible temporalmente, pon sus existencias a cero en lugar de eliminarla. Eliminar pierde el SKU, el precio y cualquier referencia externa; el stock a cero es reversible y mantiene intacta la estructura del producto.

Elimina solo cuando la combinación no vaya a volver de verdad.

Después de eliminar

  1. Enumera las variaciones restantes y confirma que el conjunto es lo que esperas.
  2. Abre la página del producto y comprueba el selector.
  3. Comprueba el rango de precios mostrado.
  4. Purga la caché y luego la CDN.

Problemas habituales

Síntoma Causa
La escritura se rechaza La puerta de escritura del catálogo está cerrada
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
No se puede restaurar Se usó force
El producto no se puede comprar en absoluto Se eliminaron todas las variaciones
El rango de precios parece incorrecto Se eliminó la combinación más barata o la más cara
El selector todavía la ofrece La caché no se purgó
`wc_update_variation`: actualizar una variación
Anterior
`wc_batch_update_variations`: cambia variaciones en lote
Siguiente