Skip to main content
หน้าหลักบล็อกคู่มือTracking API ควรส่งคืนข้อมูลอะไรบ้าง? 12 ฟิลด์นอกเหนือจากสถานะปัจจุบัน?

Tracking API ควรส่งคืนข้อมูลอะไรบ้าง? 12 ฟิลด์นอกเหนือจากสถานะปัจจุบัน?

17TRACK

Tracking API ควรส่งคืนข้อมูลมากกว่าป้ายกำกับอย่าง “อยู่ระหว่างการขนส่ง” นอกจากสถานะปัจจุบันแล้ว ควรมองหาหมายเลขระบุการจัดส่ง ข้อมูลผู้ให้บริการขนส่ง รายละเอียดสถานะ ข้อความต้นฉบับจากผู้ให้บริการ ประวัติเหตุการณ์ เวลาเกิดเหตุการณ์ สถานที่ การคาดการณ์การจัดส่ง ข้อยกเว้น การส่งต่อระหว่างผู้ให้บริการ รายละเอียดการจัดส่ง และข้อมูลเมตาด้านความใหม่ของข้อมูล กลุ่มข้อมูลทั้ง 12 กลุ่มนี้ช่วยให้นักพัฒนาสร้างเวิร์กโฟลว์ที่เชื่อถือได้ และช่วยให้ทีมปฏิบัติการมีบริบทเพียงพอสำหรับดำเนินการ

What Data Should a Tracking API Return 12 Fields Beyond

นี่คือสัญญาการตอบกลับที่แนะนำสำหรับนักพัฒนา ผู้จัดซื้อด้านเทคนิค และทีมปฏิบัติการอีคอมเมิร์ซ ไม่ใช่ข้ออ้างว่าผู้ให้บริการขนส่งหรือ API ทุกรายจะมีข้อมูลครบทุกฟิลด์ ค่าบางอย่างอาจไม่มีอยู่ได้อย่างถูกต้อง การออกแบบที่ดีกว่าคือการระบุช่องว่างเหล่านี้ให้ชัดเจน แทนที่จะเติมข้อมูลด้วยการคาดเดา

อะไรทำให้ข้อมูลการติดตามมีประโยชน์?

สถานะปัจจุบันตอบคำถามได้เพียงข้อเดียวอย่างจำกัด นั่นคือสถานะสรุปของพัสดุเป็นอย่างไร แต่ไม่ได้อธิบายเสมอไปว่าเกิดอะไรขึ้น เกิดขึ้นเมื่อใด ข้อมูลนั้นเป็นข้อมูลล่าสุดหรือไม่ หรือควรดำเนินการอย่างไรต่อไป

ตัวอย่างเช่น การจัดส่งสองรายการอาจแสดงสถานะ “อยู่ระหว่างการขนส่ง” เหมือนกัน แต่ต้องการการตอบสนองที่แตกต่างกัน รายการหนึ่งอาจมีการสแกนที่ศูนย์คัดแยกล่าสุดและไม่มีปัญหาที่รายงาน ส่วนอีกรายการอาจมีปัญหาที่อยู่ซึ่งยังไม่ได้รับการแก้ไขบันทึกอยู่ในประวัติเหตุการณ์ แอปพลิเคชันที่อ่านเฉพาะสถานะหลักอาจพลาดความแตกต่างนี้

ประเมินการตอบกลับโดยพิจารณาจากงานเชิงปฏิบัติ 3 ประการ ได้แก่ การจับคู่การจัดส่งกับคำสั่งซื้อที่ถูกต้อง การอธิบายความคืบหน้าอย่างแม่นยำ และการตัดสินใจว่าควรดำเนินการหรือไม่ ฟิลด์ต่อไปนี้รองรับงานเหล่านี้ ชื่อฟิลด์เป็นเพียงตัวอย่าง ไม่ใช่มาตรฐานสากลหรือสคีมาของผู้ให้บริการรายใดโดยเฉพาะ

12 ฟิลด์ที่ควรประเมินนอกเหนือจากสถานะปัจจุบัน

1. ตัวระบุการจัดส่งและการติดตาม

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

