import { createAdminClient } from '@spree/admin-sdk'

const client = createAdminClient({
  baseUrl: 'https://your-store.com',
  secretKey: 'sk_xxx',
})

// The supplier will not send the balance: keep what arrived, record why.
const purchaseOrder = await client.purchaseOrders.close('po_1234567890', {
  reason: 'Supplier out of stock',
})

spree api patch /purchase_orders/{id}/close -d '{"reason":"Supplier out of stock"}'

{
  "id": "po_UkLWZg9DAJ",
  "number": "PO1001",
  "status": "received",
  "currency": "USD",
  "reference": null,
  "notes": null,
  "metadata": {},
  "close_reason": "Supplier out of stock",
  "items_count": 1,
  "quantity_received_total": 60,
  "quantity_rejected_total": 0,
  "ordered_at": "2026-01-15T12:00:00.000Z",
  "received_at": "2026-01-15T12:00:00.000Z",
  "closed_short_at": "2026-01-15T12:00:00.000Z",
  "created_at": "2026-01-15T12:00:00.000Z",
  "updated_at": "2026-01-15T12:00:00.000Z",
  "expected_at": "2026-10-01",
  "cancel_by": null,
  "closed_short": true,
  "quantity_ordered_total": 100,
  "editable": false,
  "subtotal": "1250.00",
  "supplier_id": "sup_UkLWZg9DAJ",
  "destination_location_id": "sloc_UkLWZg9DAJ"
}