Artículos

Actualizar una unidad serializada

Cambia la ficha de UN artículo serializado: su estado, dónde está, su número de serie o su garantía.

Herramienta

filmo_serialized_items_update

Escrituraitems:write

items:write
120/min
Anotación del servidor: Idempotente

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "filmo_serialized_items_update",
    "arguments": {
      "serializedItemId": "seri_8f2a1c"
    }
  }
}

{
  "structuredContent": {
    "data": {
      "id": "id_8f2a1c",
      "code": "<code>",
      "serialNumber": "<serialNumber>",
      "status": "<status>",
      "itemId": "item_8f2a1c",
      "itemName": "Example",
      "itemSku": "<itemSku>",
      "itemCollectionName": "Example",
      "createdAt": "2026-09-01T08:00:00Z",
      "updatedAt": "2026-09-01T08:00:00Z"
    },
    "meta": {
      "idempotencyKey": "<the key you sent, or the one the server generated>",
      "rateLimit": {
        "limit": 120,
        "remaining": 119,
        "reset": 42
      }
    }
  }
}

generado desde el esquema

Es lo que necesita un sistema de almacén para decir "este ha vuelto y está operativo". El coste de la unidad, la nota interna y las condiciones del subalquiler ni entran ni salen por esta API. El artículo al que pertenece lo resuelve el servidor. Devuelve el artículo serializado completo, con la misma proyección que su GET.

Argumentos

serializedItemIdstringObligatorio

Identificador del artículo serializado.

Límites: longitud mín. 1

codestring

Código interno de la unidad. Identifica la unidad, por lo que no puede estar vacío.

Límites: longitud mín. 1, longitud máx. 200

serialNumberstring | null

Número de serie del fabricante; null lo borra.

Límites: longitud máx. 200

statusstring

Estado de la unidad.

Opciones disponibles: available, prepared, picked_up, returned, broken, archived, sold

activeboolean

false saca la unidad del conjunto sin eliminarla.

orderInfostring

Información visible en el pedido y en el albarán.

Límites: longitud máx. 1000

providerReferencestring

Referencia con la que el proveedor identifica la unidad.

Límites: longitud máx. 200

poNumberstring

Número del pedido de compra con el que entró.

Límites: longitud máx. 200

purchaseDatestring<date-time>

Fecha de compra, en ISO 8601 con desplazamiento.

warrantyExpirationstring<date-time>

Fin de la garantía, en ISO 8601 con desplazamiento.

spaceIdstring

Almacén donde se encuentra la unidad.

locationIdstring | null

Ubicación dentro del almacén; null la borra.

idempotencyKeystring

Clave de idempotencia elegida por el cliente (se recomienda un UUID). Repetir la misma clave con los mismos argumentos en 24 h devuelve la respuesta almacenada sin volver a ejecutar; con argumentos distintos responde 422. Es la forma segura de reintentar tras un fallo de red.

Límites: longitud mín. 1, longitud máx. 255

ifMatchstring

Bloqueo optimista: el meta.etag que obtuviste de la lectura de detalle de este recurso (o "*"). Si el recurso ha cambiado desde entonces, la llamada falla con 412 precondition_failed antes de escribir nada; léelo de nuevo y reintenta. Omítelo para escribir sin condiciones.

Límites: longitud mín. 1

Resultado

En un éxito el resultado lleva structuredContent con data y meta. Estos son los atributos de data.

Ver los atributos de data

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.

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.

itemCollectionNamestring | null

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

createdAtstring<date-time> | null

Fecha de creación en ISO 8601 UTC; null si no consta.

updatedAtstring<date-time> | null

Fecha de la última modificación en ISO 8601 UTC; null si no está registrada.

Un error es un resultado con isError: true y el problema en content[0].text; no hay structuredContent. Consulta Errores.

La misma operación por REST

Esta herramienta ejecuta PATCH /api/v1/serialized-items/{serializedItemId}.

Artículos
Actualizar una unidad serializada
Cambia la ficha de UN artículo serializado: su estado, dónde está, su número de serie o su garantía.
Guías
Escrituras seguras
Un asistente que puede escribir también puede escribir lo equivocado. Decide qué herramientas necesitan a una persona, reintenta sin duplicar y sabe qué pone en marcha una escritura.
Guías
Errores
Un error de herramienta es un resultado con isError: true y el problema en el primer bloque de texto. Ramifica por su code.

¿Te ha resultado útil esta página?

Resultado

Argumentos

Resultado

La misma operación por REST

Páginas relacionadas

Actualizar una unidad serializada

Escrituras seguras

Errores