Skip to content

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


📌 At a Glance ​

รายการรายละเอียด
TopicIntegration Workflow
Difficulty⭐⭐ Intermediate
Reading Time12 นาที
TargetDeveloper, System Integrator
Related APIsAll 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

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


Integration Workflow ​

Phase 1 : Initial Setup ​

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

StepAPIPurpose
1API KeyAuthentication
2GET /productsSynchronize Product
3GET /receiversSynchronize Receiver

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


Phase 2 : Daily Operations ​

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

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

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 ​

RecommendationReason
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

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

Next Step ​

➡️ 02.06 API Overview

SISAHYGO API Integration Guide