*MCP › Referencia › Catálogo e inventario › Artículos* # Actualizar los accesorios de un artículo > Aplica operaciones sobre la lista de accesorios. > **Requiere confirmación humana:** Pon esta herramienta en la lista de «preguntar antes de ejecutar» de tu cliente. Las anotaciones son pistas que declara el servidor, no garantías: no decidas la aprobación solo por `destructiveHint`. LEE `mode` ANTES DE LLAMAR: con `merge` —el valor por defecto— las operaciones son deltas y lo que no nombras se conserva; con `replace` la lista enviada es la final y TODO lo que falte SE ELIMINA. Un accesorio puede ser otro artículo del catálogo o uno personalizado con su nombre y su precio. Devuelve el artículo completo, con `accessoryIds` tal como quedan ahora, con la misma proyección que su GET. HERRAMIENTA `filmo_items_accessories_update` · `items:write` · 120/min · Anotación del servidor: Destructiva · Anotación del servidor: Idempotente · Requiere confirmación humana ## Argumentos | Nombre | Tipo | Obligatorio | Descripción | | --- | --- | --- | --- | | `itemId` | string | Sí | Identificador del artículo. | | `mode` | string | No | merge (por defecto): las operaciones son deltas y lo que no nombres se conserva. replace: la lista enviada es la lista final y todo lo que falte SE ELIMINA. `merge`, `replace` | | `targetItemVariantId` | string | No | Variante del artículo a la que se aplican los accesorios. | | `operations` | object[] | Sí | Operaciones que aplicar. Al menos una. | | `operations.accessoryId` | string | No | Accesorio existente. Obligatorio para actualizar o eliminar. | | `operations.action` | string | No | Qué hacer. Si se omite: con accessoryId actualiza, sin él crea. `create`, `update`, `delete` | | `operations.accessory` | object | Sí | Datos del accesorio. | | `operations.accessory.itemId` | string | No | Artículo que actúa como accesorio. Omítelo para uno personalizado. | | `operations.accessory.quantity` | integer | Sí | Cantidad del accesorio. | | `operations.accessory.free` | boolean | Sí | true si el accesorio no se cobra. | | `operations.accessory.default` | boolean | Sí | true si se añade automáticamente cuando el artículo se incluye en un pedido. | | `operations.accessory.accessoryVariantId` | string | No | Variante del accesorio. | | `operations.accessory.isCustom` | boolean | No | true para un accesorio que no está en el catálogo. | | `operations.accessory.customName` | string | No | Nombre del accesorio personalizado. | | `operations.accessory.customPrice` | number | No | Precio unitario del accesorio personalizado. | | `operations.accessory.position` | integer | No | Orden de visualización. | | `idempotencyKey` | string | No | Clave de idempotencia elegida por el cliente (se recomienda un UUID). Repetir la misma clave con los mismos argumentos en 24 h devuelve la respuesta almacenada sin volver a ejecutar; con argumentos distintos responde 422. Es la forma segura de reintentar tras un fallo de red. | | `ifMatch` | string | No | Bloqueo optimista: el meta.etag que obtuviste de la lectura de detalle de este recurso (o "*"). Si el recurso ha cambiado desde entonces, la llamada falla con 412 precondition_failed antes de escribir nada; léelo de nuevo y reintenta. Omítelo para escribir sin condiciones. | ## Resultado En un éxito el resultado lleva `structuredContent` con `data` y `meta`. Estos son los atributos de `data`. | Nombre | Tipo | Descripción | | --- | --- | --- | | `id` | string | Identificador único del artículo. | | `name` | string | Nombre del artículo. | | `sku` | string | Referencia SKU del artículo; null si no consta. | | `description` | string | Descripción del artículo; null si no consta. | | `orderInfo` | string | Información adicional del pedido (notas de preparación y entrega); null si no consta. | | `ean` | string | EAN/código de barras; null si no consta. | | `itemType` | string | Tipo de artículo: fixed (artículo simple) o variant (artículo con variantes). `fixed`, `variant` | | `stockCalculationMethod` | string | Método de cálculo del stock: bulk (a granel, por cantidad) o serialized (por artículos serializados). `bulk`, `serialized` | | `collectionId` | string | Identificador de la colección a la que pertenece; null si no está en ninguna. | | `collectionName` | string | Nombre de la colección a la que pertenece; null si no está en ninguna. | | `images` | string[] | URLs de las imágenes del artículo. | | `salePrice` | string | Precio de venta como cadena decimal "1234.50" (ROUND_HALF_UP); null si no tiene. | | `depositValue` | string | Importe de la fianza como cadena decimal "1234.50" (ROUND_HALF_UP); null si no tiene. | | `minStock` | number | Stock mínimo configurado para las alertas; null si no está configurado. | | `serializedItemsCount` | number | Número de unidades serializadas registradas del artículo. | | `pricingSettings` | object | Configuración de precios de alquiler; null si no está configurada. | | `pricingSettings.type` | string | Modo de precio: periodPrice (precio por periodo), fixedPrice (precio fijo) o pricingStructure (estructura de precios); null si el artículo no tiene ninguno configurado. `periodPrice`, `fixedPrice`, `pricingStructure` | | `pricingSettings.price` | string | Precio base de alquiler como cadena decimal "1234.50" (ROUND_HALF_UP); null si no aplica. | | `pricingSettings.period` | string | Unidad de periodo del precio: hour, day, week o month; null si el artículo no tiene ninguna configurada. `hour`, `day`, `week`, `month` | | `insuranceEnabled` | boolean | Si el artículo admite seguro. | | `discountEnabled` | boolean | Si el artículo admite descuentos. | | `bufferBefore` | number | Tiempo de margen reservado antes del alquiler; null si no aplica. | | `bufferBeforeUnit` | string | Unidad del margen previo: hora o día; null si no aplica. `hour`, `day` | | `bufferAfter` | number | Tiempo de margen reservado después del alquiler; null si no aplica. | | `bufferAfterUnit` | string | Unidad del margen posterior: hour o day; null si no aplica. `hour`, `day` | | `physicalProperties` | object | Propiedades físicas (peso y dimensiones); null si no se han registrado. | | `physicalProperties.weight` | number | Peso del artículo en kilogramos; null si no está registrado. | | `physicalProperties.width` | number | Ancho del artículo en centímetros; null si no está registrado. | | `physicalProperties.height` | number | Altura del artículo en centímetros; null si no consta. | | `physicalProperties.length` | number | Longitud del artículo en centímetros; null si no consta. | | `physicalProperties.volume` | number | Volumen del artículo en metros cúbicos (m³); null si no está registrado. | | `physicalProperties.current` | number | Consumo de corriente en amperios; null si no consta. | | `physicalProperties.power` | number | Potencia en vatios; null si no se ha registrado. | | `variants` | object[] | Variantes del artículo (vacío si el artículo es de tipo fixed). | | `variants.variantId` | string | Identificador único de la variante. | | `variants.variantName` | string | Nombre de la variante. | | `variants.variantPrice` | string | Precio de alquiler de la variante como cadena decimal "1234.50" (ROUND_HALF_UP). | | `variants.salePrice` | string | Precio de venta de la variante como cadena decimal "1234.50" (ROUND_HALF_UP); null si no tiene. | | `variants.ean` | string | EAN/código de barras de la variante; null si no consta. | | `tags` | object[] | Etiquetas asociadas al artículo. | | `tags.id` | string | Identificador único de la etiqueta. | | `tags.name` | string | Nombre de la etiqueta. | | `customFields` | object | Valores de los campos personalizados por identificador de campo personalizado; las definiciones están en `/api/v1/custom-fields`. | | `createdAt` | string | Fecha de creación en ISO 8601 con desplazamiento. | | `updatedAt` | string | Fecha de la última actualización en ISO 8601 con desplazamiento. | | `replacementValue` | string | Valor de reposición del artículo como cadena decimal "1234.50" (ROUND_HALF_UP); null si no consta. | | `accessoryIds` | string[] | Identificadores de los artículos configurados como accesorios de este. | | `alternativeIds` | string[] | Identificadores de los artículos configurados como alternativas de este. | *Llamada · filmo_items_accessories_update* ```json { "jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": { "name": "filmo_items_accessories_update", "arguments": { "itemId": "item_8f2a1c", "operations": [ { "accessoryId": "acce_8f2a1c", "action": "create", "accessory": { "itemId": "item_8f2a1c", "quantity": 1, "free": true, "default": true, "accessoryVariantId": "acce_8f2a1c", "isCustom": true, "customName": "Example", "customPrice": 1, "position": 1 } } ] } } } ``` *Resultado (generado desde el esquema)* ```json { "structuredContent": { "data": { "id": "id_8f2a1c", "name": "Example", "sku": "", "description": "", "orderInfo": "", "ean": "", "itemType": "fixed", "stockCalculationMethod": "bulk", "collectionId": "coll_8f2a1c", "collectionName": "Example", "images": [ "" ], "salePrice": "1234.50", "depositValue": "1234.50", "minStock": 1, "serializedItemsCount": 1, "pricingSettings": { "type": "periodPrice", "price": "1234.50", "period": "hour" }, "insuranceEnabled": true, "discountEnabled": true, "bufferBefore": 1, "bufferBeforeUnit": "hour", "bufferAfter": 1, "bufferAfterUnit": "hour", "physicalProperties": { "weight": 1, "width": 1, "height": 1, "length": 1, "volume": 1, "current": 1, "power": 1 }, "variants": [ { "variantId": "vari_8f2a1c", "variantName": "Example", "variantPrice": "1234.50", "salePrice": "1234.50", "ean": "" } ], "tags": [ { "id": "id_8f2a1c", "name": "Example" } ], "customFields": { "key": "" }, "createdAt": "2026-09-01T08:00:00Z", "updatedAt": "2026-09-01T08:00:00Z", "replacementValue": "1234.50", "accessoryIds": [ "acce_8f2a1c" ], "alternativeIds": [ "alte_8f2a1c" ] }, "meta": { "idempotencyKey": "", "rateLimit": { "limit": 120, "remaining": 119, "reset": 42 } } } } ``` ## La misma operación por REST Esta herramienta ejecuta [`PUT /api/v1/items/{itemId}/accessories`](https://docs.filmo.io/es/rest-api/endpoint-reference/items/update-the-accessories-of-an-item). --- URL canónica: https://docs.filmo.io/es/mcp/tools/items/filmo-items-accessories-update Última actualización: 2026-10-25