อย่าสันนิษฐานว่าหนึ่งคำสั่งซื้อเท่ากับหนึ่งการจัดส่ง คำสั่งซื้ออาจถูกแบ่งออกเป็นหลายพัสดุ และการจัดส่งทดแทนอาจสร้างการจัดส่งใหม่อีกครั้ง ควรจัดเก็บระเบียนการติดตามในระดับพัสดุหรือการจัดส่งสินค้า แล้วเชื่อมโยงกับคำสั่งซื้อ เก็บหมายเลขติดตามเป็นสตริงเพื่อไม่ให้รูปแบบและเลขศูนย์นำหน้าสูญหาย

2. ข้อมูลผู้ให้บริการขนส่ง

ควรมองหาตัวระบุผู้ให้บริการขนส่งที่คงที่ควบคู่กับชื่อผู้ให้บริการที่อ่านได้ หากมีข้อมูล การตอบกลับควรแยกให้ชัดเจนว่าผู้ให้บริการถูกระบุโดยแอปพลิเคชันของคุณโดยตรง หรือถูกเลือกผ่านการตรวจจับอัตโนมัติ

บริบทของผู้ให้บริการมีความสำคัญต่อการตีความหมายเลขติดตามและเหตุการณ์ หากการตรวจจับไม่ชัดเจน ระบบเชื่อมต่อของคุณควรมีวิธีแก้ไข ไม่ใช่แสดงผลการจับคู่ที่ไม่แน่นอนเป็นข้อมูลยืนยันโดยเงียบ ๆ ควรแยกข้อมูลระดับบริการออกจากกัน เพราะชื่อผู้ให้บริการเพียงอย่างเดียวไม่ได้ยืนยันว่าการจัดส่งใช้บริการด่วน ไปรษณีย์ หรือบริการประเภทอื่น

3. รายละเอียดสถานะที่ปรับมาตรฐานแล้ว

นอกจากสถานะหลักแล้ว ควรขอรหัสรายละเอียดหรือสถานะย่อยที่มีเอกสารกำกับ หมวดหมู่กว้าง ๆ อาจระบุว่าการจัดส่งเป็นข้อยกเว้น ขณะที่รายละเอียดอาจระบุถึงความพยายามจัดส่ง ปัญหาที่อยู่ หรือการระงับที่เกี่ยวข้องกับศุลกากร

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

4. ข้อความและรหัสต้นฉบับจากผู้ให้บริการขนส่ง

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

แยกข้อความต้นฉบับออกจากคำอธิบายที่แปลหรือเขียนใหม่ มิฉะนั้นคำอธิบายสำหรับลูกค้าอาจถูกเข้าใจผิดว่าเป็นถ้อยคำที่ผู้ให้บริการใช้จริง เมื่อแสดงข้อความจากผู้ให้บริการ ให้ถือว่าเป็นข้อมูลที่ไม่น่าเชื่อถือ ควร escape อย่างเหมาะสมและอย่าเรนเดอร์เป็น HTML ที่ประมวลผลได้

5. ประวัติเหตุการณ์การติดตาม

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

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

6. เวลาเกิดเหตุการณ์และข้อมูลเขตเวลา

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

ควรขอเวลาที่มี UTC offset หรือสัญลักษณ์ UTC อย่างชัดเจน RFC 3339 กำหนดรูปแบบเวลาที่เหมาะสมสำหรับโปรโตคอลอินเทอร์เน็ต รวมถึง offset เชิงตัวเลข หากแหล่งข้อมูลส่งมาเฉพาะเวลาท้องถิ่นโดยไม่ทราบ offset ให้คงความไม่แน่นอนไว้ แทนที่จะถือว่าเป็น UTC โดยไม่แจ้ง อย่าสื่อว่ามีความแม่นยำระดับวินาที หากแหล่งข้อมูลมีเพียงวันที่

7. สถานที่เกิดเหตุการณ์และภูมิศาสตร์ของการจัดส่ง

ควรมองหาองค์ประกอบสถานที่ที่มีโครงสร้าง เช่น เมือง ภูมิภาค ประเทศ และรหัสไปรษณีย์เมื่อมีข้อมูล ควรเก็บสตริงสถานที่ดิบไว้ด้วย หากการแปลงเป็นฟิลด์แบบมีโครงสร้างอาจทำให้ความหมายสูญหาย

