*API REST › Objetos › Catálogo e inventario*

# Unidad serializada

> Unidad física concreta de un artículo, con su número de serie y dónde está.

Una unidad física concreta de un artículo, con su número de serie, su código, su estado y dónde está. Cuando está fuera, apunta al pedido que la tiene. Lista las unidades de un artículo filtrando por `itemId`. Los artículos serializados están acotados a la suscripción que posee la clave. La lectura de detalle añade el nombre de la colección del artículo.

Esquemas: `SerializedItemDto`, `SerializedItemDetailDto`

## Atributos

| Nombre | Tipo | Descripción |
| --- | --- | --- |
| `id` | string | Identificador único de la unidad física. |
| `code` | string | Código interno de la unidad. |
| `serialNumber` | string | Número de serie del fabricante; null si no está inscrito. |
| `status` | string | Estado actual de la unidad dentro del ciclo del inventario. |
| `condition` | string | Condición; null si no se ha evaluado. |
| `inventoryType` | string | "regular" para stock propio, "temporary" para stock traído para un trabajo concreto. |
| `itemId` | string | Identificador del artículo del catálogo al que pertenece esta unidad. |
| `itemName` | string | Nombre del artículo del catálogo. |
| `itemSku` | string | SKU del artículo; null si no tiene. |
| `variantId` | string | Identificador de la variante; null si el artículo no tiene variantes. |
| `variantName` | string | Nombre de la variante; null si no aplica. |
| `currentOrderId` | string | Pedido que retiene la unidad una vez preparada, recogida, vendida o devuelta; null en otro caso. Una unidad que solo está reservada en un pedido aún no está comprometida: sigue disponible y esto es null (la reserva se lee de los números de serie de la línea del pedido). |
| `currentOrderNumber` | string | Número de ese pedido; null si la unidad está libre. |
| `projectId` | string | Proyecto asociado al pedido actual; null si no procede. |
| `contactId` | string | Cliente del pedido actual; null si no procede. |
| `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. |
| `itemCollectionName` | string | Nombre de la colección del artículo; null si no está en ninguna. |

## Ejemplo

*Serialized item · Generado a partir del esquema*

```json
{
  "id": "id_8f2a1c",
  "code": "string",
  "serialNumber": "string",
  "status": "string",
  "itemId": "string",
  "itemName": "Example",
  "itemSku": "string",
  "itemCollectionName": "Example",
  "createdAt": "2026-09-01T08:00:00Z",
  "updatedAt": "2026-09-01T08:00:00Z"
}
```

## Lo devuelven

- [`GET /api/v1/serialized-items`](https://docs.filmo.io/es/rest-api/endpoint-reference/items/list-serialized-items) — Listar unidades serializadas
- [`GET /api/v1/serialized-items/{serializedItemId}`](https://docs.filmo.io/es/rest-api/endpoint-reference/items/get-a-serialized-item) — Obtener una unidad serializada

## Lo modifican

- [`PATCH /api/v1/serialized-items/{serializedItemId}`](https://docs.filmo.io/es/rest-api/endpoint-reference/items/update-a-serialized-item) — Actualizar una unidad serializada

---

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