*API REST › Objetos › Alquileres*

# Subalquiler

> Material alquilado a otra empresa para cubrir un trabajo.

Material alquilado a otra empresa para cubrir un trabajo, con sus fechas, estado, notas y el vínculo con su orden de compra. Lo que se paga al proveedor no se publica. Los subalquileres quedan acotados a la suscripción propietaria de la clave.

Esquemas: `SubrentDto`

## Atributos

| Nombre | Tipo | Descripción |
| --- | --- | --- |
| `id` | string | Identificador único del subalquiler. |
| `type` | string | bulk si es una cantidad de un artículo a granel, serialized si es una unidad concreta. `bulk`, `serialized` |
| `status` | string | Estado del subalquiler. `pending`, `active`, `completed`, `cancelled` |
| `itemId` | string | Identificador del artículo subalquilado. |
| `itemName` | string | Nombre del artículo subalquilado. |
| `itemSku` | string | SKU del artículo; null si no tiene. |
| `quantity` | number | Unidades subalquiladas; null si es una unidad concreta. |
| `serializedItemId` | string | Identificador de la unidad concreta; null si es a granel. |
| `serializedItemCode` | string | Código de la unidad concreta; null si es a granel. |
| `providerId` | string | Identificador del proveedor que cede el material; null si aún no está decidido. |
| `providerName` | string | Nombre del proveedor; null si aún no está decidido. |
| `needResolved` | boolean | true si la necesidad ya está cubierta, es decir, si el proveedor y el material están confirmados. |
| `startDate` | string<date-time> | Inicio del periodo requerido en ISO 8601 UTC; null si no está definido. |
| `endDate` | string<date-time> | Fin del periodo requerido en ISO 8601 UTC; null si no está definido. |
| `pickupDate` | string<date-time> | Fecha de recogida en el proveedor en ISO 8601 UTC; null si no se ha fijado. |
| `returnDate` | string<date-time> | Fecha de devolución al proveedor en ISO 8601 UTC; null si no está definida. |
| `orderId` | string | Pedido que motiva el subalquiler; null si no tiene. |
| `projectId` | string | Proyecto asociado; null si no tiene. |
| `purchaseOrderId` | string | Pedido de compra que lo formaliza; null si no se ha emitido ninguno. |
| `spaceId` | string | Almacén donde se recibe el material; null si no aplica. |
| `notes` | string | Notas del subalquiler; null si no tiene. |
| `createdAt` | string<date-time> | Fecha de creación en ISO 8601 UTC. |
| `updatedAt` | string<date-time> | Fecha de la última modificación en ISO 8601 UTC. |

## Valores

| Campo | Valores |
| --- | --- |
| `type` | `bulk`, `serialized` |
| `status` | `pending`, `active`, `completed`, `cancelled` |

## Ejemplo

*Subrent · Generado a partir del esquema*

```json
{
  "id": "id_8f2a1c",
  "type": "bulk",
  "status": "pending",
  "itemId": "string",
  "itemName": "Example",
  "itemSku": "string",
  "quantity": 1,
  "serializedItemId": "string",
  "serializedItemCode": "string",
  "providerId": "string",
  "providerName": "Example",
  "needResolved": true,
  "startDate": "2026-09-01T08:00:00Z",
  "endDate": "2026-09-01T08:00:00Z",
  "pickupDate": "2026-09-01T08:00:00Z",
  "returnDate": "2026-09-01T08:00:00Z",
  "orderId": "string",
  "projectId": "string",
  "purchaseOrderId": "string",
  "spaceId": "string",
  "notes": "string",
  "createdAt": "2026-09-01T08:00:00Z",
  "updatedAt": "2026-09-01T08:00:00Z"
}
```

## Lo devuelven

- [`GET /api/v1/subrents`](https://docs.filmo.io/es/rest-api/endpoint-reference/subrents/list-subrents) — Listar subalquileres
- [`GET /api/v1/subrents/{subrentId}`](https://docs.filmo.io/es/rest-api/endpoint-reference/subrents/get-a-subrent) — Obtener un subalquiler

## Lo modifican

- [`PATCH /api/v1/subrents/{subrentId}`](https://docs.filmo.io/es/rest-api/endpoint-reference/subrents/update-a-subrent) — Actualizar un subalquiler

---

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