List PO Items

ดึงรายการสินค้าทั้งหมดภายใน Purchase Order หนึ่งรายการ

Endpoint นี้เหมาะสำหรับ:

• ดูรายละเอียดสินค้าที่สั่งซื้อและจำนวนที่รับแล้วใน PO นั้น
• ตรวจสอบความครบถ้วนของการรับสินค้า (qty_ordered vs qty_received)
• คำนวณต้นทุนสินค้าแยกตาม SKU

Required Scope

read:purchasing

Access Token ต้องได้รับ Scope read:purchasing มิฉะนั้นระบบจะปฏิเสธคำขอ

---

Endpoint

GET /api/partner/v1/purchase-orders/:id/items

Request Headers

Authorization: Bearer <access_token>

Path Parameters

---

Response

Endpoint นี้คืนรายการสินค้าทั้งหมดใน PO โดยไม่ใช้ Pagination — ข้อมูลทุก item จะอยู่ใน data array เพียง response เดียว

---

Example Request

curl -X GET \
  "https://<host>/api/partner/v1/purchase-orders/PO-UUID-HERE/items" \
  -H "Authorization: Bearer <access_token>"

---

Example Response

{
  "data": [
    {
      "id": "...",
      "product_sku_id": "b55338d0-cf79-4431-996c-e21e84039757",
      "qty_ordered": "10",
      "qty_received": "10",
      "unit_cost": "500",
      "discount_amount": "0",
      "line_total": "5000",
      "notes": null,
      "created_at": "2026-06-01T08:00:00.000Z",
      "product_skus": {
        "sku_code": "SKU-005",
        "sku_name": "แซลมอน 10 ไม้"
      }
    }
  ]
}

---

PurchaseOrderItem Object

Monetary Fields

ฟิลด์จำนวนและมูลค่าทั้งหมดถูกส่งกลับในรูปแบบ Decimal String เพื่อป้องกันปัญหา Floating Point

---

Error Responses

Purchase Order Not Found

404 Not Found

{
  "error": "not_found",
  "message": "Purchase order not found"
}

สาเหตุ:

• id ไม่ถูกต้อง
• PO อยู่นอกขอบเขตสิทธิ์ของ Token (ต่าง business)