*MCP › Referencia › Finanzas › Órdenes de compra* # Recibir material de un pedido de compra > Declara qué ha llegado y en qué cantidad, línea por línea. > **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`. HERRAMIENTA `filmo_purchase_orders_receive` · `purchase-orders:write` · 120/min · Puede requerir un add-on · Anotación del servidor: Destructiva · Requiere confirmación humana · Envía tu propia idempotencyKey ## Argumentos | Nombre | Tipo | Obligatorio | Descripción | | --- | --- | --- | --- | | `purchaseOrderId` | string | Sí | Identificador del pedido de compra. | | `spaceId` | string | No | Almacén por el que entra el material. Por defecto, el almacén de la cuenta. | | `lines` | object[] | Sí | Líneas recibidas. Al menos una. | | `lines.lineId` | string | Sí | Línea del pedido de compra que se recibe. | | `lines.receivedQuantity` | number | Sí | Unidades recibidas de esa línea. | | `lines.newStockReceived` | number | No | De los recibidos, cuántos dan de alta inventario nuevo. | | `lines.notes` | string | No | Notas de recepción. | | `idempotencyKey` | string | No | 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. | | `ifMatch` | string | No | 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. | ## Resultado En un éxito el resultado lleva `structuredContent` con `data` y `meta`. Estos son los atributos de `data`. | Nombre | Tipo | Descripción | | --- | --- | --- | | `id` | string | Identificador único del pedido de compra. | | `poNumber` | string | Número del pedido de compra; null mientras es un borrador. | | `status` | string | Estado del pedido de compra. `draft`, `pending`, `completed`, `cancelled` | | `type` | string | Tipo de pedido de compra. `subrental`, `stock_purchase`, `resale_purchase`, `consumable_purchase`, `technician`, `transport`, `repair`, `consignment` | | `isDraft` | boolean | true si el pedido de compra sigue siendo un borrador. | | `poDate` | string | Fecha del pedido de compra en ISO 8601 UTC; null si no se ha fijado. | | `supplierId` | string | Identificador del proveedor; null mientras un borrador no tiene proveedor. Resuélvelo contra `/api/v1/contacts`. | | `reference` | string | Referencia de formato libre del pedido de compra; null si no tiene. | | `currency` | string | Moneda del pedido de compra, como código ISO 4217. | | `subTotal` | string | Subtotal antes de descuentos e impuestos, como cadena decimal "1234.50". | | `discountTotal` | string | Total de descuentos, como cadena decimal "1234.50". | | `taxesPrice` | string | Total de impuestos, como cadena decimal "1234.50". | | `netPrice` | string | Base imponible, como cadena decimal "1234.50". | | `grossPrice` | string | Total con impuestos, como cadena decimal "1234.50". | | `totalPaid` | string | Importe ya pagado, como cadena decimal "1234.50"; null si no se ha registrado ningún pago. | | `orderId` | string | Pedido de alquiler asociado; null si no tiene. | | `orderNumber` | string | Número de ese pedido; null si no tiene. | | `projectId` | string | Proyecto asociado; null si no tiene. | | `repairTicketId` | string | Ticket de reparación que originó la compra; null si no procede de uno. | | `notes` | string | Notas del pedido de compra; null si no tiene. | | `createdAt` | string | Fecha de creación en ISO 8601 UTC. | | `updatedAt` | string | Fecha de la última modificación en ISO 8601 UTC. | *Llamada · filmo_purchase_orders_receive* ```json { "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": "" } ], "idempotencyKey": "" } } } ``` *Resultado (generado desde el esquema)* ```json { "structuredContent": { "data": { "id": "id_8f2a1c", "poNumber": "", "status": "draft", "type": "subrental", "isDraft": true, "poDate": "2026-09-01T08:00:00Z", "supplierId": "supp_8f2a1c", "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": "", "projectId": "proj_8f2a1c", "repairTicketId": "repa_8f2a1c", "notes": "", "createdAt": "2026-09-01T08:00:00Z", "updatedAt": "2026-09-01T08:00:00Z" }, "meta": { "idempotencyKey": "", "rateLimit": { "limit": 120, "remaining": 119, "reset": 42 } } } } ``` ## La misma operación por REST Esta herramienta ejecuta [`POST /api/v1/purchase-orders/{purchaseOrderId}/receive`](https://docs.filmo.io/es/rest-api/endpoint-reference/purchase-orders/receive-material-from-a-purchase-order). --- URL canónica: https://docs.filmo.io/es/mcp/tools/purchase-orders/filmo-purchase-orders-receive Última actualización: 2026-10-25