02.05 กระบวนการเชื่อมต่อระบบ (Integration Workflow)

---

📌 At a Glance

รายการ	รายละเอียด
Topic	Integration Workflow
Difficulty	⭐⭐ Intermediate
Reading Time	12 นาที
Target	Developer, System Integrator
Related APIs	All Integration APIs

---

⏱ Reading Time

ประมาณ 12 นาที

---

🎯 Learning Objectives

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

• เข้าใจลำดับการเชื่อมต่อระบบระหว่าง Client System และ SISAHYGO
• เข้าใจว่า API แต่ละตัวถูกเรียกเมื่อใด
• เข้าใจขั้นตอนการ Synchronize ข้อมูล
• เข้าใจลำดับการทำงานตั้งแต่เริ่มต้นจนสิ้นสุดการจัดส่ง

---

Overview

การเชื่อมต่อระหว่าง Client System และ SISAHYGO ถูกออกแบบให้เป็น Workflow ที่ชัดเจน โดยแบ่งออกเป็น 3 ระยะหลัก

• Initial Setup
• Daily Operations
• Shipment Tracking

การแบ่งลำดับการทำงานเช่นนี้ช่วยให้การเชื่อมต่อระบบมีความง่ายต่อการพัฒนา และสามารถรองรับการขยายระบบในอนาคตได้

---

Business Value

Workflow มาตรฐานช่วยให้

• ลดข้อผิดพลาดในการพัฒนา Integration
• ลดการเรียก API ที่ไม่จำเป็น
• ทำให้ทุก Client ใช้มาตรฐานเดียวกัน
• ง่ายต่อการ Support และ Troubleshooting
• รองรับการส่งข้อมูลหลายรายการในคำขอเดียว (Bulk Submission) ช่วยลดจำนวน API Calls และเพิ่มประสิทธิภาพของการเชื่อมต่อ

---

Figure 2-5 Integration Workflow

(แทรกรูป Figure 2-5 : Integration Workflow Diagram)

Figure 2-5 แสดงลำดับการเชื่อมต่อระหว่าง Client System และ SISAHYGO ตั้งแต่การเตรียม Master Data การสร้าง Order Checking การตรวจรับสินค้า การออกใบรับส่งสินค้า การติดตามสถานะ และการส่งมอบสินค้า

---

Integration Workflow

Phase 1 : Initial Setup

ดำเนินการเพียงครั้งเดียวก่อนเริ่มใช้งาน

Step	API	Purpose
1	API Key	Authentication
2	GET /products	Synchronize Product
3	GET /receivers	Synchronize Receiver

หลังจากข้อมูล Master Data ถูก Synchronize แล้ว Client System สามารถเริ่มส่ง Transaction ได้

---

Phase 2 : Daily Operations

เป็นกระบวนการที่ใช้งานทุกวัน

Step	API	Purpose
1	POST /order-checkings	ส่งรายการเข้าตรวจสอบ
2	Internal	Checker ตรวจสอบ
3	Internal	ออกใบรับส่งสินค้า
4	Internal	จัดเที่ยวรถ

---

Phase 3 : Shipment Tracking

หลังจากออกใบรับส่งสินค้าแล้ว

Client System สามารถติดตามสถานะผ่าน

GET /shipments

จนกระทั่งสถานะเป็น

completed

---

Business Scenario

บริษัท ABC

เริ่มใช้งานวันแรก

↓

Synchronize Products

↓

Synchronize Receivers

↓

เปิดใช้งานระบบ

ทุกวัน

↓

POST Order Checking

↓

Checker

↓

Confirmed

↓

Shipment

↓

GET Shipments

↓

Completed

---

Integration Checklist

ก่อน Go-Live

ตรวจสอบว่า

• Master Data Synchronize แล้ว
• API Key ทำงานได้
• Order Checking ผ่านการทดสอบ
• Shipment Tracking แสดงผลถูกต้อง
• Error Handling ครบทุกกรณี

---

IMPORTANT

Client System ไม่จำเป็นต้องเรียก API ทุกตัวทุกวัน

หลังจาก Synchronize Master Data แล้ว

API ที่ใช้งานเป็นประจำมีเพียง

• POST /order-checkings
• GET /shipments
• GET /order-rejections (กรณีเกิด Reject)

---

Key Concepts

คำศัพท์	ความหมาย
Initial Setup	การติดตั้งครั้งแรก
Daily Operations	การทำงานประจำวัน
Shipment Tracking	การติดตามสถานะ
Synchronization	การปรับข้อมูลให้ตรงกัน

---

Best Practices

Recommendation	Reason
Synchronize Master Data ทุกวัน	ลด Validation Error
เก็บ Client Reference Number	เชื่อมโยงข้อมูลได้ง่าย
ใช้ Tracking API แทน Manual	ลดภาระการสอบถาม
Log ทุก Request	ช่วยในการตรวจสอบย้อนหลัง

---

Summary

Integration Workflow ของ SISAHGO ถูกออกแบบให้เรียบง่าย โดยแบ่งเป็น Initial Setup, Daily Operations และ Shipment Tracking ทำให้ Developer สามารถพัฒนาระบบได้อย่างเป็นลำดับ และลดความซับซ้อนในการเชื่อมต่อ

---

Ready for Next Chapter

• [ ] เข้าใจ Integration Workflow
• [ ] เข้าใจ Phase ของการเชื่อมต่อ
• [ ] เข้าใจ API ที่ต้องเรียกในแต่ละช่วง
• [ ] พร้อมศึกษาภาพรวมของ API ทั้งหมด

---

References

• Order Checking API
• Shipment Tracking API
• Authentication Guide

---

Related Chapters

• 02.03 System Architecture
• 02.04 Order Lifecycle
• Chapter 4 Authentication
• Chapter 5 Master Data APIs

---

Next Step

➡️ 02.06 API Overview