Chapter 7

Shipment Tracking APIs

---

07.01 Shipment Tracking Overview

---

📌 At a Glance

รายการ	รายละเอียด
Topic	Shipment Tracking Overview
Difficulty	⭐⭐ Intermediate
Reading Time	8 นาที
Target	Developer, System Integrator
Related APIs	GET /shipments

---

🎯 Learning Objectives

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

• เข้าใจภาพรวมของ Shipment Tracking API
• ติดตามสถานะของรายการจัดส่งผ่าน SISAHYGO
• เข้าใจความสัมพันธ์ระหว่าง Order Checking และ Shipment
• นำข้อมูลสถานะไปแสดงใน Client System ได้

---

Overview

Shipment Tracking API ใช้สำหรับติดตามสถานะของรายการจัดส่งหลังจากสร้าง Order Checking สำเร็จ

เมื่อ Order ผ่านการตรวจสอบโดยพนักงาน SISAHGO ระบบจะเริ่มกระบวนการขนส่ง และมีการอัปเดตสถานะตามลำดับของการดำเนินงาน เช่น การยืนยันรายการ การขึ้นสินค้า การเดินทาง และการส่งมอบสินค้า

Client System สามารถเรียก Shipment Tracking API เพื่อดึงสถานะล่าสุดของรายการ และแสดงผลให้ผู้ใช้งานทราบแบบใกล้เคียงเวลาจริง (Near Real-time)

---

Figure 7-1 Shipment Tracking Overview

Figure 7-1 แสดงภาพรวมของกระบวนการติดตามสถานะสินค้า ตั้งแต่การสร้าง Order Checking การเปลี่ยนสถานะในระบบ SISAHYGO จนถึงการส่งมอบสินค้า

---

Business Purpose

Shipment Tracking API มีวัตถุประสงค์เพื่อ

• ติดตามสถานะการจัดส่งสินค้า
• ลดการสอบถามสถานะผ่านโทรศัพท์หรือช่องทางอื่น
• แสดงข้อมูลล่าสุดให้กับลูกค้าและผู้ปฏิบัติงาน
• เชื่อมโยงสถานะการจัดส่งเข้ากับ ERP, POS หรือ WMS

---

Business Workflow

Create Order Checking

        │

        ▼

Order Checking ID (id)

        │

        ▼

Checker Review

        │

        ▼

Order Confirmed

        │

        ▼

Transportation Process

        │

        ▼

Shipment Tracking API

        │

        ▼

Client System

        │

        ▼

Customer / Operator

---

Shipment Lifecycle

Shipment Tracking API ใช้ติดตามสถานะของรายการตลอดวงจรการขนส่ง

Status	Description
checking	รอพนักงานตรวจสอบ
new	ตรวจสอบข้อมูลเรียบร้อย
confirmed	สร้างใบรับส่งสินค้าแล้ว
loaded	ขึ้นสินค้าขึ้นรถแล้ว
in transit	อยู่ระหว่างการขนส่ง
completed	ส่งมอบสินค้าเรียบร้อย

---

Order Checking ID

Shipment Tracking API ใช้ Order Checking ID (id) เป็นข้อมูลอ้างอิงหลักของรายการ

Order Checking ID จะถูกส่งกลับจาก Create Order Checking API และควรจัดเก็บไว้ใน Client System เพื่อใช้เรียกข้อมูลสถานะในภายหลัง

---

Tracking Information

Shipment Tracking API สามารถใช้แสดงข้อมูล เช่น

• สถานะล่าสุดของรายการ
• วันที่สร้างรายการ
• วันที่ยืนยันรายการ
• วันที่ขึ้นสินค้า
• วันที่ส่งมอบสินค้า
• สาขาต้นทาง
• สาขาปลายทาง

รายละเอียดของข้อมูลตอบกลับจะอธิบายในหัวข้อถัดไป

---

Integration Scenario

ตัวอย่างการใช้งาน

• ERP แสดงสถานะการจัดส่งให้ฝ่ายขาย
• POS ตรวจสอบสถานะก่อนแจ้งลูกค้า
• WMS ติดตามการรับสินค้าปลายทาง
• Customer Portal แสดงสถานะการจัดส่งออนไลน์

---

Best Practices

• จัดเก็บ Order Checking ID (id) ตั้งแต่สร้างรายการ
• เรียก Shipment Tracking API เมื่อต้องการข้อมูลล่าสุด
• แสดงวันที่และเวลาของการอัปเดตล่าสุดใน Client System
• อัปเดตสถานะใน Local Database เพื่อลดการเรียก API ซ้ำ

---

Related APIs

• POST /order-checkings
• GET /shipments
• GET /order-rejections

---

Summary

Shipment Tracking API เป็นบริการสำหรับติดตามสถานะของรายการจัดส่งหลังจากสร้าง Order Checking แล้ว โดยใช้ Order Checking ID (id) เป็นข้อมูลอ้างอิงหลัก ช่วยให้ Client System สามารถแสดงข้อมูลการจัดส่งที่เป็นปัจจุบัน ลดภาระในการสอบถามสถานะ และเชื่อมโยงข้อมูลกับกระบวนการทำงานขององค์กรได้อย่างมีประสิทธิภาพ

---

Next Step

➡️ 07.02 Get Shipment Tracking API