วิธีใช้ API ยอดขาย (Sales API)

API OAuth ยอดขาย KPI Analytics Android iOS averageTicket terminalId

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

คู่มือนี้สรุปวิธีดึงยอดขายของทั้งบัญชีธุรกิจ／ร้านค้าเฉพาะ／เครื่อง POS เฉพาะ โดยใช้API ยอดขาย (Sales API)ของ ReceiptRoller เป็นคู่มือที่เป็นจุดเริ่มต้นเมื่อต้องการสร้าง「แดชบอร์ดยอดขาย」จากแอปมือถือหรือการเชื่อมต่อฝั่งเซิร์ฟเวอร์

ข้อกำหนดเบื้องต้น

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

เอนด์พอยต์วัตถุประสงค์ฟิลเตอร์หลัก
GET /api/v1/sales/kpisKPI ของเดือนปัจจุบัน（ยอดขาย・จำนวนธุรกรรม・ยอดเฉลี่ยต่อบิล）และเทียบกับเดือนก่อนorganizationId, storeId?, terminalId?
GET /api/v1/sales/trendเทรนด์รายเดือน（ค่าเริ่มต้น 12 เดือน สูงสุด 60 เดือน）organizationId, storeId?, months, terminalId?
GET /api/v1/sales/productsยอดขายรายสินค้า＋การวิเคราะห์ ABC＋อัตรากำไรขั้นต้นorganizationId, storeId, since, until, category, search, sortBy, terminalId?
GET /api/v1/sales/visitorsการวิเคราะห์การเข้าร้าน（ช่วงเวลา・วันในสัปดาห์・อัตราคอนเวอร์ชัน・ลูกค้าใหม่／ลูกค้าเก่า）organizationId, storeId, since, until, terminalId?
GET /api/v1/sales/multi-trendซ้อนทับเทรนด์รายเดือนของหลายร้าน（สูงสุด 10 ร้าน）organizationId, storeIds（คั่นด้วยจุลภาค）, months
GET /api/v1/sales/adviceคำแนะนำ AI（การ์ดของแผง Intelligence）organizationId, storeId?, severity?, category?
GET /api/v1/sales/forecastพยากรณ์ยอด ณ สิ้นเดือนorganizationId, storeId?
GET /api/v1/sales/churnคะแนนความเสี่ยงลูกค้าเลิกใช้（RFM-lite）organizationId, storeId, lookbackDays
GET /api/v1/sales/recommendationsแนะนำสินค้าให้ลูกค้ารายบุคคลorganizationId, storeId, customerId, topN, lookbackDays

ยอดขายของทั้งบัญชีธุรกิจ（KPI）

เมื่อต้องการดึง「ตัวเลขของเดือนนี้」ของบัญชีธุรกิจที่เลือกอยู่ ให้เรียก kpis โดยไม่ต้องใส่ storeId

GET /api/v1/sales/kpis?organizationId={organizationId}
Authorization: Bearer {access_token}

โครงสร้างการตอบกลับ

ฟิลด์ตัวเลขทุกตัวจะคืนค่าเป็นชนิดซ้อนร่วมกันชื่อ KpiValue ฝั่งไคลเอนต์ไม่จำเป็นต้องคำนวณอัตราเทียบเดือนก่อนหรืออัตราการเพิ่มขึ้น／ลดลงใหม่

{
  "organizationId": "0aa2...e7b1",
  "currentMonth": "2026-06",
  "previousMonth": "2026-05",

  "totalStores":       { "current": 12,       "previous": 12,       "changePercent": 0.0  },
  "totalStaff":        { "current": 87,       "previous": 84,       "changePercent": 3.6  },
  "totalProducts":     { "current": 1450,     "previous": 1410,     "changePercent": 2.8  },
  "totalCustomers":    { "current": 8920,     "previous": 8650,     "changePercent": 3.1  },
  "totalRevenue":      { "current": 3850000,  "previous": 3520000,  "changePercent": 9.4  },
  "totalTransactions": { "current": 1240,     "previous": 1180,     "changePercent": 5.1  },
  "aver…
วันที่เผยแพร่: 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)
บทความที่เกี่ยวข้อง