List Purchase Orders

ดึงรายการใบสั่งซื้อ (Purchase Orders) ทั้งหมดที่ผู้ใช้งานมีสิทธิ์เข้าถึง

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

• ติดตามสถานะการสั่งซื้อวัตถุดิบ
• ซิงค์ข้อมูล Procurement เข้าสู่ระบบ ERP หรือ Accounting
• วิเคราะห์ต้นทุนวัตถุดิบและยอดสั่งซื้อตาม Supplier
• ตรวจสอบ PO ที่ค้างรับสินค้า

Required Scope

read:purchasing

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

---

Endpoint

GET /api/partner/v1/purchase-orders

Request Headers

Authorization: Bearer <access_token>

---

Query Parameters

---

Purchase Order Status

---

Pagination

Endpoint นี้ใช้ Cursor-based Pagination

หาก has_more เป็น true ให้ส่ง next_cursor กลับมาใน parameter cursor

GET /api/partner/v1/purchase-orders?cursor=<next_cursor>

---

Example Request

curl -X GET \
  "https://<host>/api/partner/v1/purchase-orders?from=2026-06-01&to=2026-06-30&status=FULLY_RECEIVED&limit=50" \
  -H "Authorization: Bearer <access_token>"

---

Example Response

{
  "data": [
    {
      "id": "...",
      "po_number": "PO-000001",
      "branch_id": "b1f85720-71cf-420e-a584-e36b75d3fd20",
      "warehouse_id": "1c5e4054-faef-4fb4-b95b-3baeefc2bcb9",
      "supplier_id": "...",
      "order_date": "2026-06-01T00:00:00.000Z",
      "expected_delivery_date": "2026-06-05T00:00:00.000Z",
      "status": "FULLY_RECEIVED",
      "subtotal": "5000",
      "discount_amount": "0",
      "tax_amount": "350",
      "total_amount": "5350",
      "created_at": "2026-06-01T08:00:00.000Z",
      "updated_at": "2026-06-05T10:00:00.000Z",
      "suppliers": {
        "company_name": "บริษัท ABC จำกัด",
        "supplier_code": "SUP-001"
      }
    }
  ],
  "pagination": {
    "next_cursor": null,
    "has_more": false,
    "limit": 50
  }
}

---

PurchaseOrder Object

Monetary Fields

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

Partner ควรใช้ Decimal Library หรือ Big Number Library ในการคำนวณทางการเงิน