Actualizar el stock
ps_update_stock
- ProSolo TellMyShop Pro
- Escritura · vista previa + aprobación
- Guarda: interruptor Ventas (hasta que lo apagues)
- Ventas · interruptor, hasta que lo apagues
- Visible nada más instalar
Cambia cuántas unidades tienes en stock.
TellMyShop Free: No. Esta herramienta solo está en TellMyShop Pro. TellMyShop Free solo tiene informes listos que leen tu tienda.
Pregunta al chat
«Nos han llegado 40 más de la lámpara negra ref:LMP-01. Súmalas al stock.»
Vista previa de ejemplo
Producto 45 Lámpara de jardín Nova, combinación Negro: 12 -> 52 (+40). Sin stock: no permitir pedidos (sin cambios). Se registrará un movimiento de stock.
Detalles técnicos
Fija la cantidad en stock (un valor nuevo, o delta = cambiar en más o menos N) y el comportamiento sin stock (deny, allow o default = ajuste de la tienda), para hasta 100 elementos por llamada. Para un producto con combinaciones indica combination_id; sin él, la vista previa lista las combinaciones con su ID y su stock. Guarda como el back office: un movimiento de stock con el empleado del conector y el hook de actualización de stock, para que los módulos que sincronizan el stock (marketplaces, ERP) vean el cambio.
Parámetros
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| shop_id | integer | no | ID de la tienda en una instalación multitienda. Por defecto, la tienda de la dirección del conector. ps_get_shop_info lista los ID. |
| changes | array of object | sí | Un elemento por producto o combinación. Máx. 100 elementos. Campos de cada elemento: product (string, obligatorio): producto (id:123, ref:ABC-1, ean:..., URL del producto, ID, EAN o referencia). Máx. 300 caracteres. combination_id (integer): ID de la combinación (obligatorio al cambiar la cantidad de un producto con combinaciones). quantity (integer): cantidad nueva. Rango de 0 a 1.000.000. delta (integer): cambiar la cantidad en más o menos N (en lugar de quantity). Rango de -1.000.000 a 1.000.000. out_of_stock (enum: deny | allow | default): comportamiento sin stock. |
| confirm | boolean | no | false (por defecto) devuelve una vista previa y no guarda nada. true ejecuta, solo después de que el usuario haya aprobado la vista previa, junto con change_token. |
| change_token | string | cuándo | Token de la vista previa. Obligatorio con confirm=true. Válido 30 minutos, de un solo uso, ligado a los argumentos y al estado de los datos de la vista previa. |
Límites
Máx. 100 elementos por llamada. Gestión avanzada de stock (almacenes): no compatible [por confirmar]. Se puede deshacer con ps_revert_change.
Lo que ves antes de que se guarde nada
El chat llama primero a la herramienta sin confirmar. El módulo devuelve una vista previa (valores actuales y nuevos) y un token de un solo uso válido durante 30 minutos. El chat te muestra la vista previa y guarda el cambio solo después de tu sí.
Herramientas relacionadas
- Combinaciones de producto (variantes) ps_manage_combinations
- Obtener un producto ps_get_product
- Diagnosticar la visibilidad de un producto ps_diagnose_product_visibility
- Deshacer un cambio ps_revert_change
Casos de uso con esta herramienta
- Corrige el stock tras un inventario
- Añade productos nuevos desde una lista del proveedor
- Fija precios, códigos y stock para tallas y colores
Última actualización: 2026-10-11