wc_create_product: crear un producto
Crea un producto simple o variable.
Argumentos
| Argumento | Significado |
|---|---|
type |
simple (predeterminado) o variable |
name |
Nombre del producto |
slug |
Slug de la URL |
status |
Estado de la entrada |
description |
Descripción completa |
short_description |
Descripción breve |
sku |
Unidad de mantenimiento de existencias |
regular_price |
Precio normal |
sale_price |
Precio de oferta |
manage_stock |
Si se debe controlar el inventario |
stock_quantity |
Nivel de existencias |
categories |
IDs de las categorías del producto |
dry_run |
Informar sin crear |
Permisos
Allow WooCommerce catalog writes abierto, además de acceso al catálogo y la capacidad de creación de productos. Cada escritura requiere aprobación explícita.
type se decide en la creación y es importante
Pasar type: variable crea un producto variable; cualquier otra cosa crea uno simple.
La diferencia es estructural. Un producto simple lleva su propio precio e inventario. Un producto variable no lleva ninguno de los dos de forma significativa: esos viven en sus variaciones, y un producto variable sin variaciones no se puede comprar.
Elegir mal es incómodo de corregir: convertir entre tipos no es algo que estas herramientas hagan.
Crear un producto variable es el paso uno de cuatro
- Crea el producto con
type: variable. - Asegúrate de que existan los atributos globales —
wc_get_product_attributes, ywc_create_product_attributesi realmente hace falta. - Adjúntalos con
wc_set_product_attributes, marcados como usados para variaciones. - Crea las variaciones con
wc_create_variation.
Detenerse después del paso uno deja un producto que los clientes no pueden comprar. Planifica toda la secuencia antes de empezar.
Los productos nuevos comienzan como borradores
Omitir status crea un borrador. Los valores admitidos son draft, pending, private y publish. Publicar o hacer privado un producto requiere la capacidad de publicación de productos. La vista previa valida los campos suministrados, incluida la unicidad del SKU, antes de solicitar una aprobación.
Los precios son cadenas, y ambos importan
Establece regular_price para el precio normal. Establece sale_price solo si el producto debe salir en oferta; establecerlo sin querer significa que el producto se publica con descuento.
El campo de solo lectura price de la respuesta te indica cuál está en vigor. Compruébalo.
El inventario tiene dos partes
manage_stock habilita el control; stock_quantity establece el número. Establecer una cantidad sin habilitar la gestión guarda un valor que WooCommerce ignora, y el producto aparece como en stock indefinidamente.
Establece ambos, o ninguno.
Los SKU deben ser únicos
WooCommerce rechaza un SKU duplicado. En una ejecución de creación masiva, este es el fallo más probable, y falla por producto en lugar de detener el lote, así que lee los resultados.
Las categorías son IDs
categories toma IDs de términos, no nombres. Léelos primero con wp_get_terms y taxonomy: product_cat, y decide explícitamente si el asistente puede crear nuevos.
Usa la prueba en seco
Devuelve la carga que crearía. Merece la pena antes de una primera creación para confirmar que los campos de tipo, estado y precio quedaron donde pretendías.
Qué devuelve
El producto creado en su totalidad, incluidos el nuevo id y el price calculado.
Problemas comunes
| Síntoma | Causa |
|---|---|
| La escritura se rechaza | Puerta de escritura del catálogo cerrada |
pom_ai_mcp_wc_forbidden |
Falta la capacidad de la tienda |
| El producto sigue siendo un borrador | La publicación debe solicitarse explícitamente |
| Se publicó con descuento | Se estableció sale_price |
| Los clientes no pueden comprarlo | Producto variable sin variaciones |
| El inventario se ignora | No se habilitó manage_stock |
| La creación falló | SKU duplicado |