Catálogo e inventario

Unidad serializada

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

Esquemas: SerializedItemDto, SerializedItemDetailDto

{
  "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"
}

Generado a partir del esquema

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.

Atributos

idstring

Identificador único de la unidad física.

codestring

Código interno de la unidad.

serialNumberstring | null

Número de serie del fabricante; null si no está inscrito.

statusstring

Estado actual de la unidad dentro del ciclo del inventario.

conditionstring | null

Condición; null si no se ha evaluado.

inventoryTypestring

"regular" para stock propio, "temporary" para stock traído para un trabajo concreto.

itemIdstring

Identificador del artículo del catálogo al que pertenece esta unidad.

itemNamestring

Nombre del artículo del catálogo.

itemSkustring | null

SKU del artículo; null si no tiene.

variantIdstring | null

Identificador de la variante; null si el artículo no tiene variantes.

variantNamestring | null

Nombre de la variante; null si no aplica.

currentOrderIdstring | null

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

currentOrderNumberstring | null

Número de ese pedido; null si la unidad está libre.

projectIdstring | null

Proyecto asociado al pedido actual; null si no procede.

contactIdstring | null

Cliente del pedido actual; null si no procede.

createdAtstring<date-time>

Fecha de creación en ISO 8601 UTC.

updatedAtstring<date-time>

Fecha de la última modificación en ISO 8601 UTC.

itemCollectionNamestring | nullsolo en el detalle

Nombre de la colección del artículo; null si no está en ninguna.

Lo devuelven

GET /api/v1/serialized-items — Listar unidades serializadas
GET /api/v1/serialized-items/{serializedItemId} — Obtener una unidad serializada

Lo modifican

PATCH /api/v1/serialized-items/{serializedItemId} — Actualizar una unidad serializada

¿Te ha resultado útil esta página?

Ejemplo

Atributos

Lo devuelven

Lo modifican