Skip to main content
หน้าหลักบล็อกคู่มือวิธีใช้ API ติดตามการจัดส่งเพื่อส่งการแจ้งเตือนการจัดส่งล่วงหน้า

วิธีใช้ API ติดตามการจัดส่งเพื่อส่งการแจ้งเตือนการจัดส่งล่วงหน้า

17TRACK

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

วิธีใช้ Shipment Tracking APIs เพื่อส่งการแจ้งเตือนการจัดส่งเชิงรุก

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

ออกแบบเวิร์กโฟลว์การแจ้งเตือนก่อนเชื่อมต่อ API

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

สถาปัตยกรรมที่ใช้งานได้จริงมี 6 ขั้นตอน:

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

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

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 — แหล่งอ้างอิงรูปแบบคำขอเฉพาะผู้ให้บริการ การยืนยันตัวตน การดำเนินการติดตาม และข้อกำหนดการเชื่อมต่อ