Khuivo
ออเดอร์

เชื่อมต่อ OMS ภายนอก

ส่งออเดอร์ไประบบจัดการออเดอร์ที่ร้านใช้อยู่ — OMS ใดก็ได้ผ่าน webhook ที่เซ็นลายเซ็น หรือ Zort — และรับสถานะออเดอร์กับสต็อกกลับมา

ในหน้านี้

ถ้าร้านใช้ระบบจัดการออเดอร์ (OMS) หรือระบบคลังสินค้าอยู่แล้ว ให้ระบบนั้นเป็นที่จัดการการแพ็กและส่งต่อไป Khuivo ส่งออเดอร์จากแชตไปให้ และรับสถานะ เลขพัสดุ และสต็อกกลับมา

สองวิธีเชื่อมต่อ #

Webhook (OMS ใดก็ได้)Zort
ส่งออเดอร์ไป OMSทุกเหตุการณ์ของออเดอร์ เซ็นลายเซ็น ไปที่ URL ของร้านสร้างออเดอร์ที่ยืนยันแล้วใน Zort หนึ่งครั้ง
รับสถานะกลับOMS ส่ง POST มาที่ Inbound URL—
รับสต็อกกลับOMS ส่ง POST มาที่ Inbound URLดึงตาม SKU ทุกชั่วโมง หรือกด ซิงก์สต็อกตอนนี้

ทั้งสองแบบอยู่ในแท็บ OMS ของ ตั้งค่าร้านค้า เชื่อมต่อได้เฉพาะเจ้าของและแอดมิน

เชื่อมต่อด้วย webhook #

  1. 1

    เปิด ออเดอร์ แล้วไปที่ ตั้งค่าร้านค้า แท็บ OMS

  2. 2

    กด เชื่อมต่อ ที่การ์ด Webhook

  3. 3

    ใส่ URL ปลายทาง (ที่อยู่ https:// ของ OMS ที่รับ POST)

  4. 4

    ที่ เหตุการณ์ที่ส่ง ใส่เหตุการณ์ที่ต้องการ คั่นด้วยจุลภาค (เช่น order.created,order.paid,order.cancelled) หรือเว้นว่างเพื่อส่งทุกเหตุการณ์ของออเดอร์

  5. 5

    เว้น Signing secret ว่างเพื่อให้ระบบสร้างให้ หรือวางของร้านเอง แล้วบันทึก

  6. 6

    กด ทดสอบการเชื่อมต่อ Khuivo จะส่งเหตุการณ์ ping ไปที่ URL

  7. 7

    กด แสดง signing secret แล้วคัดลอกไปใส่ใน OMS ระบบแสดงในกล่องให้คัดลอก และบันทึกทุกครั้งที่มีการดู

ข้อมูลที่ Khuivo ส่ง #

แต่ละเหตุการณ์ของออเดอร์ (order.created, order.paid, order.shipped, order.delivered, order.cancelled, order.updated…) ส่งเป็น POST พร้อม JSON จำนวนเงินเป็นจำนวนเต็มหน่วยสตางค์ (1 บาท = 100 สตางค์)

json
{
  "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. 1

    แยก t (เวลา Unix หน่วยวินาที) และ v1 จาก header

  2. 2

    คำนวณ HMAC-SHA256 ด้วย signing secret บนข้อความ <t>.<body ดิบ> แล้วเขียนเป็นเลขฐานสิบหก

  3. 3

    เทียบกับ v1 แบบ constant time และปฏิเสธคำขอที่ t ห่างจากเวลาปัจจุบันเกิน 5 นาที

ส่งสถานะและสต็อกกลับ #

การ์ด Webhook แสดง Inbound URL ให้ OMS ส่ง POST มาที่นี่ เซ็นแบบเดียวกัน (header X-Khuivo-Signature ด้วย secret เดียวกันบน <t>.<body>)

json
{
  "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. 1

    ในแท็บ OMS กด เชื่อมต่อ ที่การ์ด Zort

  2. 2

    ใส่ Store name, API key และ API secret จากหน้าตั้งค่า API ของ Zort แล้วบันทึก

  3. 3

    กด ทดสอบการเชื่อมต่อ

หลังจากนั้น ออเดอร์ที่ยืนยันแล้ว (รอชำระ ชำระแล้ว หรือกำลังแพ็ก) จะถูกสร้างใน Zort หนึ่งครั้ง พร้อมรายการสินค้าตาม SKU

ซิงก์สต็อก #

Khuivo ดึงสต็อกจาก Zort ทุกชั่วโมง และตั้งจำนวนคงคลังของทุกตัวเลือกสินค้าที่มี SKU ตรงกัน ถ้าต้องการดึงทันทีกด ซิงก์สต็อกตอนนี้ จะเห็นจำนวน SKU ที่อัปเดต การ์ดแสดง ซิงก์ล่าสุด และ ข้อผิดพลาดล่าสุด ถ้ามีปัญหา

ปัญหาที่พบบ่อย #

  • ทดสอบ webhook ไม่สำเร็จ — URL ต้องเข้าถึงได้ทาง https:// และตอบสถานะ 2xx ถ้าตอบ 4xx แปลว่า OMS ปฏิเสธ ให้ดู log ของ OMS
  • OMS ปฏิเสธลายเซ็น — เซ็นบน body ดิบตามที่ได้รับ ด้วย secret จาก แสดง signing secret และตรวจนาฬิกาของเซิร์ฟเวอร์
  • สต็อกไม่เปลี่ยน — SKU ใน OMS กับใน Khuivo ต้องตรงกันทุกตัวอักษร
  • ข้อผิดพลาดล่าสุดแสดงรหัส — ทดสอบการเชื่อมต่ออีกครั้ง ถ้าคีย์เปลี่ยนให้แก้การ์ดแล้ววางคีย์ใหม่

หน้านี้มีประโยชน์ไหม?