การตั้งค่าเว็บฮุคการติดตามสถานะแบบรวมระบบขั้นสูง
ภาพรวม
เว็บฮุคการติดตามสถานะแบบรวมระบบขั้นสูงทำให้ FedEx สามารถส่งการแจ้งเตือนข้อมูลกิจกรรมการติดตามที่ปลอดภัยในแบบเกือบเรียลไทม์ไปยัง URL ปลายทางที่ระบุสำหรับการจัดส่งที่เชื่อมโยงกับหมายเลขบัญชี FedEx อย่างน้อยหนึ่งหมายเลข คุณสามารถสร้างโครงการเว็บฮุคเพื่อเข้าถึงฟังก์ชันนี้ได้ผ่าน FedEx Developer Portal
พาธการนำทาง
คุณสามารถเข้าถึงหน้าการสร้างเว็บฮุคได้ตามวิธีต่อไปนี้:
- ผ่านโครงการของฉัน: แผงการนำทางด้านซ้าย → แท็บเว็บฮุค → +สร้างโครงการเว็บฮุค
ผ่านแคตตาล็อก API:
- แผงการนำทางด้านซ้าย → แคตตาล็อก API
- ค้นหาหรือกรองตามการติดตามสถานะแบบรวมระบบขั้นสูง
- ภาพรวม → คลิกเอกสารประกอบ → ในคอนโซลระบบแซนด์บ็อกซ์ ให้คลิก +สร้างโครงการ
- เอกสาร → คลิก +สร้างโครงการเว็บฮุค
ขั้นตอนการสร้างเว็บฮุค
ขั้นตอนที่ 1: เลือกประเภทบริษัท
คลิก +สร้างโครงการ และเลือกประเภทบริษัทของคุณจากเมนูตัวเลือก:
- จัดส่งกับ FedEx และต้องการผสานรวมเว็บฮุค FedEx เข้ากับระบบของพวกเขา
- ขายหรือมอบโซลูชันซอฟต์แวร์ที่ใช้ข้อมูลของ FedEx และไม่ใช่ผู้ให้บริการ FedEx Compatible ที่ผ่านการรับรอง
- เป็นผู้ให้บริการ FedEx Compatible ที่ผ่านการรับรอง
หมายเหตุ: ขณะนี้ ไม่สามารถใช้โซลูชันเว็บฮุคการติดตามสถานะแบบรวมระบบขั้นสูงของ FedEx กับตัวเลือกนี้ได้ ในฐานะที่เป็นส่วนหนึ่งของ FedEx Compatible Program หากคุณต้องการเข้าถึงการติดตามสถานะแบบรวมระบบพื้นฐานหรือโซลูชันสำหรับการรวมระบบของ FedEx อื่นๆ กรุณาติดต่อผู้จัดการแชนแนลของคุณ หากคุณไม่ทราบว่าใครคือผู้จัดการแชนแนลของคุณ กรุณาติดต่อผู้ดูแลบริษัทของคุณ
จากนั้น ให้เลือกการสมัครรับข้อมูลหมายเลขบัญชีการติดตามสถานะแบบรวมระบบขั้นสูงเป็นประเภทการสมัครรับข้อมูลของคุณ
การสร้างการสมัครรับข้อมูลหมายเลขบัญชีการติดตามสถานะแบบรวมระบบขั้นสูง
กระบวนการนี้มีทั้งหมด 4 ขั้นตอนหลัก:
- จัดการโครงการ
- กรอกรายละเอียดโครงการ
- เลือกบัญชีการจัดส่ง
- ยืนยันรายละเอียดและยอมรับเงื่อนไข
ขั้นตอนที่ 1: กำหนดค่าโครงการ
ในหน้ากำหนดค่าเว็บฮุค:
- หมายเลขบัญชีการเรียกเก็บเงิน
- ตรวจสอบบัญชีการเรียกเก็บเงินตั้งต้น
- หากต้องการเปลี่ยน:
- คลิกเพิ่มบัญชีการเรียกเก็บเงินไปยังองค์กรของคุณ (หากมีบัญชีเดียว) หรือ
- คลิกเลือกบัญชีการเรียกเก็บเงินอื่น (หากมีหลายบัญชี)
หมายเหตุ: จำเป็นต้องมีบัญชีการเรียกเก็บเงินในสหรัฐอเมริกา สำหรับรายละเอียดเกี่ยวกับราคา กรุณาดูที่คู่มือค่าบริการภาพรวมการติดตามสถานะแบบรวมระบบขั้นสูง
การเลือกคุณสมบัติ:
- เลือกคุณสมบัติที่คุณต้องการเปิดใช้งาน แล้วคลิกถัดไป
คำอธิบายคุณสมบัติ
| ชื่อฟิลด์ | คำอธิบาย |
|---|---|
| หลักฐานการส่งมอบ | การยืนยันว่าพัสดุได้รับการจัดส่งเรียบร้อยแล้ว รูปภาพหลักฐานการส่งมอบ (PPODA): จัดเตรียมรูปภาพที่แสดงสถานที่จัดส่งที่แน่นอน ลายเซ็นหลักฐานการส่ง (SPOD): ระบุได้ถึงรูปภาพลายเซ็น ชื่อ วันที่จัดส่ง เวลา และสถานที่ของผู้รับ |
| การแจ้งการจัดส่งโดยประมาณ | ช่วยให้ผู้รับวางแผนโดยการระบุ: วันที่จัดส่งโดยประมาณ (EDD) กรอบเวลาการจัดส่งโดยประมาณ (EDTW) |
| การติดตามกิจกรรม | อนุญาตให้เลือกหมวดหมู่กิจกรรมอย่างน้อยหนึ่งหมวดหมู่เพื่อรับการแจ้งเตือน: จัดส่ง อยู่ระหว่างการขนส่ง การส่งมอบ ข้อยกเว้นของการจัดส่ง ตัวเลือกการจัดส่งแบบกำหนดเอง |
| การกรองตามกิจกรรม | กรองการตอบสนองเว็บฮุคเพื่อรวม: พัสดุขาเข้า พัสดุขาออก การจัดส่งของบุคคลที่สาม |
ในหน้าระบุรายละเอียด กรุณาระบุข้อมูลต่อไปนี้:
| ชื่อฟิลด์ | คำอธิบาย |
|---|---|
| ชื่อโครงการเว็บฮุค | ชื่อสำหรับโครงการเว็บฮุคของคุณที่ไม่ซ้ำกันและไม่ว่างเปล่า ชื่อที่แนะนำซึ่งเป็นชื่อที่กรอกอัตโนมัติ แต่สามารถแก้ไขได้ โดยชื่อนี้จะไม่ซ้ำกับเว็บฮุคอื่น |
| 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 ปลายทาง การตรวจสอบเว็บฮุคจะถือว่าล้มเหลว
