Órdenes de compra

Obtener una orden de compra

Devuelve el detalle de un pedido de compra por su identificador.

Herramienta

filmo_purchase_orders_get

Lecturapurchase-orders:read

purchase-orders:read
120/min
Puede requerir un add-on
Anotación del servidor: Solo lectura
Anotación del servidor: Idempotente

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "filmo_purchase_orders_get",
    "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": {
      "rateLimit": {
        "limit": 120,
        "remaining": 119,
        "reset": 42
      },
      "etag": "\"3sT3d9pBvZq4h2N0w8x1YkLmQ7c\""
    }
  }
}

generado desde el esquema

Argumentos

purchaseOrderIdstringObligatorio

Identificador del pedido de compra.

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