Fedex Logo

ภาพรวม

เว็บฮุคการติดตามสถานะแบบรวมระบบขั้นสูงทำให้ 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. คลิกปุ่ม + กำหนดค่าเว็บฮุคเพื่อเริ่มกำหนดค่าเว็บฮุค โดยระบบจะนำคุณไปยังแท็บเว็บฮุค

 

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

ชื่อฟิลด์ คำอธิบาย
หลักฐานการส่งมอบ การยืนยันว่าพัสดุได้รับการจัดส่งเรียบร้อยแล้ว ประกอบด้วย:
  • รูปภาพหลักฐานการส่งมอบ (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 ปลายทาง การตรวจสอบเว็บฮุคจะถือว่าล้มเหลว

CLOSE

Response

Copy