ภาพรวม
เว็บฮุคการติดตามสถานะแบบรวมระบบขั้นสูงทำให้ FedEx สามารถส่งการแจ้งเตือนข้อมูลกิจกรรมการติดตามที่ปลอดภัยในแบบเกือบเรียลไทม์ไปยัง URL ปลายทางที่ระบุสำหรับการจัดส่งที่เชื่อมโยงกับหมายเลขบัญชี FedEx อย่างน้อยหนึ่งหมายเลข คุณสามารถสร้างโครงการเว็บฮุคเพื่อเข้าถึงฟังก์ชันนี้ได้ผ่าน FedEx Developer Portal
พาธการนำทาง
คุณสามารถเข้าถึงหน้าการสร้างเว็บฮุคได้ตามวิธีต่อไปนี้:
1. ผ่านทางโครงการของฉัน:
- แผงการนำทางด้านซ้าย → แท็บเว็บฮุค → +สร้างโครงการเว็บฮุค
2. ผ่านแคตตาล็อก API:
แผงการนำทางด้านซ้าย → แคตตาล็อก API
ค้นหาหรือกรองตามการติดตามสถานะแบบรวมระบบขั้นสูง
เลือก:
- ภาพรวม → คลิก เอกสารประกอบ → ในคอนโซลระบบแซนด์บ็อกซ์ ให้คลิก +สร้างโครงการ
- เอกสาร → คลิก +สร้างโครงการเว็บฮุค
ขั้นตอนการสร้างเว็บฮุค
ขั้นตอนที่ 1: เลือกประเภทบริษัท
คลิก +สร้างโครงการ และเลือกประเภทบริษัทของคุณจากเมนูตัวเลือก:
1. จัดส่งกับ FedEx และต้องการผสานรวมเว็บฮุค FedEx เข้ากับระบบของพวกเขา
2. ขายหรือมอบโซลูชันซอฟต์แวร์ที่ใช้ข้อมูลของ FedEx และไม่ใช่ผู้ให้บริการ FedEx Compatible ที่ผ่านการรับรอง
3. เป็นผู้ให้บริการ FedEx Compatible ที่ผ่านการรับรอง
หมายเหตุ: ขณะนี้ ไม่สามารถใช้โซลูชันเว็บฮุคการติดตามสถานะแบบรวมระบบขั้นสูงของ FedEx กับตัวเลือกนี้ได้ ในฐานะที่เป็นส่วนหนึ่งของ FedEx Compatible Program หากคุณต้องการเข้าถึงการติดตามสถานะแบบรวมระบบพื้นฐานหรือโซลูชันสำหรับการรวมระบบของ FedEx อื่นๆ กรุณาติดต่อผู้จัดการแชนแนลของคุณ หากคุณไม่ทราบว่าใครคือผู้จัดการแชนแนลของคุณ กรุณาติดต่อผู้ดูแลบริษัทของคุณ
จากนั้น ให้เลือกการสมัครรับข้อมูลหมายเลขบัญชีการติดตามสถานะแบบรวมระบบขั้นสูงเป็นประเภทการสมัครรับข้อมูลของคุณ
การสร้างการสมัครรับข้อมูลหมายเลขบัญชีการติดตามสถานะแบบรวมระบบขั้นสูง
กระบวนการสร้างมีทั้งหมด 4 ขั้นตอนสำคัญ:
ขั้นตอนที่ 1: เปิดใช้งานการสมัครรับข้อมูลหมายเลขบัญชีการติดตามสถานะแบบรวมระบบขั้นสูง
ขั้นตอนนี้จะดำเนินการโดยผู้ดูแลระบบ FedEx หรือเจ้าหน้าที่ของ FedEx ตามคำขอของลูกค้าบุคคลที่สาม
- เอกสาร MNDA: ผู้ดูแลระบบ FedEx หรือเจ้าหน้าที่ของ FedEx จะรวบรวมข้อตกลงรักษาความลับร่วมกัน (MNDA) และรายการหมายเลขบัญชีบุคคลที่หนึ่ง/ผู้ส่งจำนวนมาก
หมายเหตุ: อนุญาตให้ใช้หมายเลขบัญชีซ้ำที่เชื่อมโยงกับองค์กรอื่นในระหว่างการอัปโหลดนี้ได้
- ระบบจะเปิดใช้งานการกำหนดราคาแบบกำหนดเองในระดับองค์กร หากเป็นไปได้
หมายเหตุ: ฟังก์ชันนี้ไม่รวมอยู่ในการเปิดตัวช่วงเดือนกรกฎาคม
ขั้นตอนที่ 2: + สร้างโครงการ
ในหน้าเลือกผลิตภัณฑ์:
1. คลิกที่การติดตามสถานะแบบรวมระบบขั้นสูง – หมายเลขบัญชี จากนั้นคลิกถัดไป
2. เลือกบัญชีการเรียกเก็บเงิน และยอมรับเงื่อนไขการชำระเงิน แล้วคลิกถัดไป
ต้องเพิ่มบัญชีสำหรับการเรียกเก็บเงินอย่างน้อยหนึ่งบัญชี
3. ในหน้ายืนยันรายละเอียด:
- ตรวจสอบข้อมูลโครงการ
- ยอมรับข้อกำหนดและเงื่อนไข
- หากใช้การกำหนดราคาแบบกำหนดเอง เอกสารที่เกี่ยวข้องจะปรากฏขึ้นโดยอัตโนมัติ
4. เมื่อสร้างสำเร็จแล้ว ข้อความยืนยันจะปรากฏขึ้น:
“คุณได้เพิ่มผลิตภัณฑ์ไปยัง “โครงการของฉัน” เรียบร้อยแล้ว”
5. ภาพรวมโครงการ – กระบวนการเปิดใช้งานรหัส API
- ในหน้าภาพรวมโครงการ ภายใต้แท็บรหัส API ในส่วน API สถานะการใช้งานจริงสำหรับการสมัครรับข้อมูลจะแสดงเป็น “ปิดใช้งาน” ในตอนแรก
- ผู้ดูแลระบบหรือเจ้าหน้าที่ของ FedEx จะเปิดใช้ผลิตภัณฑ์เมื่อมีการร้องขอ
- เมื่อเปิดใช้งานแล้ว แท็บรหัสการใช้งานจริงจะสามารถเข้าถึงได้ และสถานะการใช้งานจริงจะได้รับการอัปเดตเป็น “กำลังรอการยืนยัน”
- หลังจากการเปิดใช้งานครั้งสุดท้ายโดยผู้ดูแลระบบหรือเจ้าหน้าที่ของ FedEx สถานะการใช้งานจริงจะแสดงเป็น “เปิดใช้งาน”
ขั้นตอนที่ 3: ภาพรวมโครงการ – กำหนดค่าเว็บฮุค
1. นำทางไปยังหน้าภาพรวมโครงการ
2. เลือกแท็บเว็บฮุค
3. คลิกปุ่ม + กำหนดค่าเว็บฮุคเพื่อเริ่มกำหนดค่าเว็บฮุค โดยระบบจะนำคุณไปยังแท็บเว็บฮุค
คำอธิบายคุณสมบัติ
| ชื่อฟิลด์ | คำอธิบาย |
|---|---|
| หลักฐานการส่งมอบ | การยืนยันว่าพัสดุได้รับการจัดส่งเรียบร้อยแล้ว ประกอบด้วย:
|
| การแจ้งการจัดส่งโดยประมาณ | ช่วยให้ผู้รับวางแผนได้โดยการ:
|
| การติดตามกิจกรรม | อนุญาตให้เลือกหมวดหมู่กิจกรรมอย่างน้อยหนึ่งหมวดหมู่เพื่อรับการแจ้งเตือน:
|
| การกรองตามกิจกรรม | กรองการตอบสนองของเว็บฮุคเพื่อให้รวมถึง:
|
2. ในหน้าระบุรายละเอียด กรุณาระบุข้อมูลต่อไปนี้:
| ชื่อฟิลด์ | คำอธิบาย |
|---|---|
| ชื่อโครงการเว็บฮุค | ชื่อสำหรับโครงการเว็บฮุคของคุณที่ไม่ซ้ำกันและไม่ว่างเปล่า ชื่อที่แนะนำซึ่งเป็นชื่อที่กรอกอัตโนมัติ แต่สามารถแก้ไขได้ โดยชื่อนี้จะไม่ซ้ำกับเว็บฮุคอื่น |
| URL ปลายทาง | ปลายทาง HTTPS ที่ปลอดภัยที่ FedEx จะส่งข้อมูลการติดตามกิจกรรม ข้อกำหนด:
|
| โทเค็นรักษาความปลอดภัย | ข้อมูลลับร่วมที่ใช้ในการรับรองความถูกต้องและตรวจสอบการตอบกลับของเว็บฮุคผ่าน HMAC ข้อกำหนด:
|
| ภาษาเพย์โหลด (ประเทศ) | เลือกภาษาที่ต้องการสำหรับการแปลข้อมูลการติดตามจากรายการเมนูตัวเลือก |
| ประเภทการติดตาม | เลือกวิธีการส่งข้อมูลการติดตาม:
|
| ที่อยู่อีเมล์ | ระบุที่อยู่อีเมลที่ถูกต้องเพื่อรับการแจ้งเตือน |
| ภาษาอีเมล (ประเทศ) | เลือกภาษาที่ต้องการสำหรับการแจ้งเตือนทางอีเมล หมายเหตุ รองรับเฉพาะภาษาของสหรัฐอเมริกาเท่านั้น (เช่น en-US, es-US) |
ขั้นตอนที่ 3: เลือกบัญชีการจัดส่ง
ในหน้าเลือกบัญชีการจัดส่ง:
- เลือกหมายเลขบัญชี FedExอย่างน้อยหนึ่งหมายเลข เพื่อเชื่อมโยงกับโครงการเว็บฮุคของคุณ
หมายเหตุสำคัญ:
- แสดงเฉพาะบัญชีที่ไม่ได้เชื่อมโยงกับเว็บฮุคอื่นอยู่แล้วเท่านั้น
- คุณต้องเชื่อมโยงบัญชีอย่างน้อยหนึ่งบัญชี เพื่อดำเนินการต่อ
- สามารถเพิ่มบัญชีได้สูงสุด 100 บัญชีผ่าน UI เว็บฮุค
- หากต้องการเชื่อมโยงบัญชีมากกว่า 100 บัญชี ให้ใช้ API เว็บฮุค
ติดต่อฝ่ายบริการลูกค้าของ FedEx หรือแผนกสนับสนุนเพื่อขอการเข้าถึง API
ขั้นตอนที่ 4: ยืนยันรายละเอียดและสร้าง
ในหน้ายืนยันรายละเอียด:
1. ตรวจสอบข้อมูลทั้งหมดที่คุณระบุสำหรับโครงการเว็บฮุค
2. ทำเครื่องหมายที่ช่องเพื่อยอมรับข้อกำหนดและเงื่อนไข
3. คลิกสร้างเพื่อจบขั้นตอนการตั้งค่าเว็บฮุค
เมื่อส่งข้อมูลเสร็จสมบูรณ์ เว็บฮุคจะถูกสร้างขึ้นพร้อม ID การสมัครรับข้อมูลที่ระบบสร้างขึ้น และจะถูกตั้งค่าให้อยู่ในสถานะใช้งาน
กฎการตรวจสอบ
ข้อกำหนดทั่วไป:
- ชื่อเว็บฮุคต้องไม่ซ้ำกัน
- URL ปลายทางต้องอยู่ในรูปแบบไวยากรณ์มาตรฐาน (HTTPS ที่ปลอดภัย ไม่มี fedex.com หรือโดเมนย่อยของ fedex.com)
- ต้องกรอกข้อมูลในฟิลด์ที่ต้องระบุให้ครบถ้วน และไม่ควรเว้นว่างฟิลด์ที่จำเป็นต้องกรอก
- ต้องมีหมายเลขบัญชีการจัดส่งของ FedEx ที่ถูกต้องอย่างน้อยหนึ่งหมายเลขที่เชื่อมโยงกับเว็บฮุค
การตรวจสอบที่เสร็จเรียบร้อยแล้ว:
หากสร้างเว็บฮุคสำเร็จแล้ว ลูกค้าจะได้รับข้อความยืนยัน:
<<Webhook name>> ถูกสร้างเรียบร้อยแล้ว การเปลี่ยนแปลงอาจใช้เวลาถึง 10 นาทีจึงจะมีผล
การตรวจสอบที่ไม่สำเร็จ/ล้มเหลว:
หาก FedEx ได้รับการตอบกลับอื่นใดที่ไม่ใช่ HTTP 200 (ตกลง) หรือ 202 (ยอมรับ) จาก URL ปลายทาง การตรวจสอบเว็บฮุคจะถือว่าล้มเหลว
Response