สถานที่สแกนไม่จำเป็นต้องเป็นตำแหน่งปัจจุบันของพัสดุ และศูนย์ล่าสุดที่รายงานก็ไม่ได้พิสูจน์ว่าพัสดุยังอยู่ที่นั่น หน้าที่แสดงต่อลูกค้าควรอธิบายว่าเป็นสถานที่ล่าสุดที่มีการรายงาน หลีกเลี่ยงการอนุมานพิกัดหรือที่อยู่จัดส่งที่แน่นอนจากข้อความการสแกนที่ไม่สมบูรณ์

8. วันที่หรือช่วงเวลาจัดส่งโดยประมาณ

ฟิลด์การจัดส่งโดยประมาณควรระบุว่าเป็นวันที่เดียวหรือช่วงเวลา ใครเป็นผู้จัดทำ และอัปเดตครั้งล่าสุดเมื่อใด ควรแยกการประมาณการจากผู้ให้บริการขนส่งออกจากการคาดการณ์ที่คำนวณแยกต่างหาก

อย่าแปลงการประมาณการที่มีเพียงวันที่ให้เป็นเวลามาถึงที่แม่นยำ ระบบเชื่อมต่อควรรองรับการแก้ไขหรือถอนการประมาณการโดยไม่เก็บคำมั่นสัญญาที่ล้าสมัยไว้บนหน้าติดตาม หากไม่มีการประมาณการ ให้แสดงว่าไม่มีข้อมูล แทนที่จะคำนวณจากสมมติฐานที่ไม่มีหลักฐานรองรับ

9. เหตุผลของข้อยกเว้นและการดำเนินการที่จำเป็น

ข้อมูลข้อยกเว้นควรอธิบายปัญหา และหากแหล่งข้อมูลรองรับ ควรระบุการดำเนินการ ผู้รับผิดชอบ หรือกำหนดเวลา การแจ้งความล่าช้าทั่วไปแตกต่างจากคำขอข้อมูลจากผู้รับในเชิงปฏิบัติการ

แยกข้อเท็จจริงที่รายงานออกจากการตัดสินใจในเวิร์กโฟลว์ของคุณ ตัวอย่างเช่น ธุรกิจของคุณอาจเปิดงานสนับสนุนหลังไม่มีการอัปเดตตามระยะเวลาที่กำหนด นั่นคือกฎการยกระดับภายใน ไม่ใช่หลักฐานว่าผู้ให้บริการขนส่งประกาศว่าพัสดุสูญหาย อย่าสร้างคำแนะนำการชำระเงินหรือคำขอข้อมูลอ่อนไหวจากข้อความการติดตามที่คลุมเครือ

10. การส่งต่อระหว่างผู้ให้บริการและหมายเลขติดตามที่เกี่ยวข้อง

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

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

11. ผลลัพธ์การจัดส่งและข้อมูลอ้างอิงหลักฐาน

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

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

12. ความใหม่ของข้อมูล สถานะการดึงข้อมูล และข้อมูลเมตาของการตอบกลับ

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

คำขอ API ที่สำเร็จไม่ได้ยืนยันด้วยตัวมันเองว่าผู้ให้บริการขนส่งเผยแพร่การสแกนใหม่แล้ว ความหมายของการตอบกลับ HTTP อธิบายผลลัพธ์ของคำขอ ส่วนความคืบหน้าการจัดส่งอยู่ในข้อมูลแอปพลิเคชัน เก็บข้อผิดพลาดในการดึงข้อมูลแยกจากข้อยกเว้นของการจัดส่ง เพื่อไม่ให้ปัญหาการเชื่อมต่อชั่วคราวกลายเป็นการแจ้งเตือนการจัดส่งเท็จ

ข้อมูลที่หายไปต้องมีความหมายที่กำหนดไว้

