วิธีเชื่อมต่อข้อมูลการติดตามการจัดส่งกับ Oms: การแมปคำสั่งซื้อและกฎการซิงค์
ในการเชื่อมต่อข้อมูลการติดตามการจัดส่งเข้ากับระบบจัดการคำสั่งซื้อ (OMS) ให้จับคู่พัสดุแต่ละรายการที่ติดตามกับระเบียนการจัดส่งภายใน จากนั้นเชื่อมโยงการจัดส่งนั้นกับคำสั่งซื้อและรายการการจัดส่งสินค้า รับการอัปเดตการติดตามผ่านอินเทอร์เฟซที่ผู้ให้บริการรองรับ เก็บรักษาเหตุการณ์ต้นฉบับไว้ และใช้กฎที่ชัดเจนสำหรับรายการซ้ำ การอัปเดตล่าช้า สถานะการจัดส่ง และการดำเนินการคำสั่งซื้อให้เสร็จสมบูรณ์ อย่าใช้หมายเลขติดตามเพียงอย่างเดียวเป็นตัวระบุคำสั่งซื้อ หรือปล่อยให้เหตุการณ์การจัดส่งเพียงครั้งเดียวปิดคำสั่งซื้อที่มีหลายพัสดุโดยอัตโนมัติ
คู่มือนี้จัดทำขึ้นสำหรับวิศวกรด้านการผสานรวมระบบและทีมปฏิบัติการอีคอมเมิร์ซที่กำลังนำการเชื่อมต่อนี้ไปใช้งาน การออกแบบที่แนะนำจะแยกข้อมูลที่ผู้ให้บริการขนส่งสังเกตได้ออกจากการตัดสินใจทางธุรกิจ โดยข้อมูลการติดตามจะอธิบายเส้นทางของพัสดุ ขณะที่ OMS เป็นผู้ตัดสินใจว่าเส้นทางดังกล่าวมีความหมายอย่างไรต่อการดำเนินการจัดส่ง การสื่อสารกับลูกค้า และการปิดคำสั่งซื้อ
กำหนดว่าระบบใดเป็นเจ้าของระเบียนแต่ละประเภท
ก่อนสร้างการเชื่อมต่อ API ให้ตกลงเรื่องความเป็นเจ้าของกับผู้ดูแล OMS ทีมดำเนินการจัดส่ง และทีมบริการลูกค้า มิฉะนั้น การผสานรวมที่ประสบความสำเร็จทางเทคนิคก็ยังอาจเขียนทับข้อมูลทางธุรกิจที่ถูกต้องได้
- OMS: เป็นเจ้าของคำสั่งซื้อ รายการคำสั่งซื้อ จำนวนที่ต้องจัดส่ง การยกเลิก และกฎสำหรับการดำเนินการคำสั่งซื้อให้เสร็จสมบูรณ์
- ระบบดำเนินการจัดส่ง: เป็นเจ้าของระเบียนการจัดส่งหรือพัสดุที่ระบบสร้างขึ้น รวมถึงการจัดสรรเพื่อบรรจุหีบห่อและการกำหนดป้ายจัดส่ง ระบบนี้อาจเป็น OMS เองหรือเป็นระบบคลังสินค้าแยกต่างหาก
- ผู้ให้บริการติดตาม: จัดเตรียมข้อมูลการสังเกตการติดตามและการจัดประเภทสถานะที่ผู้ให้บริการกำหนด
- ชั้นการผสานรวม: เป็นเจ้าของการอ้างอิงไขว้ของตัวระบุ การประมวลผลเหตุการณ์ การทำข้อมูลให้เป็นมาตรฐาน การจัดการการลองใหม่ และระเบียนตรวจสอบการซิงโครไนซ์
ให้ถือว่าสิ่งเหล่านี้เป็นขอบเขตที่แนะนำ ไม่ใช่ข้อสมมติ לגביซอฟต์แวร์ของคุณ จัดทำเอกสารสำหรับข้อยกเว้น ตัวอย่างเช่น หากคลังสินค้าสามารถเปลี่ยนป้ายจัดส่งได้ การผสานรวมต้องได้รับการอัปเดตอย่างชัดเจนจากระบบนั้น แทนที่จะคาดเดาว่าหมายเลขที่ตรวจพบใหม่แทนที่หมายเลขเดิม
สร้างการจับคู่ระหว่างคำสั่งซื้อกับพัสดุก่อนซิงโครไนซ์สถานะ
ความสัมพันธ์ที่ใช้งานได้จริงคือ คำสั่งซื้อ → การดำเนินการจัดส่ง → พัสดุ → การกำหนดหมายเลขติดตาม OMS ของคุณอาจใช้ชื่อที่แตกต่างกันหรือรวมระเบียนบางประเภทเข้าด้วยกัน ให้รักษาความสัมพันธ์เหล่านี้ไว้แม้โครงสร้างฐานข้อมูลจะแตกต่างกัน
คำสั่งซื้อหนึ่งรายการอาจมีการดำเนินการจัดส่งหลายรายการ และการดำเนินการจัดส่งหนึ่งรายการอาจประกอบด้วยหลายพัสดุ พัสดุหนึ่งรายการอาจได้รับการกำหนดหมายเลขติดตามใหม่หรือมีตัวระบุการจัดส่งช่วงสุดท้ายที่เชื่อมโยงอยู่ ตัวระบุเหล่านั้นไม่ควรสร้างจำนวนสินค้าที่สั่งซื้อเพิ่มเติม
| ระเบียน | ฟิลด์ที่แนะนำ | วัตถุประสงค์ |
|---|---|---|
| คำสั่งซื้อ | รหัสผู้เช่าหรือร้านค้า, รหัสคำสั่งซื้อ OMS ที่ไม่เปลี่ยนแปลง | แยกผู้ค้าออกจากกันและหลีกเลี่ยงการพึ่งพาหมายเลขคำสั่งซื้อที่แสดง |
| การดำเนินการจัดส่ง | รหัสการดำเนินการจัดส่ง, รหัสคำสั่งซื้อ, รหัสรายการและจำนวนที่จัดสรร | ระบุว่าสินค้าที่ซื้อรายการใดกำลังดำเนินการจัดส่ง |
| พัสดุ | รหัสพัสดุภายใน, รหัสการดำเนินการจัดส่ง, การจัดสรรพัสดุเมื่อมีข้อมูล | มอบตัวตนที่คงที่ซึ่งเป็นอิสระจากป้ายติดตาม |
| การกำหนดหมายเลขติดตาม | รหัสการกำหนด, รหัสพัสดุ, บัญชีผู้ให้บริการ, ตัวระบุผู้ขนส่ง, หมายเลขติดตาม, ช่วงเวลาที่ใช้งาน | เชื่อมโยงข้อมูลการติดตามขาเข้ากับพัสดุและวงจรชีวิตของการกำหนดที่ถูกต้อง |
จับคู่การอัปเดตผ่านการอ้างอิงไขว้ที่จัดเก็บไว้
เมื่อสร้างการจัดส่ง ให้บันทึกรหัสภายในก่อนลงทะเบียนเพื่อติดตาม จัดเก็บรหัสระเบียนการติดตามที่ผู้ให้บริการออกให้ซึ่งส่งกลับจากกระบวนการลงทะเบียนตามเอกสาร หากผู้ให้บริการรองรับการอ้างอิงของผู้ค้า ให้ใช้การอ้างอิงภายในแบบทึบแสงและเก็บการจับคู่ไว้ภายในระบบ
สำหรับการอัปเดตขาเข้า ให้ค้นหารหัสระเบียนของผู้ให้บริการที่จัดเก็บไว้ภายในบัญชีผู้ให้บริการและผู้เช่าที่ถูกต้องก่อน หากไม่มีตัวระบุดังกล่าว ให้ใช้ชุดข้อมูลที่เอกสารกำหนด ได้แก่ หมายเลขติดตาม ตัวตนของผู้ขนส่ง บริบทบัญชี และประวัติการกำหนด ให้ถือว่านี่เป็นกลยุทธ์การค้นหา ไม่ใช่การรับประกันว่าชุดข้อมูลดังกล่าวไม่ซ้ำกันทั่วโลก
อย่าจับคู่โดยใช้ชื่อลูกค้า ที่อยู่อีเมล หรือหมายเลขคำสั่งซื้อที่แสดงโดยไม่มีขอบเขต เก็บหมายเลขติดตามเป็นสตริงเพื่อรักษาเลขศูนย์นำหน้า หลีกเลี่ยงการตัดอักขระหรือเปลี่ยนตัวพิมพ์ เว้นแต่สัญญาของผู้ขนส่งหรือผู้ให้บริการที่เกี่ยวข้องจะอนุญาตให้ทำให้เป็นมาตรฐานได้
หากการค้นหาไม่พบรายการที่ตรงกันหรือพบรายการที่เป็นไปได้หลายรายการ ให้แยกการอัปเดตนั้นไว้เพื่อตรวจสอบ เหตุการณ์ที่ยังระบุไม่ได้ปลอดภัยกว่าการอัปเดตคำสั่งซื้อของลูกค้าผิดรายอย่างมั่นใจ
จัดการคำสั่งซื้อแบบแยกส่งโดยไม่สร้างการจัดสรรพัสดุขึ้นเอง
พิจารณาคำสั่งซื้อสมมติที่มีสินค้า 3 ชิ้น พัสดุ A บรรจุ 2 ชิ้น และพัสดุ B บรรจุ 1 ชิ้น การจัดส่งพัสดุ A หมายความว่ามีหลักฐานการจัดส่งสำหรับสินค้า 2 ชิ้น ไม่ได้หมายความว่าคำสั่งซื้อทั้งหมดได้รับการจัดส่งแล้ว
หากระบบดำเนินการจัดส่งบันทึกเพียงว่าพัสดุทั้งสองอยู่ภายใต้การดำเนินการจัดส่งเดียวกัน อย่าสร้างการจัดสรรระดับหน่วยขึ้นเอง คุณยังคำนวณได้ว่าพัสดุที่จำเป็นทั้งหมดได้รับการจัดส่งแล้วหรือไม่ แต่การรายงานการจัดส่งระดับรายการสินค้าควรยังไม่พร้อมใช้งานหรือระบุอย่างชัดเจนว่าไม่แน่นอนจนกว่าจะมีข้อมูลการจัดสรร
เชื่อมต่อ Tracking API ผ่านชั้นรับข้อมูลที่ทนทาน
ใช้กระบวนการที่แยกการสื่อสารกับผู้ให้บริการออกจากการเขียนข้อมูลลง OMS:
การสร้างการจัดส่ง → การลงทะเบียนติดตาม → การอัปเดตขาเข้าหรือการดึงข้อมูลตามกำหนดเวลา → การจัดเก็บเหตุการณ์แบบทนทาน → การจับคู่และการทำให้เป็นมาตรฐาน → การอัปเดต OMS → การกระทบยอด
สำหรับการใช้งาน 17TRACK หน้า ผลิตภัณฑ์ Tracking API และ เอกสาร API อย่างเป็นทางการ เป็นจุดเริ่มต้นที่เกี่ยวข้อง ยืนยันอินเทอร์เฟซการลงทะเบียนที่ใช้ได้ ตัวระบุผู้ขนส่ง ตัวเลือกการส่งการอัปเดต ข้อกำหนดการยืนยันตัวตน คำจำกัดความสถานะ และขีดจำกัดบัญชีก่อนใช้อะแดปเตอร์ โมเดลข้อมูลในคู่มือนี้เป็นคำแนะนำด้านการผสานรวม ไม่ใช่การอ้างว่า 17TRACK ใช้ชื่อฟิลด์เหล่านี้หรือมีตัวเชื่อมต่อแบบเนทีฟสำหรับ OMS ของคุณ
หากผู้ให้บริการที่คุณเลือกใช้ webhook ได้ ให้ยืนยันตัวตนคำขอขาเข้าโดยใช้กลไกตามเอกสาร และจัดเก็บข้อความที่ยอมรับแล้วอย่างทนทานก่อนตอบรับ นำงาน OMS ที่ใช้เวลานานออกจากเส้นทางคำขอ ปฏิบัติตามสัญญาการตอบรับและการลองใหม่จริงของผู้ให้บริการ แทนการสมมติรูปแบบเนื้อหาการตอบกลับหรือเวลาหมดเวลาแบบใดแบบหนึ่ง
หากจำเป็นต้องใช้การสำรวจข้อมูล ให้จัดเก็บความคืบหน้าในการดึงข้อมูลในกรณีที่ API รองรับ ควบคุมการทำงานพร้อมกัน และปฏิบัติตามขีดจำกัดอัตราตามเอกสาร การได้รับ webhook หรือคำขอสำรวจข้อมูลที่สำเร็จไม่ได้พิสูจน์ว่า OMS ได้รับการอัปเดตแล้ว ให้บันทึกผลลัพธ์เหล่านั้นแยกกัน
กำหนดกฎการซิงโครไนซ์ที่รองรับการลองใหม่และเหตุการณ์ล่าช้า
1. ทำให้การประมวลผลเป็น idempotent
การประมวลผลข้อมูลสังเกตเดียวกันสองครั้งไม่ควรสร้างการจัดส่งซ้ำ เพิ่มจำนวนสองครั้ง หรือส่งการแจ้งเตือนลูกค้าซ้ำ HTTP ไม่ได้ทำให้การดำเนินการ POST ใด ๆ เป็น idempotent โดยอัตโนมัติ การผสานรวมต้องใช้กลไกป้องกันรายการซ้ำเอง RFC 9110 อธิบาย idempotency ของเมธอด HTTP
ใช้รหัสเหตุการณ์ของผู้ให้บริการที่คงที่เมื่อมีการระบุไว้ในเอกสารและพร้อมใช้งาน มิฉะนั้น ให้กำหนดลายนิ้วมือจากรหัสการกำหนดและฟิลด์เหตุการณ์ที่เกี่ยวข้อง เช่น เวลาของเหตุการณ์ สถานะต้นทาง และตำแหน่ง จัดทำเอกสารเกี่ยวกับความเป็นไปได้ของการชนกันหรือคำอธิบายเหตุการณ์ที่เปลี่ยนแปลง เก็บข้อมูลสังเกตดิบไว้แม้จะไม่ทำให้เกิดการดำเนินการเพิ่มเติมใน OMS
ป้องกันผลข้างเคียงแต่ละรายการแยกจากกัน ตัวอย่างเช่น การเขียนสถานะ OMS และการแจ้งเตือนทางอีเมลต้องมีการควบคุมการกำจัดรายการซ้ำของตนเอง ใช้ transactional outbox หรือระเบียนงานแบบทนทานที่เทียบเท่า เพื่อไม่ให้การหยุดทำงานของกระบวนการทำให้เหตุการณ์ที่ยอมรับแล้วไม่มีการอัปเดตตามกำหนด
2. จัดเก็บเวลาของเหตุการณ์และเวลาที่รับแยกกัน
เวลาที่เหตุการณ์เกิดขึ้นและเวลาที่การผสานรวมของคุณได้รับเหตุการณ์นั้นตอบคำถามคนละข้อ ให้จัดเก็บทั้งสองค่า รวมถึงรูปแบบเวลาต้นฉบับและออฟเซ็ตเขตเวลาที่ระบุ อย่ากำหนดเขตเวลาของคลังสินค้าให้กับเหตุการณ์ที่ไม่ทราบเขตเวลาโดยไม่แจ้งให้ทราบ
การสแกนระหว่างการขนส่งที่มาถึงล่าช้าควรเพิ่มข้อมูลลงในประวัติโดยไม่แทนที่สถานะจัดส่งล่าสุดตามปกติ อย่างไรก็ตาม การใช้เวลาเพียงอย่างเดียวไม่เพียงพอ ผู้ให้บริการอาจออกการแก้ไข และเหตุการณ์อาจมีข้อมูลเวลาไม่ครบถ้วน ใช้ฟิลด์ลำดับหรือการแก้ไขตามเอกสารเมื่อมี พร้อมนโยบายการแก้ไขที่ชัดเจน
3. ทำสถานะให้เป็นมาตรฐานโดยไม่ลบรายละเอียดจากแหล่งที่มา
สร้างคำศัพท์ภายในขนาดเล็กที่ OMS เข้าใจ เช่น รอผู้ขนส่งรับสินค้า อยู่ระหว่างการขนส่ง กำลังนำจ่าย จัดส่งแล้ว มีข้อยกเว้น และกำลังส่งคืน จับคู่สถานะตามเอกสารของผู้ให้บริการเข้ากับคำศัพท์ดังกล่าว หมวดหมู่เหล่านี้เป็นหมวดหมู่ภายในที่แนะนำ ไม่ใช่คำจำกัดความสากลของผู้ขนส่งทุกราย
จัดเก็บรหัสสถานะต้นฉบับ คำอธิบาย ตำแหน่งเหตุการณ์ การอ้างอิงระเบียนของผู้ให้บริการ และเวอร์ชันกฎการจับคู่ ค่าที่ไม่สามารถจับคู่ได้ควรสร้างเงื่อนไขที่ตรวจสอบได้ แทนที่จะกำหนดค่าเริ่มต้นเป็นจัดส่งแล้วหรือล้มเหลว การสร้างป้ายจัดส่งไม่ควรถูกถือเป็นหลักฐานว่าผู้ขนส่งรับสินค้าจริง เว้นแต่เหตุการณ์ต้นทางจะรองรับการตีความดังกล่าวอย่างชัดเจน
4. ใช้กฎการเปลี่ยนสถานะ ไม่ใช่การจัดอันดับตัวเลขแบบง่าย
สถานะการจัดส่งไม่ได้เรียงเป็นเส้นตรงเสมอไป ข้อยกเว้นอาจตามด้วยการขนส่งตามปกติ และความพยายามนำจ่ายไม่ใช่การจัดส่ง การส่งคืนอาจเริ่มขึ้นหลังเหตุการณ์จัดส่งก่อนหน้านั้น
- อนุญาตให้ข้อยกเว้นสิ้นสุดลงเมื่อหลักฐานภายหลังสนับสนุนว่าการขนส่งกลับมาดำเนินต่อ
- ป้องกันไม่ให้การสแกนในอดีตตามปกติแทนที่สถานะจัดส่งแล้วโดยไม่แจ้งให้ทราบ
- อนุญาตการแก้ไขที่มีเอกสารรองรับผ่านเส้นทางการแก้ไขที่มีการควบคุม
- ติดตามการส่งคืนแยกจากการดำเนินการจัดส่งขาออกให้เสร็จสมบูรณ์เมื่อ OMS รองรับ
- ส่งหลักฐานที่คลุมเครือหรือขัดแย้งกันไปยังคิวปฏิบัติการ
กำหนดเวอร์ชันให้กฎเหล่านี้ เมื่อการจับคู่มีการเปลี่ยนแปลง ให้ตัดสินใจว่าจะใช้กับเหตุการณ์ใหม่เท่านั้น หรือระเบียนในอดีตต้องคำนวณใหม่ภายใต้การควบคุม
คำนวณสถานะคำสั่งซื้อจากภาระผูกพันในการจัดส่งที่จำเป็น
สถานะพัสดุและสถานะคำสั่งซื้อควรเป็นฟิลด์แยกกัน พัสดุที่ระบุว่าจัดส่งแล้วเป็นหลักฐานสำหรับพัสดุนั้น ส่วนการดำเนินการคำสั่งซื้อให้เสร็จสมบูรณ์ขึ้นอยู่กับจำนวนที่จำเป็นที่เหลืออยู่และนโยบายธุรกิจของคุณ
ค่าเริ่มต้นที่มีประโยชน์คือกำหนดให้คำสั่งซื้อจัดส่งครบถ้วนก็ต่อเมื่อจำนวนที่ต้องจัดส่งทั้งหมดมีหลักฐานการจัดส่งระดับพัสดุที่ถูกต้อง และไม่มีการจัดสรรที่จำเป็นใดเหลืออยู่โดยยังไม่สามารถระบุได้ ตัดจำนวนที่ยกเลิกออกตามกฎการยกเลิกของ OMS จัดการสินค้าดิจิทัล คำสั่งซื้อรับสินค้าที่จุดรับ และภาระผูกพันอื่นที่ไม่ใช่การจัดส่งผ่านเงื่อนไขการเสร็จสมบูรณ์ของตนเอง
การจัดส่งทดแทนต้องมีความสัมพันธ์ที่ชัดเจน หากพัสดุสูญหายและมีการส่งทดแทน ให้ตัดสินใจว่าพัสดุทดแทนเข้ามาแทนที่ภาระผูกพันในการจัดส่งเดิมหรือไม่ มิฉะนั้น พัสดุเดิมอาจขัดขวางการดำเนินการให้เสร็จสมบูรณ์อย่างไม่มีกำหนด หรือพัสดุทั้งสองอาจถูกนับรวมในการจัดส่ง บันทึกการตัดสินใจดังกล่าว แทนที่จะอนุมานจากสถานะการติดตามเพียงอย่างเดียว
แยกการจัดส่งเสร็จสมบูรณ์ออกจากการปิดบัญชีทางการเงิน สิทธิ์ในการคืนเงิน และการแก้ไขข้อพิพาท เหตุการณ์ที่ผู้ขนส่งระบุว่าจัดส่งแล้วไม่ควรอนุมัติการคืนเงินหรือยุติข้อเรียกร้องของลูกค้าโดยอัตโนมัติ
กู้คืนจากความล้มเหลวโดยไม่สูญเสียเส้นทางตรวจสอบ
ลองใหม่สำหรับความล้มเหลวชั่วคราวโดยใช้การหน่วงเวลาที่มีขอบเขตและคำแนะนำการลองใหม่ตามเอกสาร แยกความล้มเหลวในการเชื่อมต่อชั่วคราวออกจากตัวระบุที่ไม่ถูกต้อง ข้อมูลประจำตัวหมดอายุ ข้อผิดพลาดด้านสิทธิ์ และความเข้ากันไม่ได้ของสคีมา ปัญหาประเภทหลังต้องได้รับการแก้ไข ไม่ใช่การลองใหม่ไม่รู้จบ
ดูแลคิวงานที่ล้มเหลวซึ่งประกอบด้วยผู้เช่าที่ได้รับผลกระทบ พัสดุ การอ้างอิงเหตุการณ์ การดำเนินการที่พยายามทำ การจัดประเภทข้อผิดพลาด และการดำเนินการถัดไป บันทึกบริบทให้เพียงพอสำหรับการตรวจสอบโดยไม่คัดลอกข้อมูลลูกค้าหรือข้อมูลประจำตัวที่ไม่จำเป็นลงในบันทึก
ดำเนินการกระทบยอดเพิ่มเติมจากเส้นทางการอัปเดตตามปกติ ตรวจสอบการจัดส่งที่ใช้งานอยู่ซึ่งมีข้อมูลการติดตามล้าสมัย เหตุการณ์ที่ยอมรับแล้วแต่การเขียน OMS ล้มเหลว ข้อมูลสังเกตที่จับคู่ไม่ได้ และความแตกต่างระหว่างสถานะที่การผสานรวมคำนวณกับ OMS กำหนดความถี่ในการตรวจสอบตามข้อผูกพันด้านการจัดส่ง ขีดจำกัด API และความเสี่ยงด้านปฏิบัติการ แทนการใช้ตารางเวลาสากลตามอำเภอใจ
กำหนดเจ้าของความรับผิดชอบ: ฝ่ายวิศวกรรมจัดการการรับข้อมูลและความล้มเหลวในการเขียน ฝ่ายปฏิบัติการจัดส่งแก้ไขความสัมพันธ์พัสดุที่ขาดหาย ฝ่ายบริการลูกค้าตรวจสอบข้อยกเว้นที่ต้องสื่อสารกับลูกค้า คิวที่ไม่มีผู้รับผิดชอบเป็นเพียงสถานที่จัดเก็บข้อมูล
ทดสอบการจับคู่และกฎทางธุรกิจก่อนเปิดใช้งาน
ใช้ชุดข้อมูลทดสอบที่ควบคุมได้และเปิดใช้งานจริงในวงจำกัด ทดสอบกรณีต่อไปนี้กับทั้งประวัติเหตุการณ์และระเบียน OMS ที่ได้:
- คำสั่งซื้อแบบพัสดุเดียวดำเนินไปตามปกติจนจัดส่งสำเร็จ
- คำสั่งซื้อแบบแยกส่งมีพัสดุหนึ่งรายการจัดส่งแล้วและอีกหนึ่งรายการยังอยู่ระหว่างการขนส่ง
- ได้รับเหตุการณ์เดียวกันซ้ำหลายครั้งโดยไม่มีผลข้างเคียงซ้ำ
- การสแกนระหว่างการขนส่งที่เก่ากว่ามาถึงหลังจากจัดส่งแล้ว
- ผู้ขนส่งหรือสถานะที่ไม่รู้จักเข้าสู่คิวตรวจสอบ
- มีการเปลี่ยนป้ายจัดส่งโดยไม่สร้างภาระผูกพันในการจัดส่งเพิ่มเติม
- การจัดส่งทดแทนเข้ามาแทนที่พัสดุเดิมภายใต้กฎที่ได้รับอนุมัติ
- OMS ไม่พร้อมใช้งานหลังจากยอมรับเหตุการณ์แล้ว
- กระบวนการเริ่มต้นใหม่ระหว่างการเขียน OMS และการตอบรับ
- หมายเลขคำสั่งซื้อที่แสดงเดียวกันมีอยู่ในสองร้านค้าโดยไม่มีการจับคู่ข้ามผู้เช่า
เปิดใช้งานเมื่อทุกเหตุการณ์ที่ยอมรับแล้วมีผลลัพธ์การประมวลผลที่ตรวจสอบย้อนกลับได้ การจับคู่ที่คลุมเครือไม่สามารถอัปเดตคำสั่งซื้อโดยอัตโนมัติ และผู้ปฏิบัติงานสามารถเรียกใช้งานที่ล้มเหลวซ้ำได้อย่างปลอดภัย เกณฑ์การยอมรับเหล่านี้มีประโยชน์กว่าการแสดงให้เห็นเพียงว่าคำขอ API สำเร็จ
คำถามที่พบบ่อย
ฉันสามารถเชื่อมต่อหมายเลขติดตามกับคำสั่งซื้อโดยตรงได้หรือไม่
สำหรับกระบวนการที่มีพัสดุเดียวอย่างเคร่งครัด ความสัมพันธ์โดยตรงอาจเพียงพอในช่วงแรก อย่างไรก็ตาม ให้ใช้ตัวตนการจัดส่งภายในระหว่างคำสั่งซื้อกับการกำหนดหมายเลขติดตาม วิธีนี้ช่วยให้ย้ายไปจัดการการจัดส่งแบบแยกส่ง การเปลี่ยนป้าย และการจัดส่งทดแทนได้โดยไม่ต้องเปลี่ยนความหมายของระเบียนคำสั่งซื้อ
การผสานรวมควรใช้ webhook หรือการสำรวจข้อมูล
ใช้กลไกการส่งข้อมูลที่ผู้ให้บริการรองรับและเข้ากันได้กับโครงสร้างพื้นฐานของคุณ Webhook สามารถลดการดึงข้อมูลซ้ำ ขณะที่การสำรวจข้อมูลรองรับกระบวนการที่อาศัยการดึงข้อมูลและการกระทบยอดเมื่อมีให้ใช้งาน ทั้งสองแนวทางไม่ได้ลดความจำเป็นในการจัดเก็บข้อมูลที่ทนทาน การจัดการรายการซ้ำ และการกู้คืน
ควรทำอย่างไรเมื่อเหตุการณ์การติดตามไม่มีคำสั่งซื้อที่ตรงกัน
จัดเก็บเหตุการณ์นั้นไว้ในคิวเหตุการณ์ที่จับคู่ไม่ได้ และตรวจสอบระเบียนการลงทะเบียน บริบทผู้เช่า ตัวตนของผู้ขนส่ง และเวลาการสร้างการจัดส่ง อย่าสร้างคำสั่งซื้อหรือแนบเหตุการณ์กับลูกค้าที่ดูเหมือนจะตรงกันโดยอัตโนมัติ ให้เรียกใช้งานซ้ำหลังจากแก้ไขการจับคู่แล้ว
การแจ้งเตือนการจัดส่งควรมาจาก OMS หรือระบบติดตาม
เลือกเจ้าของหนึ่งรายสำหรับการแจ้งเตือนและทริกเกอร์แต่ละประเภท หากมีสองระบบที่สามารถส่งข้อความเดียวกันได้ ให้ปิดเส้นทางใดเส้นทางหนึ่งหรือใช้บัญชีแยกประเภทการแจ้งเตือนแบบทนทานร่วมกัน นอกจากนี้ให้ตัดสินใจว่าข้อความอ้างถึงพัสดุหนึ่งรายการหรือคำสั่งซื้อทั้งหมด โดยเฉพาะในการจัดส่งแบบแยกส่ง
สถานะข้อยกเว้นหมายความว่าคำสั่งซื้อล้มเหลวหรือไม่
ไม่ ข้อยกเว้นคือข้อมูลสังเกตที่ต้องตีความ ไม่จำเป็นต้องเป็นผลลัพธ์ถาวร เก็บรักษาเหตุผล ติดตามเหตุการณ์ภายหลัง และใช้นโยบายการยกระดับของคุณเพื่อตัดสินใจว่าเมื่อใดฝ่ายปฏิบัติการควรเข้ามาดำเนินการ
แหล่งข้อมูล
- 17TRACK Tracking API — แหล่งอ้างอิงผลิตภัณฑ์อย่างเป็นทางการสำหรับจุดเริ่มต้นการผสานรวม API
- เอกสาร 17TRACK API — แหล่งอ้างอิงการใช้งานสำหรับสัญญาเฉพาะของผู้ให้บริการ ให้ตรวจสอบอินเทอร์เฟซและข้อกำหนดบัญชีที่ใช้ได้ก่อนนำไปใช้งาน
- RFC 9110 ส่วน 9.2.2: เมธอดแบบ Idempotent — ความหมายของ HTTP ที่สนับสนุนความแตกต่างระหว่าง idempotency ระดับเมธอดกับการป้องกันรายการซ้ำระดับแอปพลิเคชัน


