Pedidos

Reservar un pedido

Pasa el pedido a reserved: comprueba el stock de cada línea, lo descuenta y crea las tareas de entrega y devolución.

Herramienta

filmo_orders_reserve

Escrituraorders:write

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "filmo_orders_reserve",
    "arguments": {
      "orderId": "orde_8f2a1c"
    }
  }
}

{
  "structuredContent": {
    "data": {
      "id": "id_8f2a1c",
      "orderNumber": "<orderNumber>",
      "externalReference": "<externalReference>",
      "status": "draft",
      "startDate": "2026-09-01T08:00:00Z",
      "endDate": "2026-09-01T08:00:00Z",
      "rentalDays": 1,
      "projectId": "proj_8f2a1c",
      "projectName": "Example",
      "contact": {
        "id": "id_8f2a1c",
        "name": "Example"
      },
      "itemsCount": 1,
      "subTotalPrice": "1234.50",
      "discountTotal": "1234.50",
      "insuranceTotal": "1234.50",
      "depositTotal": "1234.50",
      "taxesPrice": "1234.50",
      "netPrice": "1234.50",
      "grossPrice": "1234.50",
      "tags": [
        {
          "id": "id_8f2a1c",
          "name": "Example"
        }
      ],
      "customFields": {
        "key": "<key>"
      },
      "source": "<source>",
      "createdAt": "2026-09-01T08:00:00Z",
      "updatedAt": "2026-09-01T08:00:00Z",
      "billingAddress": {
        "label": "Example",
        "addressLine1": "<addressLine1>",
        "addressLine2": "<addressLine2>",
        "city": "<city>",
        "province": "<province>",
        "postcode": "<postcode>",
        "country": "ES"
      },
      "shippingAddress": {
        "label": "Example",
        "addressLine1": "<addressLine1>",
        "addressLine2": "<addressLine2>",
        "city": "<city>",
        "province": "<province>",
        "postcode": "<postcode>",
        "country": "ES"
      },
      "contactPerson": {
        "id": "id_8f2a1c",
        "name": "Example"
      },
      "quotes": [
        {
          "id": "id_8f2a1c",
          "number": "<number>",
          "status": "<status>"
        }
      ],
      "invoices": [
        {
          "id": "id_8f2a1c",
          "number": "<number>",
          "status": "<status>"
        }
      ],
      "proformas": [
        {
          "id": "id_8f2a1c",
          "number": "<number>",
          "status": "<status>"
        }
      ]
    },
    "meta": {
      "idempotencyKey": "<the key you sent, or the one the server generated>",
      "rateLimit": {
        "limit": 120,
        "remaining": 119,
        "reset": 42
      }
    }
  }
}

generado desde el esquema

No lleva cuerpo. Si no hay stock suficiente responde 409 insufficient_stock, y errors[] lleva una entrada por cada artículo o espacio que falta (path es items o spaces, con itemId, requested, available y shortfall). Un número de serie ya asignado a otro pedido, un pedido que no es un borrador (prepared_partially, prepared, picked_up_partially, picked_up, returned_partially, returned, checked_in_partially, checked_in o cancelled: el problema nombra su estado), una línea de venta sin almacén de origen u otra escritura en curso sobre el pedido responden 409 conflict. En todos los casos no se reserva nada. 404 si el pedido no existe, pertenece a otra cuenta o está archivado. Reservar un pedido que ya está reservado no es un error: no cambia nada y responde 200 con meta.tasksCreated 0 (o las tareas de entrega y devolución que tuvo que restaurar, si faltaban algunas). meta.tasksCreated indica cuántas tareas nacieron, porque tu agenda cambia con esta llamada. Se deshace con /unreserve. Devuelve el pedido completo, la misma proyección que su GET.

Argumentos

orderIdstringObligatorio

Identificador del pedido.

Límites: longitud mín. 1

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

orderNumberstring

Número de pedido legible.

externalReferencestring | null

Referencia externa del pedido (por ejemplo, del sistema del cliente); null si no consta.

statusstring

Estado bruto del pedido tal como se almacena en la base de datos (12 valores): draft, reserved, prepared_partially, prepared, picked_up_partially, picked_up, returned_partially, returned, checked_in_partially, checked_in, archived o cancelled. archived forma parte del conjunto almacenado, pero un pedido archivado no es visible para la API, así que no lo observarás.

Opciones disponibles: draft, reserved, prepared_partially, prepared, picked_up_partially, picked_up, returned_partially, returned, checked_in_partially, checked_in, archived, cancelled

startDatestring<date-time>

Inicio del periodo de alquiler en ISO 8601 con desplazamiento.

endDatestring<date-time>

Fin del periodo de alquiler en ISO 8601 con desplazamiento.

rentalDaysnumber | null

Número de días de alquiler facturables; null si no se ha calculado.

projectIdstring | null

Identificador del proyecto al que pertenece el pedido; null si no está vinculado.

projectNamestring | null

Nombre del proyecto al que pertenece el pedido; null si no está vinculado.

contactobject | null

Referencia compacta al contacto del pedido; null si no hay.

Mostrar atributos hijos

contact.idstring

Identificador único del contacto.

contact.namestring

Nombre del contacto.

itemsCountinteger

Número de artículos del pedido.

subTotalPricestring

Subtotal antes de descuentos e impuestos, como cadena decimal "1234.50" (ROUND_HALF_UP).