เชื่อมต่อ OMS ภายนอก
ส่งออเดอร์ไประบบจัดการออเดอร์ที่ร้านใช้อยู่ — OMS ใดก็ได้ผ่าน webhook ที่เซ็นลายเซ็น หรือ Zort — และรับสถานะออเดอร์กับสต็อกกลับมา
ในหน้านี้
ถ้าร้านใช้ระบบจัดการออเดอร์ (OMS) หรือระบบคลังสินค้าอยู่แล้ว ให้ระบบนั้นเป็นที่จัดการการแพ็กและส่งต่อไป Khuivo ส่งออเดอร์จากแชตไปให้ และรับสถานะ เลขพัสดุ และสต็อกกลับมา
สองวิธีเชื่อมต่อ #
| Webhook (OMS ใดก็ได้) | Zort | |
|---|---|---|
| ส่งออเดอร์ไป OMS | ทุกเหตุการณ์ของออเดอร์ เซ็นลายเซ็น ไปที่ URL ของร้าน | สร้างออเดอร์ที่ยืนยันแล้วใน Zort หนึ่งครั้ง |
| รับสถานะกลับ | OMS ส่ง POST มาที่ Inbound URL | — |
| รับสต็อกกลับ | OMS ส่ง POST มาที่ Inbound URL | ดึงตาม SKU ทุกชั่วโมง หรือกด ซิงก์สต็อกตอนนี้ |
ทั้งสองแบบอยู่ในแท็บ OMS ของ ตั้งค่าร้านค้า เชื่อมต่อได้เฉพาะเจ้าของและแอดมิน
เชื่อมต่อด้วย webhook #
- 1
เปิด ออเดอร์ แล้วไปที่ ตั้งค่าร้านค้า แท็บ OMS
- 2
กด เชื่อมต่อ ที่การ์ด Webhook
- 3
ใส่ URL ปลายทาง (ที่อยู่
https://ของ OMS ที่รับ POST) - 4
ที่ เหตุการณ์ที่ส่ง ใส่เหตุการณ์ที่ต้องการ คั่นด้วยจุลภาค (เช่น
order.created,order.paid,order.cancelled) หรือเว้นว่างเพื่อส่งทุกเหตุการณ์ของออเดอร์ - 5
เว้น Signing secret ว่างเพื่อให้ระบบสร้างให้ หรือวางของร้านเอง แล้วบันทึก
- 6
กด ทดสอบการเชื่อมต่อ Khuivo จะส่งเหตุการณ์
pingไปที่ URL - 7
กด แสดง signing secret แล้วคัดลอกไปใส่ใน OMS ระบบแสดงในกล่องให้คัดลอก และบันทึกทุกครั้งที่มีการดู
ข้อมูลที่ Khuivo ส่ง #
แต่ละเหตุการณ์ของออเดอร์ (order.created, order.paid, order.shipped, order.delivered, order.cancelled, order.updated…) ส่งเป็น POST พร้อม JSON จำนวนเงินเป็นจำนวนเต็มหน่วยสตางค์ (1 บาท = 100 สตางค์)
{
"id": "evt_01J…",
"type": "order.paid",
"occurred_at": "2026-10-03T08:15:00Z",
"order": {
"id": "0192…",
"order_no": "KV-000123",
"external_id": null,
"status": "paid",
"payment_status": "paid",
"payment_method": "promptpay",
"currency": "THB",
"subtotal": 59000,
"discount": 0,
"shipping_fee": 4000,
"cod_fee": 0,
"total": 63000,
"amount_paid": 63000,
"shipping": { "name": "สมชาย", "phone": "0812345678", "address_line": "99/1 ถ.สุขุมวิท", "district": "คลองเตย", "province": "กรุงเทพมหานคร", "postal_code": "10110" },
"items": [{ "sku": "TS-01-RED-M", "name": "เสื้อยืด", "variant_name": "แดง / M", "qty": 2, "unit_price": 29500, "discount": 0, "total": 59000 }],
"created_at": "2026-10-03T08:00:00Z",
"paid_at": "2026-10-03T08:15:00Z"
}
}มี header X-Khuivo-Event (ชนิดเหตุการณ์) และ X-Khuivo-Signature มาด้วย ออเดอร์ฉบับร่างไม่ถูกส่ง
ตรวจลายเซ็น #
X-Khuivo-Signature มีรูปแบบ t=1696320900,v1=5f2b… ตรวจได้ดังนี้
- 1
แยก
t(เวลา Unix หน่วยวินาที) และv1จาก header - 2
คำนวณ HMAC-SHA256 ด้วย signing secret บนข้อความ
<t>.<body ดิบ>แล้วเขียนเป็นเลขฐานสิบหก - 3
เทียบกับ
v1แบบ constant time และปฏิเสธคำขอที่tห่างจากเวลาปัจจุบันเกิน 5 นาที
ส่งสถานะและสต็อกกลับ #
การ์ด Webhook แสดง Inbound URL ให้ OMS ส่ง POST มาที่นี่ เซ็นแบบเดียวกัน (header X-Khuivo-Signature ด้วย secret เดียวกันบน <t>.<body>)
{
"orders": [
{ "order_no": "KV-000123", "external_id": "OMS-5531", "status": "shipped", "carrier": "flash", "tracking_no": "TH0123456789" }
],
"stock": [
{ "sku": "TS-01-RED-M", "on_hand": 42 }
]
}- ระบุออเดอร์ด้วย
order_noหรือorder_idของ Khuivo ส่วนstatusเป็นpacking,shipped,deliveredหรือcancelled stockตั้งจำนวนคงคลังของตัวเลือกสินค้าใน Khuivo ที่มี SKU นั้น- คำตอบบอกจำนวนออเดอร์และแถวสต็อกที่อัปเดต พร้อมข้อผิดพลาดถ้ามี
เชื่อมต่อ Zort #
- 1
ในแท็บ OMS กด เชื่อมต่อ ที่การ์ด Zort
- 2
ใส่ Store name, API key และ API secret จากหน้าตั้งค่า API ของ Zort แล้วบันทึก
- 3
กด ทดสอบการเชื่อมต่อ
หลังจากนั้น ออเดอร์ที่ยืนยันแล้ว (รอชำระ ชำระแล้ว หรือกำลังแพ็ก) จะถูกสร้างใน Zort หนึ่งครั้ง พร้อมรายการสินค้าตาม SKU
ซิงก์สต็อก #
Khuivo ดึงสต็อกจาก Zort ทุกชั่วโมง และตั้งจำนวนคงคลังของทุกตัวเลือกสินค้าที่มี SKU ตรงกัน ถ้าต้องการดึงทันทีกด ซิงก์สต็อกตอนนี้ จะเห็นจำนวน SKU ที่อัปเดต การ์ดแสดง ซิงก์ล่าสุด และ ข้อผิดพลาดล่าสุด ถ้ามีปัญหา
ปัญหาที่พบบ่อย #
- ทดสอบ webhook ไม่สำเร็จ — URL ต้องเข้าถึงได้ทาง
https://และตอบสถานะ 2xx ถ้าตอบ 4xx แปลว่า OMS ปฏิเสธ ให้ดู log ของ OMS - OMS ปฏิเสธลายเซ็น — เซ็นบน body ดิบตามที่ได้รับ ด้วย secret จาก แสดง signing secret และตรวจนาฬิกาของเซิร์ฟเวอร์
- สต็อกไม่เปลี่ยน — SKU ใน OMS กับใน Khuivo ต้องตรงกันทุกตัวอักษร
- ข้อผิดพลาดล่าสุดแสดงรหัส — ทดสอบการเชื่อมต่ออีกครั้ง ถ้าคีย์เปลี่ยนให้แก้การ์ดแล้ววางคีย์ใหม่
หน้านี้มีประโยชน์ไหม?