Órdenes de compra

Recibir material de un pedido de compra

Declara qué ha llegado y en qué cantidad, línea por línea.

Herramienta

filmo_purchase_orders_receive

Destructivapurchase-orders:write

purchase-orders:write
120/min
Puede requerir un add-on
Anotación del servidor: Destructiva
Requiere confirmación humana
Envía tu propia idempotencyKey

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "filmo_purchase_orders_receive",
    "arguments": {
      "purchaseOrderId": "purc_8f2a1c",
      "lines": [
        {
          "lineId": "line_8f2a1c",
          "receivedQuantity": 1,
          "newStockReceived": 1,
          "notes": "<notes>"
        }
      ],
      "idempotencyKey": "<a UUID you generate>"
    }
  }
}

{
  "structuredContent": {
    "data": {
      "id": "id_8f2a1c",
      "poNumber": "<poNumber>",
      "status": "draft",
      "type": "subrental",
      "isDraft": true,
      "poDate": "2026-09-01T08:00:00Z",
      "supplierId": "supp_8f2a1c",
      "reference": "<reference>",
      "currency": "EUR",
      "subTotal": "1234.50",
      "discountTotal": "1234.50",
      "taxesPrice": "1234.50",
      "netPrice": "1234.50",
      "grossPrice": "1234.50",
      "totalPaid": "1234.50",
      "orderId": "orde_8f2a1c",
      "orderNumber": "<orderNumber>",
      "projectId": "proj_8f2a1c",
      "repairTicketId": "repa_8f2a1c",
      "notes": "<notes>",
      "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

Envía tu propia idempotencyKey

Un reintento sin la misma clave duplica el efecto. Envía tu propia idempotencyKey (un UUID) y reenvía la misma si reintentas.

Requiere confirmación humana

Pon esta herramienta en la lista de «preguntar antes de ejecutar» de tu cliente. Las anotaciones son pistas que declara el servidor, no garantías: no decidas la aprobación solo por destructiveHint. El servidor marca esta herramienta con _meta["anthropic/requiresUserInteraction"], que los clientes que lo respetan usan para preguntar a una persona antes de cada llamada.

newStockReceived registra inventario NUEVO, así que envía siempre la cabecera Idempotency-Key: sin ella, un reintento duplica el stock. El pedido puede quedar recibido parcialmente. El identificador de la línea es lineId. Devuelve el pedido de compra completo, la misma proyección que su GET. meta.receivedLines indica cuántas líneas declaró la llamada como recibidas. Un pedido en borrador o cancelado responde 409 conflict.

Argumentos

purchaseOrderIdstringObligatorio

Identificador del pedido de compra.

Límites: longitud mín. 1

spaceIdstring

Almacén por el que entra el material. Por defecto, el almacén de la cuenta.

linesobject[]Obligatorio

Líneas recibidas. Al menos una.

Límites: mín. 1 elementos

Mostrar atributos hijos

lines.lineIdstringObligatorio

Línea del pedido de compra que se recibe.

Límites: longitud mín. 1

lines.receivedQuantitynumberObligatorio

Unidades recibidas de esa línea.

Límites: mín. 0

lines.newStockReceivednumber

De los recibidos, cuántos dan de alta inventario nuevo.

Límites: mín. 0

lines.notesstring

Notas de recepción.

Límites: longitud máx. 1000

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 de compra.

poNumberstring | null

Número del pedido de compra; null mientras es un borrador.

statusstring

Estado del pedido de compra.

Opciones disponibles: draft, pending, completed, cancelled

typestring

Tipo de pedido de compra.

Opciones disponibles: subrental, stock_purchase, resale_purchase, consumable_purchase, technician, transport, repair, consignment

isDraftboolean

true si el pedido de compra sigue siendo un borrador.

poDatestring<date-time> | null

Fecha del pedido de compra en ISO 8601 UTC; null si no se ha fijado.

supplierIdstring | null

Identificador del proveedor; null mientras un borrador no tiene proveedor. Resuélvelo contra /api/v1/contacts.

referencestring | null

Referencia de formato libre del pedido de compra; null si no tiene.

currencystring

Moneda del pedido de compra, como código ISO 4217.

subTotalstring

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