วิธีใช้ Orders / OMS API

API OAuth การจัดการการขาย OMS คำสั่งซื้อ CRUD Android iOS

วัตถุประสงค์ของคู่มือนี้

รวบรวมวิธีสร้าง・ดึง・อัปเดต・เปลี่ยนสถานะ (ยืนยัน／กำลังดำเนินการ／ยกเลิก／รับสินค้าที่ POS ร้าน)・ลบคำสั่งซื้อภายใต้บัญชีธุรกิจ โดยใช้ Orders / OMS API ของ ReceiptRoller คู่มือนี้เป็นจุดเริ่มต้นเมื่อต้องการรวมช่องทางการขายของร้าน เช่น รับออร์เดอร์ทางเว็บ・คำสั่งซื้อทางโทรศัพท์・การเชื่อมต่อมาร์เก็ตเพลส

เงื่อนไขเบื้องต้น

รายการเอนด์พอยต์

เมธอดพาธวัตถุประสงค์สโคปที่จำเป็น
GET/api/v1/ordersรายการคำสั่งซื้อ (กรองด้วย status / channel / paymentStatus)store.orders.read
GET/api/v1/orders/{orderId}รายละเอียด 1 คำสั่งซื้อstore.orders.read
POST/api/v1/ordersสร้างคำสั่งซื้อใหม่store.orders.write
PUT/api/v1/orders/{orderId}อัปเดตคำสั่งซื้อ (ลูกค้า・ที่อยู่・รายการ・จำนวนเงิน ฯลฯ)store.orders.write
POST/api/v1/orders/{orderId}/confirmเปลี่ยนสถานะ: รอดำเนินการ → ยืนยันแล้วstore.orders.write
POST/api/v1/orders/{orderId}/processเปลี่ยนสถานะ: ยืนยันแล้ว → กำลังดำเนินการstore.orders.write
POST/api/v1/orders/{orderId}/cancelเปลี่ยนสถานะ: ยกเลิกstore.orders.write
POST/api/v1/orders/{orderId}/fulfill-via-posเปลี่ยนสถานะ: รับสินค้าที่ POS ร้านเสร็จ (→ Delivered)store.orders.write
DELETE/api/v1/orders/{orderId}ลบคำสั่งซื้อstore.orders.write

ประเภทสถานะคำสั่งซื้อ

สถานะภาษาไทยคำอธิบาย
Pendingรอดำเนินการรับคำสั่งซื้อแล้ว แต่ยังไม่ยืนยัน
Confirmedยืนยันแล้วฝั่งร้านค้ายืนยันคำสั่งซื้อแล้ว
Processingกำลังดำเนินการกำลังแพ็ก・เตรียมจัดส่ง
Shippedจัดส่งแล้วจัดส่งเสร็จ (อาจอัปเดตอัตโนมัติจากการเชื่อมต่อ WMS)
Deliveredส่งถึงแล้วจัดส่งถึงลูกค้าเสร็จ (การรับที่ POS ร้านก็เปลี่ยนมาที่นี่)
Cancelledยกเลิกยกเลิกคำสั่งซื้อ
Refundedคืนเงินแล้วดำเนินการคืนเงินเสร็จแล้ว

1. ดึงรายการคำสั่งซื้อ

GET /api/v1/orders?organizationId={organizationId}&status=Pending
Authorization: Bearer {access_token}

พารามิเตอร์เควรี (ตัวเลือก)

  • status — กรองด้วยสถานะคำสั่งซื้อ
  • channel — Web / POS / Phone / Manual / Marketplace
  • paymentStatus — Unpaid / Paid / Refunded / PartialRefund

เรสปอนส์คืออ็อบเจกต์คำสั่งซื้อในอาร์เรย์ orders ฟิลด์หลักของแต่ละอ็อบเจกต์กรุณาดูที่ "โครงสร้างของอ็อบเจกต์คำสั่งซื้อ" ด้านล่าง

2. ดึงรายละเอียด 1 คำสั่งซื้อ

GET /api/v1/orders/{orderId}?organizationId={organizationId}
Authorization: Bearer {access_token}

3. สร้างคำสั่งซื้อใหม่

…
วันที่เผยแพร่: 2569-06-01 วันที่อัปเดต: 2569-07-06
กลับไปที่รายการวิธีใช้งาน
このトピックについて
開発者API
機能の詳細を見る
หมวดหมู่
ทั้งหมด ทั่วไป 14 Webhook 6 การแก้ปัญหา 6 การลงทะเบียนแอปพลิเคชัน 5 คู่มือตามประเภทข้อมูล 5 พื้นฐาน API 5 การดำเนินงานและความปลอดภัย 4 เริ่มต้นใช้งาน 4 การยืนยันตัวตนและข้อมูลรับรอง 3 คู่มือแยกตามโดเมนข้อมูล 3
แท็ก
API (22) OAuth (15) Android (10) iOS (9) Webhook (8) api (7) oauth (5) getting-started (4) การลงทะเบียนแอป (4) การแก้ปัญหา (4)
บทความที่เกี่ยวข้อง