Asignar características a productos
ps_set_product_features
- ProSolo TellMyShop Pro
- Escritura · vista previa + aprobación
- Guarda: al momento
- Contenido y SEO, Catálogo · escribe al momento
- Visible nada más instalar
Rellena las características de los productos, como el color o el material.
TellMyShop Free: No. Esta herramienta solo está en TellMyShop Pro. TellMyShop Free solo tiene informes listos que leen tu tienda.
Pregunta al chat
«Pon Material = Terciopelo en los productos 112, 113 y 140. Usa el valor existente si lo hay.»
Vista previa de ejemplo
3 elementos, característica Material (ID 5), modo replace. Producto 112: Tela -> Terciopelo (ID de valor 22) Producto 113: (ninguno) -> Terciopelo Producto 140: Tela -> Terciopelo
Detalles técnicos
Fija o quita un valor de característica (por ejemplo Color, Material) para muchos productos. Indica el valor como value_id (existente, de ps_list_features) o new_value (texto, crea un nuevo valor predefinido; si ya existe uno, aunque sea con otras mayúsculas, la herramienta se niega y devuelve el value_id que usar). mode=replace (por defecto) sustituye los valores de la característica en el producto; add añade otro valor. Las características alimentan los filtros de la tienda.
Parámetros
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| lang | string | cuándo | Código ISO del idioma en el que escribes. Obligatorio cuando la tienda tiene más de un idioma activo. Claude escribe el contenido en este idioma. |
| 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. |
| mode | enum: replace | add | no | replace = sustituir los valores de la característica, add = añadir otro valor. Por defecto replace. |
| items | array of object | sí | Elementos: producto + característica + uno de value_id, new_value, remove. 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. feature_id (integer, obligatorio): ID de la característica (ps_list_features). value_id (integer): ID de un valor existente. new_value (string): valor nuevo (texto en el idioma lang). Máx. 255 caracteres. remove (boolean): true = quitar esta característica del producto. |
| 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. Se niega a crear un valor duplicado.
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
- Listar características ps_list_features
- Buscar productos ps_search_products
- Deshacer un cambio ps_revert_change
Casos de uso con esta herramienta
- Limpia los valores de características duplicados
- Rellena las características de producto que faltan para los filtros
Última actualización: 2026-10-11