Órdenes de compra

Aprobar un pedido de compra

Aprueba el pedido y lo deja en pending.

Herramienta

filmo_purchase_orders_approve

Escriturapurchase-orders:write

purchase-orders:write
120/min
Puede requerir un add-on

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "filmo_purchase_orders_approve",
    "arguments": {
      "purchaseOrderId": "purc_8f2a1c"
    }
  }
}

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

No lleva cuerpo, y es un subrecurso y no un patch de status porque el servidor comprueba el pedido antes de moverlo. Solo se aprueba un borrador con proveedor: cualquier otro estado —también un pedido ya aprobado— responde 409 conflict nombrándolo, y un borrador sin proveedor responde también 409; en ninguno de los dos casos cambia nada. Devuelve el pedido de compra completo, con la misma proyección que su GET.

Argumentos

purchaseOrderIdstringObligatorio

Identificador del pedido de compra.

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