*MCP › Referencia › Alquileres › Pedidos*

# Listar las líneas de un pedido

> Devuelve qué recursos lleva el pedido (artículos, espacios, servicios y elementos personalizados) con sus cantidades, sus unidades serializadas concretas, su periodo y su precio de venta.

Es la consulta habitual tras obtener un pedido. Las líneas añadidas durante la entrega se dejan fuera salvo que se pidan con `includeDelivery=true`. No emite datos de coste ni de margen. Las líneas pertenecen al pedido y solo se obtienen a través de él: no hay una colección independiente de líneas. Las líneas vienen en el orden del documento.

HERRAMIENTA `filmo_orders_lines_list` · `orders:read` · 120/min · Anotación del servidor: Solo lectura · Anotación del servidor: Idempotente

## Argumentos

| Nombre | Tipo | Obligatorio | Descripción |
| --- | --- | --- | --- |
| `orderId` | string | Sí | Identificador del pedido. |
| `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: position, itemName, quantity, startDate, endDate, rentalDays, unitPrice, linePrice, status, resourceType, transactionType. Por defecto, "position". 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ó. |
| `resourceType` | string | No | Filtra por tipo de recurso de la línea: item, space, service, custom, section o type_group. `item`, `kit`, `space`, `vehicle`, `personnel`, `service`, `custom`, `section`, `type_group` |
| `transactionType` | string | No | Filtra por naturaleza de la línea: rental o sale. `rental`, `sale` |
| `includeDelivery` | boolean | No | Si es "true", incluye también las líneas añadidas durante el proceso de entrega. Por defecto solo se devuelven las líneas del pedido original. = `false` |
| `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` |

## 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 de la línea. |
| `orderId` | string | Identificador del pedido al que pertenece la línea. |
| `resourceType` | string | Tipo de recurso de la línea. Las líneas de tipo section y type_group son agrupaciones de presentación sin recurso asociado. `item`, `kit`, `space`, `vehicle`, `personnel`, `service`, `custom`, `section`, `type_group` |
| `transactionType` | string | Naturaleza de la línea: rental o sale. `rental`, `sale` |
| `status` | string | Estado de la línea dentro del flujo del pedido. `draft`, `reserved`, `prepared`, `picked_up`, `sold`, `returned`, `checked_in`, `cancelled`, `lost` |
| `position` | integer | Posición de visualización de la línea dentro del pedido, empezando en 0. |
| `addedDuringDelivery` | boolean | true si la línea se añadió durante el proceso de entrega y no en el pedido original. |
| `itemId` | string | Identificador del artículo del catálogo; null si la línea no es de tipo artículo. |
| `itemName` | string | Nombre del artículo, espacio, servicio o elemento personalizado de la línea. |
| `variantId` | string | Identificador de la variante del artículo; null si no aplica. |
| `spaceId` | string | Identificador del espacio; null si la línea no es de tipo espacio. |
| `quantity` | number | Unidades de la línea. |
| `serials` | object[] | Unidades físicas concretas asignadas. Vacío para artículos no serializados o cuando aún no se han asignado. |
| `serials.id` | string | Identificador único de la unidad serializada. |
| `serials.code` | string | Código interno de la unidad; null si no tiene. |
| `serials.serialNumber` | string | Número de serie del fabricante; null si no está registrado. |
| `startDate` | string<date-time> | Inicio del periodo de la línea en ISO 8601 UTC; null si hereda el periodo del pedido. |
| `endDate` | string<date-time> | Fin del periodo de la línea en ISO 8601 UTC; null si hereda el periodo del pedido. |
| `rentalDays` | number | Días de alquiler facturables de la línea; null si no se ha calculado. |
| `unitPrice` | string | Precio unitario neto como cadena decimal "1234.50"; null si la línea no tiene precio propio. |
| `linePrice` | string | Importe neto total de la línea como cadena decimal "1234.50"; null si no se ha calculado. |
| `free` | boolean | true si la línea se factura explícitamente a cero. |
| `notes` | string | Notas de la línea; null si no hay. |

*Llamada · filmo_orders_lines_list*

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "filmo_orders_lines_list",
    "arguments": {
      "orderId": "orde_8f2a1c",
      "limit": 20
    }
  }
}
```

*Resultado (generado desde el esquema)*

```json
{
  "structuredContent": {
    "data": [
      {
        "id": "id_8f2a1c",
        "orderId": "orde_8f2a1c",
        "resourceType": "item",
        "transactionType": "rental",
        "status": "draft",
        "position": 1,
        "addedDuringDelivery": true,
        "itemId": "item_8f2a1c",
        "itemName": "Example",
        "variantId": "vari_8f2a1c",
        "spaceId": "spac_8f2a1c",
        "quantity": 1,
        "serials": [
          {
            "id": "id_8f2a1c",
            "code": "<code>",
            "serialNumber": "<serialNumber>"
          }
        ],
        "startDate": "2026-09-01T08:00:00Z",
        "endDate": "2026-09-01T08:00:00Z",
        "rentalDays": 1,
        "unitPrice": "1234.50",
        "linePrice": "1234.50",
        "free": true,
        "notes": "<notes>"
      }
    ],
    "pagination": {
      "nextCursor": "eyJvIjo1MH0",
      "hasMore": true,
      "total": 1
    },
    "meta": {
      "rateLimit": {
        "limit": 120,
        "remaining": 119,
        "reset": 42
      },
      "etag": "\"3sT3d9pBvZq4h2N0w8x1YkLmQ7c\""
    }
  }
}
```

## La misma operación por REST

Esta herramienta ejecuta [`GET /api/v1/orders/{orderId}/lines`](https://docs.filmo.io/es/rest-api/endpoint-reference/orders/list-the-lines-of-an-order).

---

URL canónica: https://docs.filmo.io/es/mcp/tools/orders/filmo-orders-lines-list  
Última actualización: 2026-10-25