05.01 Master Data Overview

---

📌 At a Glance

รายการ	รายละเอียด
Topic	Master Data Overview
Difficulty	⭐ Beginner
Reading Time	8 นาที
Target	Developer, System Integrator
Related APIs	Products API, Units API, Receivers API

---

🎯 Learning Objectives

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

• เข้าใจบทบาทของ Master Data ใน SISAHYGO Integration Platform
• เข้าใจลำดับการ Synchronize ข้อมูลก่อนเริ่มส่ง Transaction
• เข้าใจความสัมพันธ์ระหว่าง Master Data และ Order Checking APIs
• เลือกใช้ Master Data API ได้อย่างถูกต้อง

---

Overview

Master Data คือข้อมูลอ้างอิง (Reference Data) ที่ Client System จำเป็นต้อง Synchronize จาก SISAHYGO ก่อนเริ่มใช้งาน Transaction APIs

การใช้ข้อมูลอ้างอิงชุดเดียวกันระหว่าง Client System และ SISAHYGO ช่วยลดข้อผิดพลาดจากข้อมูลไม่ตรงกัน ลดการ Reject Order และทำให้การตรวจสอบข้อมูลเป็นไปอย่างถูกต้อง

สำหรับ SISAHYGO API V1.1 มี Master Data APIs จำนวน 3 รายการ

• Products
• Units
• Receivers

โดยแนะนำให้ Synchronize ข้อมูลเหล่านี้ก่อนเริ่มสร้าง Order Checking

---

Figure 5-1 Master Data Overview

Figure 5-1 แสดงภาพรวมการ Synchronize Master Data จาก SISAHYGO ไปยัง Client System ก่อนเริ่มใช้งาน Transaction APIs

---

Master Data APIs

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

---

Why Synchronize Master Data?

Master Data เป็นพื้นฐานของการทำงานทุก Transaction

การ Synchronize อย่างสม่ำเสมอช่วยให้

• ใช้ Product ID ตรงกันทั้งสองระบบ
• ใช้ Unit ID ตรงกันทั้งสองระบบ
• ใช้ Receiver ID ตรงกันทั้งสองระบบ
• ลด Validation Error
• ลดการ Reject Order
• เพิ่มความถูกต้องของข้อมูล

---

Synchronization Workflow

ลำดับที่แนะนำ

1. GET /products

↓

2. GET /units

↓

3. GET /receivers

↓

Update Client Database

↓

Ready for Order Checking APIs

---

Master Data Relationship

Master Data	ใช้ใน API
Products	Order Checking
Units	Order Checking
Receivers	Order Checking

Master Data ทั้งสามชุดจะถูกใช้อ้างอิงเมื่อ Client System ส่งข้อมูลผ่าน POST /order-checkings

---

Recommended Synchronization Strategy

Data	Recommended
Products	Daily หรือเมื่อมีการเปลี่ยนแปลง
Units	Initial Sync และตรวจสอบเป็นระยะ
Receivers	Daily หรือก่อนสร้าง Order

---

Key Concepts

Concept	Description
Master Data	ข้อมูลอ้างอิงที่ใช้ร่วมกัน
Synchronization	การดึงข้อมูลมาอัปเดตใน Client System
Transaction Data	ข้อมูลการทำงาน เช่น Order Checking
Reference Data	ข้อมูลที่ใช้ตรวจสอบความถูกต้อง

---

Implementation Notes

• Synchronize Master Data ก่อนใช้งาน Transaction APIs
• ไม่ควรสร้าง Product หรือ Unit เองใน Client System
• Receiver ควรอัปเดตเป็นประจำ เนื่องจากอาจมีผู้รับรายใหม่
• ใช้ ID ที่ได้รับจาก SISAHYGO เป็นข้อมูลอ้างอิงหลัก

---

Best Practices

• Synchronize Master Data ทุกวัน
• เก็บข้อมูลไว้ใน Local Database เพื่อเพิ่มประสิทธิภาพ
• อัปเดตเฉพาะข้อมูลที่เปลี่ยนแปลง หากระบบรองรับ
• ตรวจสอบความสมบูรณ์ของข้อมูลหลัง Synchronize ทุกครั้ง

---

Related APIs

• 05.02 Products API
• 05.03 Units API
• 05.04 Receivers API
• Chapter 6 Order Checking APIs

---

Summary

Master Data เป็นจุดเริ่มต้นของการเชื่อมต่อ SISAHYGO Integration Platform

การ Synchronize Products, Units และ Receivers ให้เป็นปัจจุบันก่อนใช้งาน Transaction APIs จะช่วยลดข้อผิดพลาด เพิ่มความถูกต้องของข้อมูล และทำให้การสร้าง Order Checking เป็นไปอย่างมีประสิทธิภาพ

---

Next Step

➡️ 05.02 Products API