Skip to content

08.06 Chapter Summary ​


📌 At a Glance ​

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

🎯 Learning Outcomes ​

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

  • เรียกใช้งาน Order Rejection API ได้
  • ตรวจสอบรายการที่ถูกปฏิเสธตามช่วงวันที่หรือเลขอ้างอิงได้
  • เข้าใจโครงสร้าง Response ของ Order Rejection API
  • ออกแบบ Workflow การแก้ไขข้อมูลในระบบต้นทางได้
  • ลดจำนวนรายการที่ถูกปฏิเสธด้วยแนวทางปฏิบัติที่เหมาะสม

Overview ​

Chapter 8 อธิบายการจัดการรายการที่ถูกปฏิเสธ (Order Rejection) ซึ่งเป็นส่วนสำคัญของกระบวนการเชื่อมต่อข้อมูลระหว่าง Client System และ SISAHYGO

เมื่อรายการไม่ผ่านการตรวจสอบ ระบบจะบันทึกเหตุผลการปฏิเสธและเปิดให้ Client System เรียกข้อมูลผ่าน Order Rejection API เพื่อนำไปแก้ไขข้อมูลในระบบต้นทาง และส่งรายการใหม่เข้าสู่กระบวนการตรวจสอบ

แนวทางนี้ช่วยให้การแลกเปลี่ยนข้อมูลเป็นไปอย่างมีประสิทธิภาพ ลดการประสานงาน และช่วยยกระดับคุณภาพข้อมูลของทั้งสองระบบ


Figure 8-6 Chapter Summary ​

Figure 8-6

Figure 8-6 สรุปภาพรวมของกระบวนการจัดการ Order Rejection ตั้งแต่การส่งข้อมูล การตรวจสอบ การแจ้งผลการปฏิเสธ การแก้ไขข้อมูล และการส่งรายการใหม่เข้าสู่ระบบ


Chapter Overview ​

ตลอดทั้งบท ได้เรียนรู้หัวข้อดังต่อไปนี้

SectionDescription
8.1Order Rejection Overview
8.2Get Order Rejection API
8.3Order Rejection Response Data Model
8.4Order Rejection Workflow
8.5Order Rejection Best Practices

Order Rejection Workflow Summary ​

text
POST /order-checkings

        │

        ▼

Checker Review

        │

        ├────────────► Approved

        │                   │

        │                   ▼

        │             Shipment Process

        │

        ▼

Rejected

        │

        ▼

GET /order-rejections

        │

        ▼

Receive Reason

        │

        ▼

Correct Source Data

        │

        ▼

Submit New Order

        │

        ▼

Checker Review Again

Developer Readiness Checklist ​

ก่อนนำระบบขึ้นใช้งานจริง ควรตรวจสอบว่า

  • [x] เรียก Order Rejection API ได้
  • [x] ใช้ client_reference_no เชื่อมโยงกับเอกสารต้นทาง
  • [x] แสดง reason ให้ผู้ใช้งานเข้าใจ
  • [x] จัดเก็บข้อมูล rejected_at
  • [x] รองรับการค้นหาตามช่วงวันที่
  • [x] บันทึกประวัติการปฏิเสธในระบบของตนเอง
  • [x] มีกระบวนการแก้ไขข้อมูลและส่งรายการใหม่
  • [x] ใช้งานผ่าน HTTPS และจัดการ API Key อย่างปลอดภัย

Key Takeaways ​

TopicRecommendation
Client Referenceใช้ client_reference_no เป็นตัวเชื่อมโยงหลัก
Rejection Reasonแสดงเหตุผลการปฏิเสธให้ผู้ใช้งานทราบ
Source Dataแก้ไขข้อมูลในระบบต้นทางก่อนส่งใหม่
Monitoringตรวจสอบรายการที่ถูกปฏิเสธเป็นประจำ
Loggingบันทึกประวัติการปฏิเสธเพื่อการวิเคราะห์
Validationปรับปรุง Validation ใน Client System อย่างต่อเนื่อง

Production Readiness ​

Client System ควรมีความสามารถดังต่อไปนี้

CapabilityRecommended
Order Rejection API✅
Date Filtering✅
Pagination✅
Rejection Dashboard✅
Source Data Validation✅
Audit Logging✅
Notification✅
HTTPS✅

Common Integration Flow ​

text
Master Data APIs

        │

        ▼

Order Checking API

        │

        ▼

Shipment Tracking API

        │

        ▼

Order Rejection API

        │

        ▼

Client Validation

        │

        ▼

Resubmit Order

หมายเหตุ: ในการใช้งานจริง รายการหนึ่งจะเข้าสู่ Shipment Tracking API (กรณีผ่านการตรวจสอบ) หรือ Order Rejection API (กรณีไม่ผ่านการตรวจสอบ) ไม่ใช่ทั้งสองพร้อมกัน แผนภาพนี้แสดงภาพรวมของ API ที่เกี่ยวข้องในกระบวนการทำงานทั้งหมด


Related Chapters ​

ChapterDescription
Chapter 5Master Data APIs
Chapter 6Order Checking APIs
Chapter 7Shipment Tracking APIs
Chapter 9Error Handling & Response Codes

Summary ​

Order Rejection API เป็นกลไกสำคัญสำหรับการจัดการข้อยกเว้นในกระบวนการเชื่อมต่อข้อมูล ช่วยให้ Client System สามารถรับทราบเหตุผลของการปฏิเสธ แก้ไขข้อมูลในระบบต้นทาง และส่งรายการใหม่ได้อย่างเป็นระบบ การนำแนวทางในบทนี้ไปใช้ร่วมกับ Master Data APIs, Order Checking API และ Shipment Tracking API จะช่วยให้การเชื่อมต่อกับ SISAHYGO มีความถูกต้อง เสถียร และพร้อมสำหรับการใช้งานในระดับ Production


🎓 Chapter 8 Learning Outcomes ​

เมื่อจบบทนี้ คุณสามารถ

  • เรียกใช้งาน Order Rejection API ได้
  • ค้นหารายการที่ถูกปฏิเสธตามเงื่อนไขต่าง ๆ
  • เข้าใจโครงสร้าง Response และความหมายของแต่ละ Field
  • ออกแบบ Workflow การแก้ไขข้อมูลและส่งรายการใหม่
  • ลดจำนวน Order Rejection ด้วยการปรับปรุงคุณภาพข้อมูลและ Validation
  • พัฒนาระบบ Integration ที่รองรับการทำงานจริงในระดับ Production

Next Step ​

➡️ Chapter 9 – Error Handling & Response Codes

SISAHYGO API Integration Guide