10.03 Master Data Synchronization Strategy

---

📌 At a Glance

รายการ	รายละเอียด
Topic	Master Data Synchronization Strategy
Difficulty	⭐⭐ Intermediate
Reading Time	10 นาที
Target	Developer, System Integrator
Related APIs	GET /receivers, GET /products, GET /units

---

🎯 Learning Objectives

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

• ออกแบบการ Synchronize Master Data ได้อย่างมีประสิทธิภาพ
• ลดจำนวนการเรียก API ที่ไม่จำเป็น
• เพิ่มประสิทธิภาพของระบบ Client
• ลดโอกาสเกิด Validation Errors จากข้อมูลอ้างอิงที่ไม่เป็นปัจจุบัน

---

Overview

Master Data เป็นข้อมูลอ้างอิงที่ใช้ในการสร้างรายการตรวจรับสินค้า เช่น ผู้รับสินค้า สินค้า และหน่วยนับ

เพื่อให้ระบบมีประสิทธิภาพ SISAHYGO แนะนำให้ Client System ทำการ Synchronize Master Data มาเก็บไว้ในฐานข้อมูลของตนเอง และอัปเดตข้อมูลเป็นระยะ แทนการเรียก API ทุกครั้งที่ผู้ใช้งานสร้างรายการ

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

---

Figure 10-3 Master Data Synchronization Strategy

Figure 10-3 แสดงแนวทางการ Synchronize ข้อมูล Master Data จาก SISAHYGO API ไปยังฐานข้อมูลของ Client System และการนำข้อมูลดังกล่าวไปใช้งานในกระบวนการสร้างรายการ

---

Master Data APIs

ข้อมูลอ้างอิงที่ควร Synchronize

API	Purpose
GET /receivers	ข้อมูลผู้รับสินค้า
GET /products	ข้อมูลสินค้า
GET /units	ข้อมูลหน่วยนับ

---

Recommended Synchronization Flow

Application Start

        │

        ▼

GET /receivers

        │

        ▼

GET /products

        │

        ▼

GET /units

        │

        ▼

Local Database

        │

        ▼

Business Application

---

Synchronization Architecture

           SISAHYGO API

        Receivers

        Products

        Units

             │

             ▼

      Synchronization Service

             │

             ▼

      Local Database

             │

             ▼

 ERP / POS / WMS / TMS

---

Recommended Synchronization Frequency

Master Data	Recommendation
Receivers	ทุกวัน หรือเมื่อมีการเปลี่ยนแปลงข้อมูล
Products	ทุกวัน หรือเมื่อมีการเพิ่มสินค้าใหม่
Units	เมื่อมีการเปลี่ยนแปลงข้อมูลหน่วยนับ
Manual Sync	เปิดให้ผู้ดูแลระบบสั่ง Synchronize ได้ทันที

---

Local Database Benefits

การจัดเก็บ Master Data ในระบบของ Client มีข้อดีดังนี้

• ลดจำนวน API Calls
• เพิ่มความเร็วในการค้นหาข้อมูล
• ลดภาระของ API Server
• รองรับการทำงานของผู้ใช้งานหลายคนพร้อมกัน
• รองรับการทำงานในช่วงที่เครือข่ายมีความหน่วง

---

Synchronization Best Practices

• Synchronize ข้อมูลตามรอบเวลา (Scheduled Job)
• รองรับ Manual Synchronization
• ใช้ Transaction ในการอัปเดตข้อมูล
• บันทึกเวลาที่ Synchronize ล่าสุด
• ตรวจสอบความสมบูรณ์ของข้อมูลหลังการ Synchronize

---

Example Schedule

Time	Task
ทุกวัน 02:00	Synchronize Receivers
ทุกวัน 02:15	Synchronize Products
ทุกวัน 02:30	Synchronize Units
เมื่อผู้ดูแลร้องขอ	Manual Synchronization

---

Client-side Validation

เมื่อข้อมูลถูก Synchronize มาแล้ว

Client System ควรตรวจสอบ

• Receiver
• Product
• Unit

จากฐานข้อมูลภายในก่อนเรียก API

ซึ่งจะช่วยลด Validation Errors และเพิ่มความเร็วในการทำงาน

---

Common Mistakes

Problem	Recommendation
เรียก Master Data ทุกครั้งที่สร้าง Order	ใช้ Local Database
ไม่ Synchronize ข้อมูลเป็นเวลานาน	ตั้ง Scheduled Job
ไม่มี Manual Sync	เพิ่มปุ่ม Synchronize
ใช้ข้อมูลเก่า	ตรวจสอบเวลาการอัปเดตล่าสุด

---

Related Sections

• 10.02 Recommended API Call Sequence
• 10.04 Caching Strategy
• 10.05 Retry & Recovery Strategy

---

Summary

การ Synchronize Master Data เป็นแนวทางที่แนะนำสำหรับการใช้งาน SISAHYGO API ในระดับ Production โดยช่วยลดจำนวนการเรียก API เพิ่มประสิทธิภาพของระบบ และทำให้ข้อมูลอ้างอิงที่ใช้ในการสร้างรายการมีความถูกต้องและเป็นปัจจุบันอยู่เสมอ การจัดเก็บข้อมูลไว้ในฐานข้อมูลของ Client ควบคู่กับการอัปเดตตามรอบเวลาและการรองรับ Manual Synchronization จะช่วยให้ระบบมีความเสถียรและพร้อมรองรับการใช้งานในระยะยาว

---

Next Step

➡️ 10.04 Caching Strategy