06.04 Request Examples

---

📌 At a Glance

รายการ	รายละเอียด
Topic	Request Examples
Difficulty	⭐⭐ Intermediate
Reading Time	12 นาที
Target	Developer, System Integrator
HTTP Method	POST

---

🎯 Learning Objectives

หลังจากศึกษาหัวข้อนี้แล้ว ผู้อ่านจะสามารถ

• สร้าง Request สำหรับ Single Order ได้
• สร้าง Request สำหรับ Bulk Orders ได้
• เข้าใจรูปแบบ JSON ที่ถูกต้อง
• นำตัวอย่างไปทดสอบผ่าน Postman ได้ทันที

---

Overview

Order Checking API รองรับการส่งข้อมูลทั้งแบบ Single Order และ Bulk Orders ผ่าน Endpoint เดียวกัน (POST /api/order-checkings)

ตัวอย่างในหัวข้อนี้เป็น JSON ที่สามารถนำไปใช้กับ Postman หรือระบบของผู้พัฒนาได้โดยตรง

---

Figure 6-4 Request Examples

Figure 6-4 เปรียบเทียบตัวอย่าง Request สำหรับ Single Order และ Bulk Orders โดยแสดงให้เห็นว่าแต่ละ Order ใช้โครงสร้างข้อมูลเดียวกัน แตกต่างกันเฉพาะระดับบนสุดของ Request

---

📌 Key Point

Bulk Orders ใช้ข้อมูลของแต่ละ Order เหมือนกับ Single Order ทุกประการ เพียงแต่รวมหลาย Order ไว้ภายใน Request เดียว

---

Example 1 : Single Order Request

POST /api/order-checkings

{
  "client_reference_no": "ERP-20260704-0001",
  "customer_rec_id": 1657281,
  "order_header_date": "2026-07-04",
  "remark": "API Test",

  "items": [
    {
      "product_id": 101,
      "unit_id": 1,
      "amount": 10,
      "remark": ""
    },
    {
      "product_id": 102,
      "unit_id": 1,
      "amount": 5,
      "remark": ""
    }
  ]
}

---

Example 2 : Bulk Orders Request

POST /api/order-checkings

{
  "orders": [
    {
      "client_reference_no": "ERP-20260704-0001",
      "customer_rec_id": 1657281,
      "order_header_date": "2026-07-04",
      "remark": "Order 1",

      "items": [
        {
          "product_id": 101,
          "unit_id": 1,
          "amount": 10
        }
      ]
    },

    {
      "client_reference_no": "ERP-20260704-0002",
      "customer_rec_id": 1657281,
      "order_header_date": "2026-07-04",
      "remark": "Order 2",

      "items": [
        {
          "product_id": 103,
          "unit_id": 1,
          "amount": 3
        },
        {
          "product_id": 104,
          "unit_id": 1,
          "amount": 8
        }
      ]
    }
  ]
}

---

Request Comparison

Item	Single Order	Bulk Orders
Endpoint	/api/order-checkings	/api/order-checkings
HTTP Method	POST	POST
JSON Root	Order Object	orders[]
Orders per Request	1	หลายรายการ
Items per Order	หลายรายการ	หลายรายการ
Authentication	API Key	API Key

---

JSON Structure Comparison

Single Order

Request

└── Order

      ├── Header

      └── Items[]

Bulk Orders

Request

└── Orders[]

      ├── Order

      │     ├── Header

      │     └── Items[]

      ├── Order

      └── Order

---

Best Practices

• ใช้ Single Order สำหรับ Real-time Integration
• ใช้ Bulk Orders สำหรับ Batch Processing
• ใช้ client_reference_no ที่ไม่ซ้ำกันในทุก Order
• ส่งข้อมูลที่ผ่านการตรวจสอบจาก Master Data แล้ว
• ตรวจสอบ Response ของทุก Request ก่อนดำเนินการขั้นตอนถัดไป

---

Related Sections

• 06.03 Request Structure
• 06.05 Response Structure
• Chapter 5 Master Data APIs

---

Summary

Request ของ Order Checking API มี 2 รูปแบบ คือ Single Order และ Bulk Orders โดยใช้ Endpoint เดียวกันและใช้โครงสร้างข้อมูลของแต่ละ Order เหมือนกันทั้งหมด ความแตกต่างอยู่ที่ Bulk Orders จะรวมหลาย Order ไว้ภายใน Request เดียว ซึ่งช่วยลดจำนวน API Calls และเพิ่มประสิทธิภาพในการรับส่งข้อมูลระหว่างระบบ

---

Next Step

➡️ 06.05 Response Structure