การมีอยู่ของฟิลด์เป็นเพียงส่วนหนึ่งของสัญญา ทีมของคุณต้องเข้าใจด้วยว่าค่าที่ไม่มีอยู่หมายถึงอะไร วันที่จัดส่งโดยประมาณอาจไม่มีจากแหล่งข้อมูล ยังไม่ได้ถูกดึงมา หรือไม่เกี่ยวข้องหลังจากจัดส่งแล้ว สถานการณ์เหล่านี้ไม่ควรสร้างข้อความเดียวกันถึงลูกค้าโดยอัตโนมัติ

  • ไม่ทราบ: ยังไม่มีการยืนยันค่า
  • ไม่ได้ส่งมา: แหล่งข้อมูลไม่ได้ให้ค่านี้ในข้อมูลที่ดึงมา
  • ไม่เกี่ยวข้อง: ฟิลด์นี้ไม่ใช้กับระเบียนหรือสถานะนี้
  • การดึงข้อมูลล้มเหลว: ระบบไม่สามารถดำเนินการค้นหาที่เกี่ยวข้องให้เสร็จสิ้น

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

วิธีทดสอบการตอบกลับก่อนเชื่อมต่อระบบ

ประเมิน payload จริงจากผู้ให้บริการ บริการ และเส้นทางการจัดส่งที่ธุรกิจของคุณใช้ สคีมาอาจระบุฟิลด์ที่เป็นตัวเลือกโดยไม่รับประกันว่าแหล่งข้อมูลพื้นฐานทุกแห่งจะเติมค่า สำหรับการเชื่อมต่อกับ 17TRACK ให้ใช้ เอกสาร Tracking API อย่างเป็นทางการ เพื่อตรวจสอบสัญญาการตอบกลับ แทนที่จะถือว่าชื่อฟิลด์เชิงแนวคิดในคู่มือนี้เป็นพารามิเตอร์ที่พร้อมคัดลอกไปใช้

  1. สร้างตัวอย่างที่เป็นตัวแทน รวมการจัดส่งที่ลงทะเบียนใหม่ การจัดส่งที่กำลังดำเนินการ ความพยายามจัดส่ง การจัดส่งที่เสร็จสมบูรณ์ และกรณีการส่งต่อที่มีอยู่
  2. ตรวจสอบย้อนกลับฟิลด์ไปยังเหตุการณ์ ยืนยันสถานะที่แสดง เหตุการณ์ล่าสุด และรายละเอียดการจัดส่งว่าอธิบายระเบียนเดียวกันอย่างสอดคล้องกัน ตรวจสอบความคลาดเคลื่อนแทนที่จะซ่อน
  3. ทดสอบการอัปเดตที่ล่าช้าและซ้ำ ประมวลผล payload เดิมซ้ำ และรับเหตุการณ์เก่าหลังเหตุการณ์ใหม่ ยืนยันว่าไม่มีการแจ้งเตือนซ้ำหรือย้อนสถานะที่แสดงอย่างไม่ถูกต้อง
  4. ทดสอบค่าที่หายไปและผิดรูปแบบ รวมการประมาณการที่ไม่มี สถานที่ที่ไม่รู้จัก รหัสสถานะที่ไม่คุ้นเคย และเวลาที่ไม่สมบูรณ์ แอปพลิเคชันควรยังใช้งานได้โดยไม่สร้างค่าทดแทนขึ้นเอง
  5. แยกความล้มเหลวของการขนส่งออกจากผลการติดตาม การยืนยันตัวตนล้มเหลว หมดเวลา หรือการตอบกลับผิดรูปแบบควรเข้าสู่เส้นทางข้อผิดพลาดของการเชื่อมต่อ ไม่ใช่เวิร์กโฟลว์ข้อยกเว้นของการจัดส่ง
  6. ตรวจสอบมุมมองของลูกค้า ตรวจสอบว่าไม่มีข้อมูลอ้างอิงภายใน รายละเอียดวินิจฉัยดิบ หรือข้อมูลส่วนบุคคลรั่วไหลไปยังหน้าสาธารณะหรือการแจ้งเตือน

สำหรับการอัปเดตผ่าน webhook ควรตรวจสอบตัวระบุการส่ง การยืนยันตัวตน พฤติกรรมการลองใหม่ และการจัดการ replay ในเอกสารของผู้ให้บริการด้วย สิ่งเหล่านี้เป็นข้อกำหนดของการเชื่อมต่อ ไม่ใช่ข้อเท็จจริงเกี่ยวกับการจัดส่ง ตัวรับข้อมูลควรประมวลผลการส่งซ้ำอย่างปลอดภัย และไม่ควรสันนิษฐานว่าลำดับการมาถึงเท่ากับลำดับเหตุการณ์

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

