Fedex Logo

การติดตามสถานะแบบรวมระบบขั้นสูงทำงานอย่างไร

ภาพรวมเว็บฮุคการติดตามสถานะแบบรวมระบบขั้นสูง

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

หากต้องการใช้ฟังก์ชันนี้ ผู้ดูแลระบบ FedEx หรือ ผู้ดูแลระบบ DI จะต้องสร้างโครงการเว็บฮุคการติดตามสถานะแบบรวมระบบขั้นสูง

 

ตัวเลือกการนำทาง

คุณสามารถเข้าถึงหน้าเว็บฮุคการติดตามสถานะแบบรวมระบบขั้นสูงได้ด้วยสองวิธี:

วิธีที่ 1: ผ่านโครงการของฉัน

  •  ไปที่โครงการของฉัน ซึ่งอยู่ที่แผงการนำทางด้านซ้าย
  •  คลิกแท็บเว็บฮุค

วิธีที่ 2: ผ่านแค็ตตาล็อก API

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

การดูโครงการการสมัครรับข้อมูลหมายเลขการติดตามสถานะแบบรวมระบบขั้นสูง

1. การเข้าถึงและการตั้งค่าส่วนบุคคลของ FedEx

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

2. ดูเวิร์กโฟลว์สำหรับการสมัครรับข้อมูลหมายเลขการติดตาม

2.1 ดูการสมัครรับข้อมูล

  •  เมื่อผู้ดูแลระบบหรือตัวแทนของ FedEx สร้างโครงการแล้ว ผู้ใช้สามารถดูการติดตามสถานะแบบรวมระบบขั้นสูง – โครงการการสมัครรับข้อมูลหมายเลขการติดตามได้ภายในแดชบอร์ดของตน

2. ดูคุณสมบัติ

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

คำอธิบายคุณสมบัติ

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

 

ในหน้ารายละเอียด ข้อมูลต่อไปนี้จะปรากฏขึ้น:

ชื่อฟิลด์ คำอธิบาย
ชื่อโครงการเว็บฮุค ชื่อสำหรับโครงการเว็บฮุคของคุณที่ไม่ซ้ำกันและไม่ว่างเปล่า ชื่อที่แนะนำซึ่งเป็นชื่อที่กรอกอัตโนมัติ แต่สามารถแก้ไขได้ โดยชื่อนี้จะไม่ซ้ำกับเว็บฮุคอื่น
URL ปลายทาง ปลายทาง HTTPS ที่ปลอดภัยที่ FedEx จะส่งข้อมูลการติดตามกิจกรรม
ข้อกำหนด:
  • ต้องถูกต้องและใช้งานได้
  • ต้องเป็นไปตามไวยากรณ์มาตรฐาน
  • ต้องไม่มี fedex.com หรือโดเมนย่อยของ fedex.com
  • สามารถนำไปใช้ซ้ำได้ในหลายเว็บฮุค
โปรดดูรายละเอียดเพิ่มเติมในส่วนของกฎการดำเนินธุรกิจและแนวปฏิบัติที่ดีที่สุด
โทเค็นรักษาความปลอดภัย ข้อมูลลับร่วมที่ใช้ในการรับรองความถูกต้องและตรวจสอบการตอบกลับของเว็บฮุคผ่าน HMAC
ข้อกำหนด:
  • 26–100 ตัวอักษร
  • ต้องประกอบด้วยอักษรตัวพิมพ์ใหญ่อย่างน้อย 1 ตัว อักษรตัวพิมพ์เล็กอย่างน้อย 1 ตัว และอักขระตัวเลขอย่างน้อย 1 ตัว
  • สามารถนำไปใช้ซ้ำได้ในหลายเว็บฮุค
ภาษาเพย์โหลด (ประเทศ) เลือกภาษาที่ต้องการสำหรับการแปลข้อมูลการติดตามจากรายการเมนูตัวเลือก
ประเภทการติดตาม เลือกวิธีการส่งข้อมูลการติดตาม:
  • การติดตามโดยละเอียด – ประวัติกิจกรรมทั้งหมด
  • การติดตามเฉพาะกิจกรรม – เฉพาะกิจกรรมล่าสุดเท่านั้น
ที่อยู่อีเมล์ ระบุที่อยู่อีเมลที่ถูกต้องเพื่อรับการแจ้งเตือน
ภาษาอีเมล (ประเทศ) เลือกภาษาที่ต้องการสำหรับการแจ้งเตือนทางอีเมล
หมายเหตุ: รองรับเฉพาะภาษาของสหรัฐอเมริกาเท่านั้น (เช่น en-US, es-US)

 

ขั้นตอนโดยละเอียด

4. สร้างโครงการสมัครรับข้อมูล

  •  ใช้ขั้นตอนจากส่วนก่อนหน้า หรือดูที่คู่มือเริ่มต้นใช้งาน

5. สร้างโทเค็น OAuth

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

6. การเตรียมเอกสารการเข้าถึง API

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

 

ภาพรวมปลายทาง API

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

 

ใช้โทเค็น OAuth จากขั้นตอนที่ 2 ร่วมกับปลายทางการเชื่อมโยงหมายเลขการติดตาม เพื่อเพิ่มหมายเลขการติดตามไปยังเว็บฮุคของคุณ

กฎการตรวจสอบ

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

ผลลัพธ์การตรวจสอบ

สถานะ รายละเอียด
สำเร็จ ข้อความยืนยันจะปรากฏขึ้น:
“<> สร้างเรียบร้อยแล้ว การเปลี่ยนแปลงอาจใช้เวลาถึง 10 นาทีจึงจะมีผล”
ไม่สำเร็จ หาก FedEx ได้รับการตอบกลับอื่นใดนอกเหนือจาก 200 (ตกลง) หรือ 202 (ยอมรับ) การตรวจสอบ URL ปลายทางของเว็บฮุคจะถือว่าล้มเหลว
CLOSE

Response

Copy