List Suppliers

ดึงรายการ Supplier ทั้งหมดของธุรกิจ

Suppliers เป็นข้อมูลระดับ Business ไม่แยกตามสาขา — ทุก Token ที่มี Scope read:purchasing จะเห็น Supplier ทั้งหมดของธุรกิจ

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

• ซิงค์ข้อมูล Supplier เข้าสู่ระบบ ERP หรือ Accounting
• อ้างอิง supplier_id สำหรับ filter ใน List Purchase Orders
• สร้าง Supplier Directory ในระบบภายนอก

Required Scope

read:purchasing

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

---

Endpoint

GET /api/partner/v1/suppliers

Request Headers

Authorization: Bearer <access_token>

---

Query Parameters

---

Pagination

Endpoint นี้ใช้ Cursor-based Pagination

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

GET /api/partner/v1/suppliers?cursor=<next_cursor>

---

Example Request

curl -X GET \
  "https://<host>/api/partner/v1/suppliers?status=ACTIVE&limit=50" \
  -H "Authorization: Bearer <access_token>"

---

Example Response

{
  "data": [
    {
      "id": "...",
      "supplier_code": "SUP-001",
      "company_name": "บริษัท ABC จำกัด",
      "contact_name": "คุณสมชาย",
      "phone_number": "02-000-0000",
      "email": "contact@abc.co.th",
      "tax_id": "0123456789012",
      "address": "123 ถนนสุขุมวิท",
      "city": "กรุงเทพมหานคร",
      "province": "กรุงเทพมหานคร",
      "postal_code": "10110",
      "country": "Thailand",
      "payment_terms": "Net 30",
      "status": "ACTIVE",
      "created_at": "2026-05-01T00:00:00.000Z",
      "updated_at": "2026-05-01T00:00:00.000Z"
    }
  ],
  "pagination": {
    "next_cursor": null,
    "has_more": false,
    "limit": 50
  }
}

---

Supplier Object