ภาพรวม
เว็บฮุคการติดตามสถานะแบบรวมระบบขั้นสูงทำให้ FedEx สามารถส่งการแจ้งเตือนข้อมูลกิจกรรมการติดตามที่ปลอดภัยในแบบเกือบเรียลไทม์ไปยัง URL ปลายทางที่ระบุสำหรับการจัดส่งที่เชื่อมโยงกับหมายเลขบัญชี FedEx อย่างน้อยหนึ่งหมายเลข คุณสามารถสร้างโครงการเว็บฮุคเพื่อเข้าถึงฟังก์ชันนี้ได้ผ่าน FedEx Developer Portal
พาธการนำทาง
คุณสามารถเข้าถึงหน้าการสร้างเว็บฮุคได้ตามวิธีต่อไปนี้:
- ผ่านโครงการของฉัน: แผงการนำทางด้านซ้าย → แท็บเว็บฮุค → +สร้างโครงการเว็บฮุค
- ผ่านแคตตาล็อก API:
- แผงการนำทางด้านซ้าย → แคตตาล็อก API
- ค้นหาหรือกรองตามการติดตามสถานะแบบรวมระบบขั้นสูง
- ภาพรวม → คลิกเอกสารประกอบ → ในคอนโซลระบบแซนด์บ็อกซ์ ให้คลิก +สร้างโครงการ
- เอกสาร → คลิก +สร้างโครงการเว็บฮุค
ขั้นตอนการสร้างเว็บฮุค
ขั้นตอนที่ 1: เลือกประเภทบริษัท
คลิก +สร้างโครงการ และเลือกประเภทบริษัทของคุณจากเมนูตัวเลือก:
- จัดส่งกับ FedEx และต้องการผสานรวมเว็บฮุค FedEx เข้ากับระบบของพวกเขา
- ขายหรือมอบโซลูชันซอฟต์แวร์ที่ใช้ข้อมูลของ FedEx และไม่ใช่ผู้ให้บริการ FedEx Compatible ที่ผ่านการรับรอง
- เป็นผู้ให้บริการ FedEx Compatible ที่ผ่านการรับรอง
หมายเหตุ: ขณะนี้ ไม่สามารถใช้โซลูชันเว็บฮุคการติดตามสถานะแบบรวมระบบขั้นสูงของ FedEx กับตัวเลือกนี้ได้ ในฐานะที่เป็นส่วนหนึ่งของ FedEx Compatible Program หากคุณต้องการเข้าถึงการติดตามสถานะแบบรวมระบบพื้นฐานหรือโซลูชันสำหรับการรวมระบบของ FedEx อื่นๆ กรุณาติดต่อผู้จัดการแชนแนลของคุณ หากคุณไม่ทราบว่าใครคือผู้จัดการแชนแนลของคุณ กรุณาติดต่อผู้ดูแลบริษัทของคุณ
จากนั้น ให้เลือกการสมัครรับข้อมูลหมายเลขบัญชีการติดตามสถานะแบบรวมระบบขั้นสูงเป็นประเภทการสมัครรับข้อมูลของคุณ
การสร้างการสมัครรับข้อมูลหมายเลขบัญชีการติดตามสถานะแบบรวมระบบขั้นสูง
กระบวนการสร้างมีทั้งหมด 4 ขั้นตอนสำคัญ:
ขั้นตอนที่ 1: เปิดใช้งานการสมัครรับข้อมูลหมายเลขบัญชีการติดตามสถานะแบบรวมระบบขั้นสูง
ขั้นตอนนี้จะดำเนินการโดยผู้ดูแลระบบ FedEx หรือเจ้าหน้าที่ของ FedEx ตามคำขอของลูกค้าบุคคลที่สาม
- เอกสาร MNDA: ผู้ดูแลระบบ FedEx หรือเจ้าหน้าที่ของ FedEx จะรวบรวมข้อตกลงรักษาความลับร่วมกัน (MNDA) และรายการหมายเลขบัญชีบุคคลที่หนึ่ง/ผู้ส่งจำนวนมาก
หมายเหตุ: อนุญาตให้ใช้หมายเลขบัญชีซ้ำที่เชื่อมโยงกับองค์กรอื่นในระหว่างการอัปโหลดนี้ได้
- ระบบจะเปิดใช้งานการกำหนดราคาแบบกำหนดเองในระดับองค์กร หากเป็นไปได้
หมายเหตุ: ฟังก์ชันนี้ไม่รวมอยู่ในการเปิดตัวช่วงเดือนกรกฎาคม
ขั้นตอนที่ 2: + สร้างโครงการ
ในหน้าเลือกผลิตภัณฑ์:
- คลิกที่การติดตามสถานะแบบรวมระบบขั้นสูง – หมายเลขบัญชี จากนั้นคลิกถัดไป
- เลือกบัญชีการเรียกเก็บเงิน และยอมรับเงื่อนไขการชำระเงิน แล้วคลิกถัดไป
ต้องเพิ่มบัญชีสำหรับการเรียกเก็บเงินอย่างน้อยหนึ่งบัญชี
ในหน้ายืนยันรายละเอียด:
- ตรวจสอบข้อมูลโครงการ
- ยอมรับข้อกำหนดและเงื่อนไข
- หากใช้การกำหนดราคาแบบกำหนดเอง เอกสารที่เกี่ยวข้องจะปรากฏขึ้นโดยอัตโนมัติ
เมื่อสร้างสำเร็จแล้ว ข้อความยืนยันจะปรากฏขึ้น:
“คุณได้เพิ่มผลิตภัณฑ์ไปยัง “โครงการของฉัน” เรียบร้อยแล้ว”
ขั้นตอนที่ 3: ภาพรวมโครงการ – กระบวนการเปิดใช้งานรหัส API
- ในหน้าภาพรวมโครงการ ภายใต้แท็บรหัส API ในส่วน API สถานะการใช้งานจริงสำหรับการสมัครรับข้อมูลจะแสดงเป็น “ปิดใช้งาน” ในตอนแรก
- ผู้ดูแลระบบหรือเจ้าหน้าที่ของ FedEx จะเปิดใช้ผลิตภัณฑ์เมื่อมีการร้องขอ
- เมื่อเปิดใช้งานแล้ว แท็บรหัสการใช้งานจริงจะสามารถเข้าถึงได้ และสถานะการใช้งานจริงจะได้รับการอัปเดตเป็น “กำลังรอการยืนยัน”
- หลังจากการเปิดใช้งานครั้งสุดท้ายโดยผู้ดูแลระบบหรือเจ้าหน้าที่ของ FedEx สถานะการใช้งานจริงจะแสดงเป็น “เปิดใช้งาน”
ขั้นตอนที่ 4: ภาพรวมโครงการ – กำหนดค่าเว็บฮุค
- นำทางไปยังหน้าภาพรวมโครงการ
- เลือกแท็บเว็บฮุค
- คลิกปุ่ม + กำหนดค่าเว็บฮุคเพื่อเริ่มกำหนดค่าเว็บฮุค ระบบจะนำคุณไปยังแท็บเว็บฮุค
คำอธิบายคุณสมบัติ
| ชื่อฟิลด์ | คำอธิบาย |
|---|---|
| หลักฐานการส่งมอบ | การยืนยันว่าพัสดุได้รับการจัดส่งเรียบร้อยแล้ว ซึ่งรวมถึง: รูปภาพหลักฐานการส่งมอบ (PPOD): จัดเตรียมรูปภาพที่แสดงสถานที่จัดส่งที่แน่นอน ลายเซ็นหลักฐานการส่ง (SPOD): ระบุได้ถึงรูปภาพลายเซ็น ชื่อ วันที่จัดส่ง เวลา และสถานที่ของผู้รับ |
| การแจ้งการจัดส่งโดยประมาณ | ช่วยให้ผู้รับวางแผนโดยการระบุ: วันที่จัดส่งโดยประมาณ (EDD) กรอบเวลาการจัดส่งโดยประมาณ (EDTW) |
| การติดตามกิจกรรม | อนุญาตให้เลือกหมวดหมู่กิจกรรมอย่างน้อยหนึ่งหมวดหมู่เพื่อรับการแจ้งเตือน: จัดส่ง อยู่ระหว่างการขนส่ง การส่งมอบ ข้อยกเว้นของการจัดส่ง ตัวเลือกการจัดส่งแบบกำหนดเอง |
| การกรองตามกิจกรรม | กรองการตอบสนองเว็บฮุคเพื่อรวม: พัสดุขาเข้า พัสดุขาออก การจัดส่งของบุคคลที่สาม |
2. ในหน้าระบุรายละเอียด กรุณาระบุข้อมูลต่อไปนี้:
| ชื่อฟิลด์ | คำอธิบาย |
|---|---|
| ชื่อโครงการเว็บฮุค | ชื่อสำหรับโครงการเว็บฮุคของคุณที่ไม่ซ้ำกันและไม่ว่างเปล่า ชื่อที่แนะนำซึ่งเป็นชื่อที่กรอกอัตโนมัติ แต่สามารถแก้ไขได้ โดยชื่อนี้จะไม่ซ้ำกับเว็บฮุคอื่น |
| URL ปลายทาง | ปลายทาง HTTPS ที่ปลอดภัยที่ FedEx จะส่งข้อมูลการติดตามกิจกรรม ข้อกำหนด: ต้องถูกต้องและใช้งานได้ ต้องเป็นไปตามไวยากรณ์มาตรฐาน ต้องไม่มี fedex.com หรือโดเมนย่อยของ fedex.com สามารถนำไปใช้ซ้ำได้ในหลายเว็บฮุค กรุณาดูรายละเอียดเพิ่มเติมที่ส่วนกฎการดำเนินธุรกิจและแนวปฏิบัติที่ดีที่สุด |
| โทเค็นรักษาความปลอดภัย | ข้อมูลลับร่วมที่ใช้ในการรับรองความถูกต้องและตรวจสอบการตอบกลับของเว็บฮุคผ่าน HMAC ข้อกำหนด: อักขระ 26–100 ตัว ต้องประกอบด้วยอักษรตัวพิมพ์ใหญ่อย่างน้อย 1 ตัว อักษรตัวพิมพ์เล็กอย่างน้อย 1 ตัว และอักขระตัวเลขอย่างน้อย 1 ตัว สามารถนำไปใช้ซ้ำได้ในหลายเว็บฮุค |
| ภาษาเพย์โหลด (ประเทศ) | เลือกภาษาที่ต้องการสำหรับการแปลข้อมูลการติดตามจากรายการเมนูตัวเลือก |
| ประเภทการติดตาม | เลือกวิธีการจัดส่งข้อมูลการติดตาม: การติดตามโดยละเอียด – ประวัติกิจกรรมทั้งหมด การติดตามเฉพาะกิจกรรม – เฉพาะกิจกรรมล่าสุดเท่านั้น |
| ที่อยู่อีเมล์ | ระบุที่อยู่อีเมลที่ถูกต้องเพื่อรับการแจ้งเตือน |
| ภาษาอีเมล (ประเทศ) | เลือกภาษาที่ต้องการสำหรับการแจ้งเตือนทางอีเมล หมายเหตุ: รองรับเฉพาะภาษาของสหรัฐอเมริกาเท่านั้น (เช่น 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 ปลายทาง การตรวจสอบเว็บฮุคจะถือว่าล้มเหลว
