Skip to content

Chapter 7 ​

Shipment Tracking APIs ​


07.01 Shipment Tracking Overview ​


📌 At a Glance ​

รายการรายละเอียด
TopicShipment Tracking Overview
Difficulty⭐⭐ Intermediate
Reading Time8 นาที
TargetDeveloper, System Integrator
Related APIsGET /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

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


Business Purpose ​

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

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

Business Workflow ​

text
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 ใช้ติดตามสถานะของรายการตลอดวงจรการขนส่ง

StatusDescription
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

SISAHYGO API Integration Guide