*MCP › Referencia › Catálogo e inventario › Artículos* # Listar artículos > Devuelve el catálogo de artículos de inventario, paginado por cursor. Aislamiento estricto por suscripción. HERRAMIENTA `filmo_items_list` · `items:read` · 120/min · Anotación del servidor: Solo lectura · Anotación del servidor: Idempotente ## Argumentos | Nombre | Tipo | Obligatorio | Descripción | | --- | --- | --- | --- | | `limit` | integer | No | Tamaño de página (1-500). Por defecto es 50. = `50` | | `cursor` | string | No | Cursor opaco de la página que se devuelve. Pasa el valor de `pagination.nextCursor` de la respuesta anterior; trátalo como opaco. | | `sort` | string | No | Orden: hasta 3 campos separados por comas, cada uno con un "-" inicial para descendente (p. ej. "-updatedAt,name"). Campos ordenables: createdAt, updatedAt, name, sku, salePrice, depositValue, serializedItemsCount, collectionName. Por defecto, "-createdAt". Los empates se resuelven por id, así que el orden es estable entre páginas, y un cursor queda ligado al orden con el que se emitió. | | `query` | string | No | Búsqueda de texto libre (actualmente ILIKE sobre nombre, SKU, sinónimos y códigos de unidades serializadas). La semántica NO es contractual: puede evolucionar sin previo aviso. | | `stockType` | string | No | Filtra por método de cálculo del stock: serialized (por unidades serializadas) o bulk (a granel). `serialized`, `bulk` | | `stockTypes` | string[] | No | Filtra por stockType, como lista: repite el parámetro o separa los valores con comas. Acepta hasta 50 valores y devuelve lo que coincida con cualquiera de ellos. `serialized`, `bulk` | | `collectionId` | string | No | Filtra por identificador de la colección a la que pertenece el artículo. | | `collectionIds` | string[] | No | Filtra por collectionId, como lista: repite el parámetro o separa los valores con comas. Acepta hasta 50 valores y devuelve lo que coincida con cualquiera de ellos. | | `ids` | string | No | Consulta por lotes mediante identificadores separados por comas (entre 1 y 100), pensada para la sincronización. | | `includeTotal` | boolean | No | Ponlo en true para incluir `pagination.total`, el número de resultados que coinciden con los filtros en todas las páginas. Desactivado por defecto. = `false` | | `dateFilters` | object | No | Filtros de fecha por campo. Una fecha sin hora (YYYY-MM-DD) se lee en la zona horaria del negocio; un instante ISO 8601 con desplazamiento se aplica tal cual con gte, lte, gt y lt, mientras que on lo amplía al día completo del negocio que lo contiene. Campos: created, updated. | | `dateFilters.created` | object | No | | | `dateFilters.created.gte` | string | No | Desde este día o instante, inclusive. | | `dateFilters.created.lte` | string | No | Hasta este día o instante, inclusive. | | `dateFilters.created.gt` | string | No | Estrictamente posterior; una fecha sin hora significa después del final de ese día. | | `dateFilters.created.lt` | string | No | Estrictamente anterior; una fecha sin hora significa antes del inicio de ese día. | | `dateFilters.created.on` | string | No | Exactamente ese día; un instante significa toda la jornada del negocio que lo contiene. | | `dateFilters.updated` | object | No | | | `dateFilters.updated.gte` | string | No | Desde este día o instante, inclusive. | | `dateFilters.updated.lte` | string | No | Hasta este día o instante, inclusive. | | `dateFilters.updated.gt` | string | No | Estrictamente posterior; una fecha sin hora significa después del final de ese día. | | `dateFilters.updated.lt` | string | No | Estrictamente anterior; una fecha sin hora significa antes del inicio de ese día. | | `dateFilters.updated.on` | string | No | Exactamente ese día; un instante significa toda la jornada del negocio que lo contiene. | ## 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. | *Llamada · filmo_items_list* ```json { "jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": { "name": "filmo_items_list", "arguments": { "limit": 20 } } } ``` *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" } ], "pagination": { "nextCursor": "eyJvIjo1MH0", "hasMore": true, "total": 1 }, "meta": { "rateLimit": { "limit": 120, "remaining": 119, "reset": 42 } } } } ``` ## Prompts de ejemplo *Prompt* ```text Busca los artículos de la categoría de cámaras que contengan «cine» en el nombre. ``` ## La misma operación por REST Esta herramienta ejecuta [`GET /api/v1/items`](https://docs.filmo.io/es/rest-api/endpoint-reference/items/list-items). --- URL canónica: https://docs.filmo.io/es/mcp/tools/items/filmo-items-list Última actualización: 2026-10-25