*API REST › Objetos › Alquileres*

# Línea de pedido

> Línea de pedido: qué recurso incluye, cuánto, cuándo y a qué precio de venta.

Una línea de un pedido: qué recurso incluye (un artículo, un kit, un espacio, un vehículo, personal, un servicio o una línea personalizada), cuántas unidades, cuándo y a qué precio de venta. Las líneas pertenecen al pedido y se leen con [`GET /api/v1/orders/{orderId}/lines`](https://docs.filmo.io/es/rest-api/endpoint-reference/orders/list-the-lines-of-an-order); no hay una colección independiente de líneas. Una línea puede llevar los números de serie asignados.

Esquemas: `OrderLineDto`

## Atributos

| 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. |

## Valores

| Campo | Valores |
| --- | --- |
| `resourceType` | `item`, `kit`, `space`, `vehicle`, `personnel`, `service`, `custom`, `section`, `type_group` |
| `transactionType` | `rental`, `sale` |
| `status` | `draft`, `reserved`, `prepared`, `picked_up`, `sold`, `returned`, `checked_in`, `cancelled`, `lost` |

## Ejemplo

*Order line · Generado a partir del esquema*

```json
{
  "id": "id_8f2a1c",
  "orderId": "string",
  "resourceType": "item",
  "transactionType": "rental",
  "status": "draft",
  "position": 1,
  "addedDuringDelivery": true,
  "itemId": "string",
  "itemName": "Example",
  "variantId": "string",
  "spaceId": "string",
  "quantity": 1,
  "serials": [
    {
      "id": "id_8f2a1c",
      "code": "string",
      "serialNumber": "string"
    }
  ],
  "startDate": "2026-09-01T08:00:00Z",
  "endDate": "2026-09-01T08:00:00Z",
  "rentalDays": 1,
  "unitPrice": "1234.50",
  "linePrice": "1234.50",
  "free": true,
  "notes": "string"
}
```

## Lo devuelven

- [`GET /api/v1/orders/{orderId}/lines`](https://docs.filmo.io/es/rest-api/endpoint-reference/orders/list-the-lines-of-an-order) — Listar las líneas de un pedido

## Lo modifican

Ninguna operación.

---

URL canónica: https://docs.filmo.io/es/rest-api/objects/order-line  
Última actualización: 2026-10-25