Skip to main content
หน้าหลักบล็อกแนวทางปฏิบัติที่ดีที่สุด 8 ข้อสำหรับการผสานรวม UPS Tracking Api (และข้อผิดพลาดที่ควรหลีกเลี่ยง)

แนวทางปฏิบัติที่ดีที่สุด 8 ข้อสำหรับการผสานรวม UPS Tracking Api (และข้อผิดพลาดที่ควรหลีกเลี่ยง)

17TRACK

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

8 Ups Tracking Api Integration Best Practices and Mistakes to

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

การผสานรวม UPS Tracking API ต้องทำอะไรบ้าง

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

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

1. ยืนยันผลิตภัณฑ์ API และข้อกำหนดการเข้าถึงก่อนเริ่มเขียนโค้ด

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

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

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

2. รักษาความปลอดภัยข้อมูลรับรองและแยกสภาพแวดล้อม

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

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

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

3. ตรวจสอบและปรับรูปแบบหมายเลขติดตามให้เป็นมาตรฐาน

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

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

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

4. สร้างโมเดลสถานะภายในแทนการคัดลอกข้อความของผู้ให้บริการขนส่ง

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

โมเดลอย่างง่ายอาจประกอบด้วย label_created, in_transit, out_for_delivery, delivered, exception และ unknown รายการที่แน่นอนเป็นการตัดสินใจด้านผลิตภัณฑ์ ไม่ใช่การรับประกันจาก UPS เก็บรหัสและคำอธิบายเดิมของผู้ให้บริการไว้คู่กับสถานะที่ปรับเป็นมาตรฐาน เพื่อให้เจ้าหน้าที่สนับสนุนตรวจสอบกรณีที่คลุมเครือได้

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

5. มองการติดตามเป็นปัญหาข้อมูลที่ขับเคลื่อนด้วยเหตุการณ์

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

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

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

6. ออกแบบเพื่อรองรับการลองใหม่ ขีดจำกัดอัตรา และความล้มเหลวบางส่วน

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

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

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

7. แยกความใหม่ของข้อมูลออกจากข้อความถึงลูกค้า

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

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

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

8. ทดสอบกรณีขอบด้านการปฏิบัติงาน ไม่ใช่เฉพาะเส้นทางปกติ

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

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

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

ข้อผิดพลาดทั่วไปของ UPS Tracking API โดยสรุป

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

เมื่อใดที่ Multi-carrier Tracking API อาจเหมาะสมกว่า

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

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

เช็กลิสต์การเปิดใช้งานที่ใช้งานได้จริง

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

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

ฉันสามารถเรียก UPS Tracking API โดยตรงจากเบราว์เซอร์ได้หรือไม่

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

เหตุใดหมายเลขติดตามบางครั้งจึงไม่ส่งคืนเหตุการณ์ที่มีประโยชน์

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

การอัปเดตการติดตามทุกครั้งควรทริกเกอร์อีเมลหรือไม่

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

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

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

การผสานรวม UPS โดยตรงดีกว่า Multi-carrier API หรือไม่

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

แหล่งข้อมูล

  • UPS Developer Portal — แหล่งข้อมูลสำหรับนักพัฒนาและเอกสาร API อย่างเป็นทางการ
  • UPS Tracking — บริการติดตาม UPS อย่างเป็นทางการ
  • 17TRACK API — ข้อมูลผลิตภัณฑ์อย่างเป็นทางการสำหรับการผสานรวม API ติดตามแบบหลายผู้ให้บริการ
  • 17TRACK API Documentation — เอกสาร API และข้อมูลอ้างอิงการผสานรวมอย่างเป็นทางการ
Loading