Skip to content

06.08 Chapter Summary ​


📌 At a Glance ​

รายการรายละเอียด
TopicChapter Summary
Difficulty⭐ Beginner
Reading Time5 นาที
TargetDeveloper, System Integrator

🎯 Learning Outcomes ​

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

  • เชื่อมต่อ Order Checking API ได้อย่างถูกต้อง
  • ส่งข้อมูลได้ทั้งแบบ Single Order และ Bulk Orders
  • จัดการ Request และ Response ได้อย่างถูกต้อง
  • ตรวจสอบ Validation และ Error Response ได้
  • เตรียมข้อมูลสำหรับการติดตามสถานะสินค้าในบทถัดไป

Overview ​

Chapter 6 อธิบายการใช้งาน Order Checking API ซึ่งเป็นจุดเริ่มต้นของกระบวนการรับข้อมูลเข้าสู่ระบบ SISAHYGO โดยรองรับการส่งข้อมูลทั้งแบบ Single Order และ Bulk Orders ผ่าน Endpoint เดียวกัน

ระบบจะตรวจสอบความถูกต้องของข้อมูล ยืนยันสิทธิ์การใช้งาน และสร้างรายการตรวจรับสินค้า พร้อมส่งผลลัพธ์กลับในรูปแบบ JSON เพื่อให้ระบบต้นทางสามารถบันทึกหมายเลขอ้างอิงของ SISAHYGO และนำไปใช้ในกระบวนการติดตามสถานะสินค้า


Figure 6-8 Chapter Summary ​

Figure 6-8

Figure 6-8 สรุปภาพรวมของกระบวนการ Order Checking API ตั้งแต่การเตรียมข้อมูล การส่งคำขอ การตรวจสอบข้อมูล การสร้างรายการตรวจรับสินค้า และการส่งผลลัพธ์กลับ เพื่อเชื่อมต่อไปยังขั้นตอนการติดตามสถานะสินค้าใน Chapter 7


📌 Key Point

เมื่อสร้าง Order สำเร็จ ระบบจะส่งกลับ Order ID (id) ซึ่งเป็นรหัสอ้างอิงหลักสำหรับการเรียกใช้ Shipment Tracking API ในบทถัดไป


Chapter Overview ​

ตลอดทั้งบท ได้ศึกษาเนื้อหาดังต่อไปนี้

SectionDescription
6.1Order Checking API Overview
6.2API Endpoint
6.3Request Structure
6.4Request Examples
6.5Response Structure
6.6Response Fields
6.7Validation & Error Handling

Complete Processing Flow ​

text
Business Application

        │

        ▼

Authenticate API Key

        │

        ▼

POST /api/order-checkings

        │

        ▼

Validate Request

        │

        ▼

Validate Master Data

        │

        ▼

Validate Business Rules

        │

        ▼

Create Order Checking

        │

        ▼

Return Response

        │

        ▼

Receive Order ID

        │

        ▼

Shipment Tracking API

Key Deliverables ​

หลังจากเรียกใช้งาน Order Checking API สำเร็จ ระบบต้นทางจะได้รับข้อมูลสำคัญ ได้แก่

DataPurpose
Order ID (id)ใช้ติดตามสถานะสินค้า
Client Reference No.จับคู่ข้อมูลกับระบบต้นทาง
Order Header No.อ้างอิงเอกสารใน SISAHYGO
Order Statusสถานะเริ่มต้นของรายการ
Response Messageผลการประมวลผล

Best Practices Summary ​

  • ใช้ Endpoint เดียวสำหรับ Single และ Bulk Orders
  • ใช้ client_reference_no ที่ไม่ซ้ำกันในทุก Order
  • ตรวจสอบ Master Data ก่อนส่งข้อมูล
  • ตรวจสอบ HTTP Status และ Response ทุกครั้ง
  • บันทึก id ที่ได้รับจาก SISAHYGO
  • เก็บ client_reference_no และ id ไว้คู่กัน
  • Retry เฉพาะรายการที่ไม่สำเร็จในกรณี Bulk Orders

Integration Checklist ​

ก่อนเข้าสู่ขั้นตอนการติดตามสถานะสินค้า ควรตรวจสอบว่า

  • ✅ Authentication ผ่าน
  • ✅ Validation ผ่าน
  • ✅ Order ถูกสร้างเรียบร้อย
  • ✅ ได้รับ Order ID (id)
  • ✅ บันทึกข้อมูลอ้างอิงครบถ้วน

Related Chapters ​

ChapterDescription
Chapter 5Master Data APIs
Chapter 7Shipment Tracking APIs
Chapter 9Error Handling & Response Codes
Chapter 10Best Practices

Summary ​

Order Checking API เป็นหัวใจสำคัญของกระบวนการรับข้อมูลเข้าสู่ SISAHYGO โดยรองรับทั้งการสร้างรายการแบบ Single Order และ Bulk Orders ผ่าน Endpoint เดียว พร้อมกลไกการตรวจสอบข้อมูล การตอบกลับผลลัพธ์ และการจัดการข้อผิดพลาดอย่างเป็นมาตรฐาน เมื่อการสร้างรายการสำเร็จ ระบบจะส่งกลับ Order ID (id) ซึ่งใช้เป็นรหัสอ้างอิงหลักสำหรับการติดตามสถานะสินค้าใน Shipment Tracking API ทำให้ระบบต้นทางสามารถเชื่อมโยงข้อมูลและติดตามกระบวนการขนส่งได้อย่างต่อเนื่อง


Next Step ​

➡️ Chapter 7 – Shipment Tracking API

SISAHYGO API Integration Guide