*MCP › Referencia › Alquileres › Pedidos* # Listar pedidos > Devuelve los pedidos de alquiler, paginados por cursor. El filtro `status` usa grupos operativos de alto nivel. El listado se limita estrictamente a la suscripción de la clave. HERRAMIENTA `filmo_orders_list` · `orders: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. | | `q` | string | No | Búsqueda de texto libre en el número de pedido, el nombre o alias del proyecto y la referencia externa. | | `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, startDate, endDate, orderNumber, grossPrice, rentalDays, itemsCount. 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ó. | | `status` | string | No | Filtra por grupo de estado operativo (vista de la UI): draft, reserved, prepared (incluye la preparación parcial), in_use (recogido/en uso), returned (incluye la devolución/check-in parcial), completed (con check-in hecho y completado) o cancelled. `draft`, `reserved`, `prepared`, `in_use`, `returned`, `completed`, `cancelled` | | `statuses` | string[] | No | Filtra por status, 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. `draft`, `reserved`, `prepared`, `in_use`, `returned`, `completed`, `cancelled` | | `contactId` | string | No | Filtra por identificador del contacto del pedido. | | `contactIds` | string[] | No | Filtra por contactId, 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. | | `projectId` | string | No | Filtra por identificador del proyecto al que pertenece el pedido. | | `projectIds` | string[] | No | Filtra por projectId, 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. | | `overlapsFrom` | string | No | Inicio de la ventana de solapamiento (ISO 8601 con desplazamiento): devuelve los pedidos cuyo periodo de alquiler se solapa con [overlapsFrom, overlapsTo]. | | `overlapsTo` | string | No | Fin de la ventana de solapamiento (ISO 8601 con desplazamiento): devuelve los pedidos cuyo periodo de alquiler se solapa con [overlapsFrom, overlapsTo]. | | `orderNumber` | string | No | Filtra por número de pedido: coincidencia exacta o por prefijo. | | `orderNumberIs` | string | No | Número de pedido que coincide exactamente. | | `orderNumberContains` | string | No | Número de pedido que contiene este texto en cualquier posició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, ends, starts, 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.ends` | object | No | | | `dateFilters.ends.gte` | string | No | Desde este día o instante, inclusive. | | `dateFilters.ends.lte` | string | No | Hasta este día o instante, inclusive. | | `dateFilters.ends.gt` | string | No | Estrictamente posterior; una fecha sin hora significa después del final de ese día. | | `dateFilters.ends.lt` | string | No | Estrictamente anterior; una fecha sin hora significa antes del inicio de ese día. | | `dateFilters.ends.on` | string | No | Exactamente ese día; un instante significa toda la jornada del negocio que lo contiene. | | `dateFilters.starts` | object | No | | | `dateFilters.starts.gte` | string | No | Desde este día o instante, inclusive. | | `dateFilters.starts.lte` | string | No | Hasta este día o instante, inclusive. | | `dateFilters.starts.gt` | string | No | Estrictamente posterior; una fecha sin hora significa después del final de ese día. | | `dateFilters.starts.lt` | string | No | Estrictamente anterior; una fecha sin hora significa antes del inicio de ese día. | | `dateFilters.starts.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 pedido. | | `orderNumber` | string | Número de pedido legible. | | `externalReference` | string | Referencia externa del pedido (por ejemplo, del sistema del cliente); null si no consta. | | `status` | string | Estado bruto del pedido tal como se almacena en la base de datos (12 valores): draft, reserved, prepared_partially, prepared, picked_up_partially, picked_up, returned_partially, returned, checked_in_partially, checked_in, archived o cancelled. `archived` forma parte del conjunto almacenado, pero un pedido archivado no es visible para la API, así que no lo observarás. `draft`, `reserved`, `prepared_partially`, `prepared`, `picked_up_partially`, `picked_up`, `returned_partially`, `returned`, `checked_in_partially`, `checked_in`, `archived`, `cancelled` | | `startDate` | string | Inicio del periodo de alquiler en ISO 8601 con desplazamiento. | | `endDate` | string | Fin del periodo de alquiler en ISO 8601 con desplazamiento. | | `rentalDays` | number | Número de días de alquiler facturables; null si no se ha calculado. | | `projectId` | string | Identificador del proyecto al que pertenece el pedido; null si no está vinculado. | | `projectName` | string | Nombre del proyecto al que pertenece el pedido; null si no está vinculado. | | `contact` | object | Referencia compacta al contacto del pedido; null si no hay. | | `contact.id` | string | Identificador único del contacto. | | `contact.name` | string | Nombre del contacto. | | `itemsCount` | integer | Número de artículos del pedido. | | `subTotalPrice` | string | Subtotal antes de descuentos e impuestos, como cadena decimal "1234.50" (ROUND_HALF_UP). | | `discountTotal` | string | Total de descuentos como cadena decimal "1234.50" (ROUND_HALF_UP); null si no hay descuento. | | `insuranceTotal` | string | Total del seguro como cadena decimal "1234.50" (ROUND_HALF_UP). | | `depositTotal` | string | Total de fianzas como cadena decimal "1234.50" (ROUND_HALF_UP). | | `taxesPrice` | string | Total de impuestos como cadena decimal "1234.50" (ROUND_HALF_UP). | | `netPrice` | string | Base imponible (neto antes de impuestos) como cadena decimal "1234.50" (ROUND_HALF_UP). | | `grossPrice` | string | Total con impuestos, como cadena decimal "1234.50" (ROUND_HALF_UP). | | `tags` | object[] | Etiquetas adjuntas al pedido, con su identificador y nombre. | | `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`. | | `source` | string | Origen desde el que se creó el pedido (por ejemplo web, mobile, admin); null si no consta. | | `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_orders_list* ```json { "jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": { "name": "filmo_orders_list", "arguments": { "limit": 20 } } } ``` *Resultado (generado desde el esquema)* ```json { "structuredContent": { "data": [ { "id": "id_8f2a1c", "orderNumber": "", "externalReference": "", "status": "draft", "startDate": "2026-09-01T08:00:00Z", "endDate": "2026-09-01T08:00:00Z", "rentalDays": 1, "projectId": "proj_8f2a1c", "projectName": "Example", "contact": { "id": "id_8f2a1c", "name": "Example" }, "itemsCount": 1, "subTotalPrice": "1234.50", "discountTotal": "1234.50", "insuranceTotal": "1234.50", "depositTotal": "1234.50", "taxesPrice": "1234.50", "netPrice": "1234.50", "grossPrice": "1234.50", "tags": [ { "id": "id_8f2a1c", "name": "Example" } ], "customFields": { "key": "" }, "source": "", "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 Lista los pedidos que empiezan mañana, el más próximo primero. ``` *Prompt* ```text ¿Qué pedidos están reservados y aún sin preparar esta semana? ``` ## La misma operación por REST Esta herramienta ejecuta [`GET /api/v1/orders`](https://docs.filmo.io/es/rest-api/endpoint-reference/orders/list-orders). --- URL canónica: https://docs.filmo.io/es/mcp/tools/orders/filmo-orders-list Última actualización: 2026-10-25