List Order Items

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

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

• ดูรายละเอียดสินค้าที่ขายในแต่ละ Order
• คำนวณยอดขายแยกตาม SKU หรือ Product
• วิเคราะห์ Order-level profitability

Required Scope

read:sales

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

---

Endpoint

GET /api/partner/v1/sales/:id/items

Request Headers

Authorization: Bearer <access_token>

Path Parameters

---

Response

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

---

Example Request

curl -X GET \
  "https://<host>/api/partner/v1/sales/4e3509ea-6e79-4243-b861-2d6d96e22af3/items" \
  -H "Authorization: Bearer <access_token>"

---

Example Response

{
  "data": [
    {
      "id": "cd1f8ec8-8da4-4ed9-b2dc-84fcae5fd2bf",
      "product_sku_id": "464e9d4f-f873-4cf2-8ce7-061ce856eb61",
      "sku_code": "",
      "sku_name": "ส้มตำคอหมูย่าง",
      "product_name": "ส้มตำคอหมูย่าง",
      "quantity": "1",
      "unit_price": "120",
      "discount_amount": "0",
      "tax_amount": "7.85",
      "line_total": "120",
      "refunded_quantity": "0",
      "refunded_amount": "0",
      "is_fully_refunded": false,
      "created_at": "2026-06-15T03:22:16.744Z"
    }
  ]
}

---

SalesOrderItem Object

Monetary Fields

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

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

---

Error Responses

Order Not Found

404 Not Found

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

สาเหตุ:

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