คำถามที่พบบ่อย

การจัดส่งทุกครั้งจำเป็นต้องมีข้อมูลครบทั้ง 12 กลุ่มหรือไม่?

ไม่จำเป็น หลักฐานการจัดส่ง หมายเลขติดตามปลายทาง และวันที่จัดส่งโดยประมาณอาจไม่มีหรือไม่เกี่ยวข้อง กำหนดนิยามฟิลด์ที่ชัดเจนและพฤติกรรมของค่าที่หายไปที่คาดเดาได้ แทนที่จะกำหนดให้ทุกฟิลด์ต้องมีข้อมูล ตรวจสอบฟิลด์ที่สำคัญที่สุดกับรูปแบบการจัดส่งจริงของคุณ

ควรเก็บการตอบกลับดิบหรือเฉพาะฟิลด์ที่ปรับมาตรฐานแล้ว?

เก็บฟิลด์ที่ปรับมาตรฐานแล้วสำหรับตรรกะของแอปพลิเคชัน การเก็บ payload ต้นทางที่เกี่ยวข้องไว้อาจช่วยในการแก้ไขข้อผิดพลาดและการเปลี่ยนแปลงการแมป โดยอยู่ภายใต้ข้อกำหนดด้านความเป็นส่วนตัว ความปลอดภัย สัญญา และการเก็บรักษาข้อมูล จำกัดการเข้าถึงและหลีกเลี่ยงการเก็บเนื้อหาที่อ่อนไหวเพียงเพราะปรากฏอยู่ในการตอบกลับ

ควรใช้เวลาใดเป็นตัวกำหนดเหตุการณ์ล่าสุด?

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

Tracking API ยืนยันได้หรือไม่ว่าพัสดุสูญหาย?

ควรถือว่าพัสดุสูญหายเป็นข้อมูลที่ผู้ให้บริการรายงานก็ต่อเมื่อแหล่งข้อมูลรองรับการตีความนั้นอย่างชัดเจน ช่วงเวลาที่ยาวนานโดยไม่มีการสแกนอาจเป็นเหตุให้ตรวจสอบตามกฎการปฏิบัติงาน แต่ความเงียบเพียงอย่างเดียวไม่ได้ยืนยันการสูญหาย ให้แยกแนวคิด “การติดตามล้าสมัย” ออกจาก “รายงานว่าสูญหาย”

สถานะจัดส่งแล้วเพียงพอที่จะปิดข้อร้องเรียนของลูกค้าหรือไม่?

ไม่เสมอไป สถานะดังกล่าวยืนยันผลการติดตามที่มีการรายงาน แต่ไม่จำเป็นต้องแก้ไขข้อโต้แย้งของผู้รับ ตรวจสอบรายละเอียดการจัดส่งที่มีอยู่ บัญชีของลูกค้า และกระบวนการสนับสนุนของคุณ อย่าถือว่าป้ายกำกับสถานะเป็นสิ่งทดแทนการตรวจสอบข้อมูลที่ขัดแย้งกัน

แหล่งข้อมูล

  • เอกสาร 17TRACK Tracking API — แหล่งอ้างอิงเฉพาะผลิตภัณฑ์สำหรับตรวจสอบฟิลด์และพฤติกรรมที่ระบุไว้ของการเชื่อมต่อ ส่วนกลุ่มข้อมูลทั้ง 12 กลุ่มข้างต้นเป็นคำแนะนำเชิงบรรณาธิการ ไม่ใช่การทำซ้ำสคีมาของผลิตภัณฑ์
  • RFC 3339: Date and Time on the Internet: Timestamps — การแทนค่าเวลาและหลักเกณฑ์เกี่ยวกับ offset ของเขตเวลา
  • RFC 9110: HTTP Semantics — ความหมายของการตอบกลับ HTTP ซึ่งแตกต่างจากสถานะทางธุรกิจระดับการจัดส่ง