วิธีใช้ Business Hours API

API OAuth เวลาทำการ Business Hours วันเปิดทำการพิเศษ เวลาทำงานที่รับได้ กะ Android iOS

เกี่ยวกับคู่มือนี้
รวบรวมวิธีใช้ Business Hours API ของ ReceiptRoller (/api/v1/stores/{storeId}/business-hours) คุณสามารถดึงและอัปเดตเวลาทำการรายวัน วันเปิดทำการพิเศษ (หยุดกะทันหัน・เปลี่ยนเวลาทำการ) และเวลาทำงานที่รับได้ซึ่งเป็นเพดานของการสร้างกะ จากแอปมือถือหรือระบบภายนอกได้

วิธีใช้ Business Hours API

ขอบเขตที่จำเป็น

ขอบเขต	สิทธิ์ที่ได้รับ
`store.business-hours.read`	อ่านเวลาทำการ・วันเปิดทำการพิเศษ・เวลาทำงานที่รับได้・การตัดสินสถานะเปิดทำการ
`store.business-hours.write`	อัปเดตเวลาทำการ・วันเปิดทำการพิเศษ・เวลาทำงานที่รับได้

เมื่อติ๊กที่ "API สโคป" ในหน้าจอแก้ไขแอป กรุณาใส่ไว้ในพารามิเตอร์ scope ของ URL อนุมัติด้วย

การยืนยันตัวตน

ใช้ข้อกำหนดโทเคนเดียวกับ v1 API อื่น ๆ

โทเคนที่ผูกกับบัญชีธุรกิจ — เรียกได้เลย
โทเคนขอบเขต user (สำหรับแอปมือถือเนทีฟ) — กรุณาแนบ ?organizationId= ในเควรี

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

เมธอด	พาธ	เนื้อหา
GET	`/api/v1/stores/{storeId}/business-hours`	ดึงเวลาทำการรายวัน
PUT	`/api/v1/stores/{storeId}/business-hours`	อัปเดตเวลาทำการทั้งหมดในครั้งเดียว
PUT	`/api/v1/stores/{storeId}/business-hours/{dayOfWeek}/{shiftIndex}`	อัปเดตวัน・ช่วงเวลาที่ระบุ
DELETE	`/api/v1/stores/{storeId}/business-hours/{dayOfWeek}/{shiftIndex}`	ลบวัน・ช่วงเวลาที่ระบุ
GET	`/api/v1/stores/{storeId}/business-hours/special-days`	รายการวันเปิดทำการพิเศษ (หยุดกะทันหัน・เปลี่ยนเวลาทำการ)
PUT	`/api/v1/stores/{storeId}/business-hours/special-days/{date}`	ลงทะเบียน・อัปเดตวันเปิดทำการพิเศษ
DELETE	`/api/v1/stores/{storeId}/business-hours/special-days/{date}`	ลบวันเปิดทำการพิเศษ
GET	`/api/v1/stores/{storeId}/business-hours/work-hours-limit`	ดึงเวลาทำงานที่รับได้ (เวลางานที่เป็นเพดานของการสร้างกะ)
PUT	`/api/v1/stores/{storeId}/business-hours/work-hours-limit`	อัปเดตเวลาทำงานที่รับได้
GET	`/api/v1/stores/{storeId}/business-hours/open-status`	ตัดสินว่าขณะนี้กำลังเปิดทำการอยู่หรือไม่

ความแตกต่างระหว่างเวลาทำการกับเวลาทำงานที่รับได้

เวลาทำการ — เวลาเปิด・ปิดร้านที่เผยแพร่ให้ลูกค้า สามารถลงทะเบียนหลายช่วงเวลาต่อวันได้ (เช่น รอบกลางวัน・รอบกลางคืน)
เวลาทำงานที่รับได้ — เวลางานที่เป็นเพดานของการสร้างกะได้ ตั้งค่าช่วงที่รวมถึงการเตรียมการก่อนเปิดร้านและการเก็บกวาดหลังปิดร้านด้วย

ฟังก์ชันจัดการกะและ API สร้างกะ สามารถลงทะเบียนกะได้เฉพาะภายในช่วงของเวลาทำงานที่รับได้เท่านั้น

การตั้งค่าเวลาทำงานที่รับได้

PUT /api/v1/stores/{storeId}/business-hours/work-hours-limit
Authorization: Bearer {token}
Content-Type: application/json

{
  "standardWorkStartTime": "08:00",
  "standardWorkEndTime": "23:00"
}

ระบุเวลาในรูปแบบ HH:mm และเวลาเริ่มต้องอยู่ก่อนเวลาสิ้นสุด หากตั้งทั้งสองค่าเป็นสตริงว่าง จะกลายเป็นไม่มีข้อจำกัด (ลงทะเบียนกะ 24 ชั่วโมงได้)

การลงทะเบียนวันเปิดทำการพิเศษ

PUT /api/v1/stores/{storeId}/business-hours/special-days/2026-08-13
Authorization: Bearer {token}
Content-Type: application/json

{
  "isClosed": true,
  "note": "夏季休業"
}

นอกจากการหยุดกะทันหันแล้ว ยังลงทะเบียนเพื่อเปลี่ยนเวลาทำการเฉพาะวันที่ระบุได้ด้วย การตัดสินของ open-status จะประเมินโดยให้ความสำคัญกับวันเปิดทำการพิเศษก่อน

คู่มือที่เกี่ยวข้อง

วันที่เผยแพร่: 2569-06-10 วันที่อัปเดต: 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)

บทความที่เกี่ยวข้อง