บทที่ 1 : บทนำ (Introduction)

At a Glance

รายการ	รายละเอียด
Platform	SISAHYGO Integration Platform
Main Purpose	เชื่อมต่อ Client System กับ SISAHYGO TMS
API Style	REST API
Protocol	HTTPS
Data Format	JSON
Authentication	API Key
Current Version	API V1.1
Primary Users	Developer, System Integrator, IT Administrator

---

ภาพรวม (Overview)

ยินดีต้อนรับสู่ SISAHYGO Integration Platform

SISAHYGO Integration Platform คือแพลตฟอร์มสำหรับเชื่อมต่อข้อมูลระหว่าง Client System กับระบบบริหารจัดการงานขนส่ง SISAHYGO Transportation Management System (TMS) ผ่านมาตรฐาน REST API, HTTPS และ JSON

แพลตฟอร์มนี้ได้รับการออกแบบให้รองรับการเชื่อมต่อกับระบบงานของลูกค้าได้หลากหลาย เช่น ERP, POS, WMS, ระบบบัญชี, ระบบขายออนไลน์ รวมถึงระบบที่พัฒนาขึ้นเอง โดยไม่จำกัดภาษาในการพัฒนาโปรแกรม (Programming Language) หรือฐานข้อมูล (Database)

การเชื่อมต่อผ่าน API ช่วยลดการทำงานซ้ำซ้อน ลดความผิดพลาดจากการป้อนข้อมูลด้วยมือ (Manual Data Entry) และทำให้ข้อมูลระหว่างระบบสามารถแลกเปลี่ยนกันได้แบบอัตโนมัติ (Automation)

---

วัตถุประสงค์ของเอกสาร (Objectives)

เอกสารฉบับนี้จัดทำขึ้นเพื่อเป็นคู่มือสำหรับนักพัฒนาระบบ (Developer) และผู้ดูแลระบบ (System Administrator) ที่ต้องการเชื่อมต่อ Client System เข้ากับ SISAHYGO Integration Platform

ภายในเอกสารจะอธิบายตั้งแต่แนวคิดของระบบ มาตรฐานการเชื่อมต่อ ขั้นตอนการพัฒนา ไปจนถึงตัวอย่างการใช้งาน API พร้อมแนวทางปฏิบัติ (Best Practices) เพื่อให้สามารถพัฒนาระบบเชื่อมต่อได้อย่างถูกต้องและมีประสิทธิภาพ

---

สิ่งที่ผู้อ่านจะได้รับ

หลังจากศึกษาคู่มือฉบับนี้ ผู้อ่านจะสามารถ

• เข้าใจโครงสร้างของ SISAHYGO Integration Platform
• เข้าใจหลักการทำงานของ REST API
• เชื่อมต่อ Client System กับ SISAHYGO ได้อย่างถูกต้อง
• ใช้งาน Authentication และ API Key ได้อย่างปลอดภัย
• Synchronize ข้อมูล Master Data ระหว่างสองระบบ
• ส่งข้อมูล Order Checking ผ่าน API
• ตรวจสอบสถานะการขนส่งผ่าน Shipment Tracking API
• จัดการกรณี Order Rejection ได้อย่างถูกต้อง
• วิเคราะห์และแก้ไขข้อผิดพลาดจาก Error Code ต่าง ๆ ได้
• นำตัวอย่างจาก Postman Collection ไปประยุกต์ใช้กับระบบจริง

---

จุดเด่นของ SISAHYGO Integration Platform

SISAHYGO Integration Platform ได้รับการออกแบบภายใต้แนวคิด API First เพื่อให้สามารถเชื่อมต่อกับระบบงานของลูกค้าได้ง่าย รวดเร็ว และรองรับการขยายระบบในอนาคต

จุดเด่นของแพลตฟอร์ม ได้แก่

• รองรับมาตรฐาน REST API
• ใช้ JSON เป็นรูปแบบการแลกเปลี่ยนข้อมูล
• ใช้ HTTPS เพื่อความปลอดภัยของข้อมูล
• รองรับการเชื่อมต่อจากทุก Programming Language
• รองรับทุก Database และทุกระบบที่สามารถเรียก HTTP API ได้
• ออกแบบให้แยก Business Logic ออกจาก Client System
• สามารถเชื่อมต่อกับ ERP, POS, WMS, Accounting และระบบอื่น ๆ ได้
• มี Postman Collection สำหรับทดสอบ API พร้อมใช้งาน
• มีเอกสาร API Specification และตัวอย่างการใช้งานครบถ้วน

---

กลุ่มผู้อ่าน (Target Audience)

เอกสารฉบับนี้เหมาะสำหรับ

• Software Developer
• System Integrator
• ERP Developer
• Technical Consultant
• Solution Architect
• IT Administrator
• Project Manager

---

เวอร์ชันของเอกสาร

รายการ	รายละเอียด
Document	SISAHYGO API Developer Guide
API Version	V1.1
Document Version	1.0
Language	ภาษาไทย
Last Updated	กรกฎาคม 2026

---

เอกสารที่เกี่ยวข้อง

เอกสารชุด SISAHYGO Documentation ประกอบด้วย

• API Specification
• Integration Guide
• Administrator Guide
• Postman Collection
• Release Notes
• Sales & Marketing Guide

---

เส้นทางการเรียนรู้ (Learning Path)

แนะนำให้อ่านเอกสารตามลำดับดังนี้

1. บทที่ 1 : บทนำ (Introduction)
2. บทที่ 2 : ภาพรวมระบบ (System Overview)
3. บทที่ 3 : มาตรฐานการพัฒนา API (API Standards)
4. บทที่ 4 : Authentication
5. บทที่ 5 : Master Data APIs
6. บทที่ 6 : Order Checking APIs
7. บทที่ 7 : Shipment Tracking APIs
8. บทที่ 8 : Order Rejection APIs
9. บทที่ 9 : Error Handling
10. บทที่ 10 : Integration Best Practices Appendix A -- Complete API Endpoint Reference Appendix B -- Complete Request & Response Examples Appendix C -- HTTP Status & Error Code Reference Appendix D -- Glossary

---

บทถัดไป

➡️ 01.02 - เกี่ยวกับ SISAHYGO (About SISAHYGO)