วิธีใช้ API ติดตามการจัดส่งเพื่อส่งการแจ้งเตือนการจัดส่งล่วงหน้า
หากต้องการส่งการแจ้งเตือนการจัดส่งเชิงรุกด้วย shipment tracking API ให้เชื่อมโยงพัสดุแต่ละชิ้นกับคำสั่งซื้อ รับข้อมูลอัปเดตการติดตาม แปลงข้อมูลเหล่านั้นเป็นเหตุการณ์ที่เกี่ยวข้องกับลูกค้า และทริกเกอร์ข้อความผ่านบริการอีเมล SMS หรือการแจ้งเตือนในแอปของคุณ วางคิวที่คงทนและการตรวจสอบข้อมูลซ้ำระหว่างข้อมูลการติดตามขาเข้ากับข้อความขาออก เพื่อไม่ให้การอัปเดตที่ซ้ำหรือมาถึงล่าช้าสร้างการแจ้งเตือนที่ทำให้สับสน

คู่มือนี้จัดทำขึ้นสำหรับนักพัฒนาและทีมปฏิบัติการอีคอมเมิร์ซที่กำลังสร้างเวิร์กโฟลว์ดังกล่าว เป้าหมายไม่ใช่การส่งต่อข้อมูลการสแกนจากผู้ให้บริการขนส่งทุกครั้ง แต่คือการบอกลูกค้าว่าเกิดการเปลี่ยนแปลงที่มีความหมายเมื่อใด การเปลี่ยนแปลงนั้นหมายถึงอะไร และลูกค้าจำเป็นต้องดำเนินการหรือไม่
ออกแบบเวิร์กโฟลว์การแจ้งเตือนก่อนเชื่อมต่อ API
Shipment tracking API จะให้ข้อมูลการติดตาม ส่วนแอปพลิเคชันของคุณเป็นผู้ตัดสินใจว่าจะนำข้อมูลนั้นไปใช้อย่างไร ควรถือว่าการมองเห็นสถานะการจัดส่งและการสื่อสารกับลูกค้าเป็นหน้าที่แยกจากกัน แม้ว่าบริการที่เลือกจะมีทั้งสองความสามารถก็ตาม
สถาปัตยกรรมที่ใช้งานได้จริงมี 6 ขั้นตอน:
- การเชื่อมโยงคำสั่งซื้อ: เชื่อมหมายเลขติดตามและรหัสผู้ให้บริการขนส่ง (หากจำเป็น) กับระเบียนการจัดส่งภายใน
- การลงทะเบียนการติดตาม: ส่งหรือลงทะเบียนการจัดส่งตามข้อกำหนดการเชื่อมต่อของผู้ให้บริการ
- การรับข้อมูลอัปเดต: รับ callback ผ่าน webhook ดึงข้อมูลอัปเดตผ่านคำขอ API หรือใช้ทั้งสองวิธีร่วมกัน
- การประมวลผลเหตุการณ์: ตรวจสอบ ปรับรูปแบบ กำจัดข้อมูลซ้ำ และประเมินเหตุการณ์ขาเข้า
- การตัดสินใจแจ้งเตือน: เลือกว่าจะส่งการแจ้งเตือนหรือไม่ ติดต่อใคร และใช้ช่องทางกับเทมเพลตใด
- การส่งข้อความ: ส่งการแจ้งเตือนและบันทึกการตอบกลับจากบริการส่งข้อความ
เก็บข้อมูลติดต่อของลูกค้าไว้ในระบบคำสั่งซื้อหรือระบบส่งข้อความของคุณเอง เว้นแต่การเชื่อมต่อจะจำเป็นต้องแชร์ข้อมูลดังกล่าวจริง ๆ โดยทั่วไปบริการติดตามไม่จำเป็นต้องใช้ที่อยู่อีเมลของลูกค้าเพียงเพื่อให้แอปพลิเคชันเชื่อมโยงเหตุการณ์การติดตามกับคำสั่งซื้อ
1. ยืนยันข้อตกลงการเชื่อมต่อ
ก่อนเขียนตัวรับข้อมูล ให้ตรวจสอบเอกสารของผู้ให้บริการเกี่ยวกับการยืนยันตัวตน การลงทะเบียนการจัดส่ง การระบุผู้ให้บริการขนส่ง วิธีการอัปเดตที่รองรับ รูปแบบการตอบกลับ ขีดจำกัดคำขอ และการจัดการข้อผิดพลาด สำหรับการเชื่อมต่อแบบ webhook ให้ตรวจสอบด้วยว่า callback ได้รับการยืนยันตัวตนอย่างไร การตอบกลับแบบใดถือเป็นการยืนยันการรับข้อมูล และจัดการการส่งที่ไม่สำเร็จอย่างไร
สำหรับการใช้งาน 17TRACK ให้เริ่มจากหน้า 17TRACK Tracking API และ เอกสาร API อย่างเป็นทางการ ใช้ข้อตกลงที่ระบุไว้ในเอกสารสำหรับการเชื่อมต่อ แทนการถือว่าชื่อฟิลด์ตัวอย่างในคู่มือนี้เป็นฟิลด์คำขอหรือการตอบกลับของ 17TRACK ตรวจสอบการตั้งค่า callback ข้อกำหนดด้านความปลอดภัย และขีดจำกัดเฉพาะบัญชีก่อนเริ่มใช้งาน
เลือกวิธีรับข้อมูลอัปเดตตามข้อตกลงการเชื่อมต่อ:
- Webhooks: ใช้ callback เมื่อรองรับและเหมาะสมกับโครงสร้างพื้นฐานของคุณ วิธีนี้ช่วยให้แอปพลิเคชันประมวลผลข้อมูลเมื่อผู้ให้บริการส่งมา โดยไม่ต้องร้องขอข้อมูลการจัดส่งเดิมซ้ำ ๆ
- Polling: ดึงข้อมูลการติดตามตามกำหนดเวลาเมื่อ callback ไม่พร้อมใช้งานหรือไม่เหมาะสม โดยกำหนดตารางเวลาให้อยู่ภายในขีดจำกัดคำขอที่ระบุไว้
- แนวทางแบบผสม: ใช้ callback สำหรับการประมวลผลปกติ และดึงข้อมูลผ่าน API เฉพาะรายการเพื่อกระทบยอดการจัดส่งที่ดูเหมือนข้อมูลไม่อัปเดต หากผู้ให้บริการรองรับเวิร์กโฟลว์นี้
อย่าสัญญากับลูกค้าว่าจะได้รับการแจ้งเตือนทันทีเพียงเพราะคุณใช้ webhook แอปพลิเคชันไม่สามารถรายงานเหตุการณ์จากผู้ให้บริการขนส่งก่อนที่ข้อมูลการติดตามต้นทางจะพร้อมใช้งาน
2. สร้างระเบียนการจัดส่งที่รองรับคำสั่งซื้อจริง
ใช้รหัสการจัดส่งภายในเป็นข้อมูลอ้างอิงหลัก ไม่ใช่ใช้เฉพาะหมายเลขติดตาม คำสั่งซื้อหนึ่งรายการอาจมีหลายพัสดุ และไม่ควรถือว่าหมายเลขติดตามมีเอกลักษณ์ทั่วโลกตลอดไป
ระเบียนภายในที่มีประโยชน์ควรประกอบด้วย:
- รหัสคำสั่งซื้อและรหัสการจัดส่งภายใน
- หมายเลขติดตามและรหัสผู้ให้บริการขนส่งเมื่อทราบ
- ข้อมูลอ้างอิงการจัดส่งของผู้ให้บริการ หากมีการระบุ
- สถานะปัจจุบันที่ปรับเป็นรูปแบบมาตรฐานและเหตุการณ์ล่าสุดที่มีความหมาย
- เวลาของเหตุการณ์จากผู้ให้บริการขนส่ง รวมถึงเขตเวลาหรือออฟเซ็ตเมื่อมีข้อมูล
- เวลาที่ระบบของคุณได้รับข้อมูลอัปเดต
- ข้อมูลอ้างอิงถึงการตั้งค่าการสื่อสารของลูกค้า
- ประวัติการแจ้งเตือนและเวิร์กโฟลว์ข้อผิดพลาดที่กำลังทำงาน
เก็บเวลาเหตุการณ์แยกจากเวลาที่รับข้อมูล การสแกนที่เกิดขึ้นก่อนหน้าอาจมาถึงหลังการสแกนที่ใหม่กว่า หากแอปพลิเคชันเรียงลำดับตามเวลาที่มาถึงเท่านั้น ก็อาจเปลี่ยนสถานะพัสดุที่จัดส่งแล้วกลับเป็นกำลังขนส่งโดยผิดพลาด
สำหรับคำสั่งซื้อที่แบ่งส่ง ให้เชื่อมการแจ้งเตือนกับพัสดุที่ได้รับผลกระทบ ข้อความ “พัสดุหนึ่งชิ้นจากคำสั่งซื้อของคุณมาถึงแล้ว” แม่นยำกว่า “คำสั่งซื้อของคุณมาถึงแล้ว” เมื่อพัสดุอีกชิ้นยังอยู่ระหว่างการขนส่ง
3. จับคู่เหตุการณ์การติดตามกับการตัดสินใจของลูกค้า
คำอธิบายจากผู้ให้บริการขนส่งเป็นข้อมูลเชิงปฏิบัติการ ไม่ใช่ข้อความพร้อมส่งถึงลูกค้า ให้สร้างชั้นการปรับรูปแบบที่เก็บเหตุการณ์ต้นฉบับไว้ พร้อมกำหนดหมวดหมู่ภายในที่กฎการแจ้งเตือนเข้าใจได้
หมวดหมู่ต่อไปนี้เป็นแนวคิดสำหรับแอปพลิเคชัน ไม่ใช่ชุดคำศัพท์สถานะ API สากล:
| หมวดหมู่ภายใน | การตัดสินใจแจ้งเตือน | ขอบเขตการส่งข้อความ |
|---|---|---|
| ได้รับข้อมูลการจัดส่งแล้ว | ส่งข้อมูลอัปเดตการเตรียมสินค้าเฉพาะเมื่อมีประโยชน์ | อย่าสื่อว่าผู้ให้บริการขนส่งครอบครองพัสดุจริงเพียงจากการสร้างฉลาก |
| อยู่ระหว่างการขนส่ง | พิจารณาแจ้งเตือนเมื่อมีการเคลื่อนย้ายที่มีความหมายครั้งแรก | ระงับการแจ้งเตือนการสแกนตามปกติในศูนย์คัดแยก เว้นแต่จะเปลี่ยนขั้นตอนถัดไปของลูกค้า |
| กำลังนำจ่าย | แจ้งเตือนเมื่อเหตุการณ์ที่รองรับระบุสถานะนี้ | อย่าเปลี่ยนสถานะให้เป็นเวลามาถึงที่รับประกัน |
| พยายามจัดส่งหรือจำเป็นต้องรับพัสดุ | ส่งการแจ้งเตือนที่ลูกค้าดำเนินการได้ | ใส่กำหนดเวลาหรือคำแนะนำในการรับพัสดุเฉพาะเมื่อได้รับการยืนยัน |
| ข้อผิดพลาดในการจัดส่ง | ประเมินสาเหตุและดูว่าลูกค้าต้องดำเนินการหรือไม่ | อย่าอธิบายข้อผิดพลาดทุกกรณีว่าเป็นพัสดุสูญหาย |
| จัดส่งแล้ว | ส่งการยืนยันในระดับพัสดุ | อย่าสร้างข้อมูลผู้รับ สถานที่จัดส่ง หรือหลักฐานการจัดส่งขึ้นเอง |
รักษาความไม่แน่นอนไว้ เหตุการณ์ที่ไม่รู้จักควรเข้าสู่ขั้นตอนตรวจสอบหรือ fallback แทนการบังคับให้เข้าหมวดหมู่ที่ใกล้เคียงที่สุด เก็บคำอธิบายดิบไว้ให้เจ้าหน้าที่สนับสนุนใช้แก้ไขปัญหา
4. รับข้อมูลอัปเดตโดยไม่สูญหายหรือทำงานซ้ำ
ปลายทาง webhook ควรตรวจสอบคำขอ บันทึกข้อมูลอัปเดตที่ยอมรับอย่างถาวร และส่งการยืนยันตามที่ผู้ให้บริการกำหนด สร้างข้อความแบบอะซิงโครนัสแทนการรอการตอบกลับจากบริการอีเมลหรือ SMS ระหว่างคำขอ callback
ใช้วิธียืนยัน callback ตามที่เอกสารของผู้ให้บริการกำหนด อย่าสร้าง signature header ขึ้นเองหรือถือว่าผู้ให้บริการทุกรายใช้รูปแบบการยืนยันตัวตนเดียวกัน นอกจากนี้ให้บังคับใช้ HTTPS จำกัดขนาดคำขอ ตรวจสอบ payload และกำหนดสิทธิ์การเข้าถึงอย่างเหมาะสม
โฟลว์การประมวลผลแบบย่อมีลักษณะดังนี้ นี่เป็นการดำเนินงานระดับแอปพลิเคชัน ไม่ใช่ตัวอย่าง SDK ที่ใช้งานได้:
รับ callback
ยืนยันคำขอโดยใช้กลไกของผู้ให้บริการตามเอกสาร
ตรวจสอบ payload
บันทึก payload ที่ยอมรับและใส่คิวการประมวลผลแบบอะตอมิก
ส่งการยืนยันตามเอกสาร
ประมวลผลข้อมูลอัปเดตในคิว
ค้นหาการจัดส่งภายใน
ปรับรูปแบบเหตุการณ์ที่เกี่ยวข้อง
เพิกเฉยต่อเหตุการณ์ที่ประมวลผลแล้ว
ประเมินลำดับเวลาและการเปลี่ยนสถานะ
สร้างงานแจ้งเตือนหากนโยบายอนุญาต
ยืนยันสถานะและงานพร้อมกัน
ส่งงานแจ้งเตือน
ตรวจสอบการตั้งค่าผู้รับและกฎการระงับ
ส่งข้อความไปยังบริการส่งข้อความ
บันทึกผลลัพธ์และลองใหม่เฉพาะเมื่อเหมาะสมขั้นตอนแบบอะตอมิกมีความสำคัญ หากแอปพลิเคชันบันทึกการเปลี่ยนสถานะแต่หยุดทำงานก่อนสร้างงานแจ้งเตือน ลูกค้าอาจไม่ได้รับการแจ้งเตือนเลย Transactional outbox เป็นทางเลือกหนึ่ง โดยบันทึกการเปลี่ยนสถานะและงานที่รอดำเนินการในธุรกรรมฐานข้อมูลเดียวกัน แล้วให้ worker ส่งงาน
จัดการข้อมูลอ้างอิงการจัดส่งที่ไม่รู้จักอย่างชัดเจน กักไว้เพื่อตรวจสอบหรือกระทบยอด แทนการเดาว่าลูกค้ารายใดควรได้รับการแจ้งเตือน
5. เพิ่มการป้องกันข้อมูลซ้ำและการตรวจสอบตามลำดับเวลา
ออกแบบตัวรับข้อมูลให้รองรับ callback ที่ซ้ำและการลองทำงานซ้ำของ worker หากมีรหัสเหตุการณ์จากผู้ให้บริการที่คงที่และระบุไว้ในเอกสาร ให้ใช้รหัสดังกล่าว หากไม่มี ให้สร้างลายนิ้วมือเหตุการณ์แบบกำหนดแน่นอนจากฟิลด์ที่เหมาะสม เช่น รหัสการจัดส่งภายใน รหัสเหตุการณ์ เวลาเหตุการณ์ และสถานที่ ทดสอบลายนิ้วมือนั้นกับ payload จริงก่อนนำไปใช้งาน
การกำจัดเหตุการณ์ซ้ำและการระงับการแจ้งเตือนแก้ปัญหาคนละด้าน การกำจัดเหตุการณ์ซ้ำจะหยุดไม่ให้เหตุการณ์เดียวกันถูกประมวลผลสองครั้ง ส่วนการระงับจะป้องกันไม่ให้การสแกนที่แตกต่างกันหลายครั้งสร้างข้อความที่แทบเหมือนกัน
กำหนดตัวตนของการแจ้งเตือนโดยอิงเหตุการณ์ทางธุรกิจ การยืนยันการจัดส่งอาจใช้รหัสการจัดส่งกับหมุดหมาย “จัดส่งแล้ว” ส่วนการพยายามจัดส่งอาจต้องใช้ตัวตนเฉพาะของแต่ละครั้ง เพราะความพยายามครั้งต่อมาอาจเป็นเหตุการณ์ใหม่จริง ๆ
สำหรับข้อมูลอัปเดตที่มาถึงไม่เรียงลำดับ ให้เปรียบเทียบเวลาของเหตุการณ์และประเมินการเปลี่ยนสถานะที่อนุญาต อย่าถือว่า callback มีเฉพาะการสแกนใหม่ ให้ตรวจสอบว่าโครงสร้างตามเอกสารเป็นเหตุการณ์เดี่ยว snapshot หรือประวัติ และส่งข้อมูลที่ขัดแย้งกันไปกระทบยอด แทนที่จะทิ้งการแก้ไขทั้งหมดอย่างเงียบ ๆ
6. เขียนข้อความที่อธิบายขั้นตอนถัดไป
การแจ้งเตือนแต่ละครั้งควรระบุพัสดุที่เกี่ยวข้อง การเปลี่ยนแปลงที่ยืนยันแล้ว และขั้นตอนถัดไปของลูกค้า ใส่ลิงก์ติดตามที่ปลอดภัยและข้อมูลอ้างอิงคำสั่งซื้อที่จดจำได้ หลีกเลี่ยงการเปิดเผยที่อยู่แบบเต็มหรือข้อมูลส่วนบุคคลที่ไม่จำเป็นในข้อความ SMS และตัวอย่างการแจ้งเตือนบนหน้าจอล็อก
ตัวอย่างเช่น:
- กำลังนำจ่าย: “พัสดุสำหรับคำสั่งซื้อ {order_reference} ของคุณกำลังนำจ่าย ติดตามความคืบหน้าได้ที่นี่: {tracking_link}”
- พยายามจัดส่งแล้ว: “ผู้ให้บริการขนส่งรายงานว่ามีความพยายามจัดส่งพัสดุของคุณ ตรวจสอบขั้นตอนถัดไปที่มีได้ที่หน้าติดตาม: {tracking_link}”
- จัดส่งแล้ว: “ผู้ให้บริการขนส่งระบุว่าพัสดุสำหรับคำสั่งซื้อ {order_reference} ของคุณจัดส่งแล้ว ดูรายละเอียดการจัดส่งที่มีได้ที่: {tracking_link}”
แสดง placeholder เฉพาะจากข้อมูลที่ผ่านการตรวจสอบ หากมีเวลาจัดส่งโดยประมาณและเหมาะสมที่จะแสดง ให้ระบุว่าเป็นการประมาณ หากไม่มี ให้ละเว้นแทนการสร้างวันที่ขึ้นเอง
สำหรับข้อผิดพลาด ให้แยกปัญหาของการจัดส่งออกจากงานที่ลูกค้าต้องทำ ความขัดข้องอาจต้องการเพียงคำอธิบาย ส่วนปัญหาที่อยู่ที่ยืนยันแล้วอาจต้องให้ลูกค้าดำเนินการ อย่าส่งลูกค้าไปยังหน้าชำระเงินหรือหน้าอัปโหลดเอกสารโดยอาศัยเพียงข้อความติดตามแบบอิสระที่ไม่น่าเชื่อถือ
เลือกช่องทางโดยใช้การตั้งค่าของลูกค้า สิทธิ์ของช่องทาง ความเร่งด่วน และกฎที่เกี่ยวข้อง ตรวจสอบข้อกำหนดด้านความยินยอม การยกเลิกรับข้อความ และช่วงเวลาห้ามรบกวนสำหรับเขตอำนาจศาลและช่องทางที่ใช้ แยกการแจ้งเตือนบริการจัดส่งออกจากแคมเปญส่งเสริมการขาย อย่าถือว่าสิทธิ์เดียวกันครอบคลุมทั้งสองประเภท
7. กำหนดสิ่งที่จะเกิดขึ้นเมื่อการติดตามเงียบหาย
การสื่อสารเชิงรุกควรครอบคลุมทั้งการไม่มีความคืบหน้าและเหตุการณ์ใหม่ แต่ความเงียบเพียงอย่างเดียวไม่ได้พิสูจน์ว่าการจัดส่งล่าช้าหรือสูญหาย
สร้างกฎการติดตามที่ล้าสมัยโดยใช้ระดับบริการ เส้นทาง เหตุการณ์ล่าสุดที่มีความหมาย และเวลาจัดส่งโดยประมาณที่รองรับ กำหนดเกณฑ์จากข้อมูลการดำเนินงานและกระบวนการสนับสนุนของคุณ แทนการใช้ระยะเวลารอเดียวกับการจัดส่งทุกประเภท
เมื่อกฎทำงาน ให้ตรวจสอบการประมวลผลที่พลาด กระทบยอดกับแหล่งข้อมูลการติดตามเมื่อรองรับ และตัดสินใจว่าจะเปิดงานสนับสนุนภายในหรือไม่ หากแจ้งลูกค้า ให้ใช้ถ้อยคำที่สะท้อนสิ่งที่ทราบ: “เราไม่ได้รับข้อมูลอัปเดตการติดตามใหม่” แตกต่างจาก “พัสดุของคุณสูญหาย”
กำหนดผู้รับผิดชอบข้อผิดพลาดที่ยังไม่ได้แก้ไข ระบบแจ้งเตือนที่ประกาศปัญหาซ้ำ ๆ โดยไม่มีเส้นทางไปสู่การแก้ไขอาจเพิ่มความไม่พอใจของลูกค้า
8. ทดสอบเส้นทางทั้งหมดก่อนเปิดใช้การส่งอัตโนมัติ
เริ่มจากโหมด shadow: รับเหตุการณ์จริงหรือเหตุการณ์ทดสอบที่ได้รับอนุมัติ สร้างการแจ้งเตือนที่เสนอ และตรวจสอบผลลัพธ์โดยไม่ติดต่อหาลูกค้า
- เล่น callback เดิมซ้ำและยืนยันว่าไม่มีการสร้างข้อความใหม่
- ประมวลผลเหตุการณ์ระหว่างขนส่งที่เก่ากว่าหลังเหตุการณ์จัดส่งแล้ว และตรวจสอบสถานะที่ได้
- ทดสอบ timestamp ที่หายไป สถานะที่ไม่รู้จัก และ payload ที่ผิดรูปแบบ
- จำลองฐานข้อมูลล้มเหลวก่อนการยืนยัน และ worker ล้มเหลวหลังบันทึกข้อมูล
- ทดสอบการหมดเวลาของบริการส่งข้อความ รวมถึงการตอบกลับที่ไม่แน่นอนซึ่งบริการอาจรับข้อความไปแล้ว
- ยืนยันว่าการจัดส่งแบบแบ่งส่งใช้ข้อความเฉพาะของแต่ละพัสดุ
- ตรวจสอบผู้รับที่ยกเลิกรับข้อความ รายละเอียดติดต่อไม่ถูกต้อง และการจัดการช่วงเวลาห้ามรบกวน
- ตรวจสอบว่าลิงก์ติดตามไม่เปิดเผยข้อมูลคำสั่งซื้อของลูกค้ารายอื่น
ติดตาม callback ที่ยอมรับ ความล้มเหลวในการประมวลผล อายุคิว งานแจ้งเตือน การระงับข้อมูลซ้ำ และผลลัพธ์การส่งข้อความ วัดเวลาแฝงของการประมวลผลนับจากเวลาที่ระบบได้รับข้อมูลแยกจากอายุของเหตุการณ์จากผู้ให้บริการ ความแตกต่างนี้ช่วยระบุว่าการแจ้งเตือนล่าช้าเกิดจากข้อมูลต้นทางพร้อมช้าหรือเกิดจาก pipeline ของคุณเอง
เริ่มจากหมุดหมายที่เข้าใจดีจำนวนเล็กน้อย แล้วค่อยขยายกฎเมื่อทีมสนับสนุนและทีมปฏิบัติการเห็นพ้องว่าข้อความถูกต้อง นำไปดำเนินการได้ และมีประโยชน์ต่อการรับ
คำถามที่พบบ่อย
Shipment tracking API ส่งอีเมลหรือข้อความ SMS โดยอัตโนมัติหรือไม่
ไม่เสมอไป การเข้าถึงข้อมูลการติดตามและการส่งข้อความถึงลูกค้าเป็นความสามารถแยกกัน ตรวจสอบขอบเขตที่ระบุไว้ในเอกสารของบริการ ในการเชื่อมต่อแบบกำหนดเอง แอปพลิเคชันของคุณสามารถประมวลผลข้อมูลอัปเดตการติดตามและส่งการแจ้งเตือนผ่านบริการส่งข้อความแยกต่างหาก
ควรแจ้งลูกค้าทุกครั้งที่มีการสแกนติดตามหรือไม่
โดยทั่วไปไม่ควร ให้ความสำคัญกับหมุดหมายที่มีความหมายและเหตุการณ์ที่ต้องดำเนินการ การสแกนในศูนย์คัดแยกหลายครั้งอาจเป็นการขนส่งตามปกติโดยไม่เปลี่ยนสิ่งที่ลูกค้าจำเป็นต้องรู้ เก็บประวัติโดยละเอียดไว้ที่หน้าติดตาม
สามารถรับประกันการแจ้งเตือนการจัดส่งแบบเรียลไทม์ได้หรือไม่
คุณสามารถกำหนดและตรวจสอบเป้าหมายการประมวลผลหลังจากระบบได้รับข้อมูลอัปเดต แต่ไม่สามารถรับประกันได้ว่าผู้ให้บริการขนส่งจะบันทึกหรือเผยแพร่การสแกนเมื่อใด ควรอธิบายบริการโดยสะท้อนการพึ่งพานี้
จะป้องกันข้อความแจ้งเตือนการจัดส่งซ้ำได้อย่างไร
ใช้การกำจัดเหตุการณ์ซ้ำแบบถาวร ตัวตนการแจ้งเตือนแยกสำหรับหมุดหมายทางธุรกิจแต่ละรายการ และการสร้างงานแบบธุรกรรม หากบริการส่งข้อความรองรับ idempotency ให้ใช้เป็นมาตรการป้องกันเพิ่มเติม การตรวจสอบข้อมูลซ้ำในหน่วยความจำเพียงอย่างเดียวไม่สามารถรองรับการรีสตาร์ตหรือ worker หลายตัวได้
ควรทำอย่างไรหากผู้ให้บริการขนส่งแก้ไขสถานะจัดส่งแล้ว
เก็บเหตุการณ์ทั้งสองรายการไว้และกระทบยอดสถานะการจัดส่ง หากการแก้ไขส่งผลสำคัญต่อลูกค้า ให้ส่งการแก้ไขที่ชัดเจนหรือส่งต่อให้ฝ่ายสนับสนุนตามนโยบาย อย่าทำให้สถานะจัดส่งแล้วไม่สามารถย้อนกลับได้ถาวรเพียงเพื่อทำให้โค้ดง่ายขึ้น
แหล่งข้อมูล
แหล่งข้อมูลอย่างเป็นทางการต่อไปนี้เป็นเอกสารอ้างอิงสำหรับการใช้งาน 17TRACK ที่กล่าวถึงข้างต้น สคีมาภายใน กฎการแจ้งเตือน และโฟลว์การประมวลผลในคู่มือนี้เป็นคำแนะนำด้านสถาปัตยกรรม ไม่ใช่ข้อตกลง API ที่ยกมาโดยตรง
- 17TRACK Tracking API — จุดเริ่มต้นอย่างเป็นทางการสำหรับประเมินการเชื่อมต่อ API
- เอกสาร 17TRACK API — แหล่งอ้างอิงรูปแบบคำขอเฉพาะผู้ให้บริการ การยืนยันตัวตน การดำเนินการติดตาม และข้อกำหนดการเชื่อมต่อ


