Work Cycle (กะการทำงาน)
API สำหรับจัดการกะการทำงาน (Shift) ของพนักงาน
ภาพรวม
Work Cycle API ช่วยให้คุณสามารถดึงข้อมูลกะการทำงาน จัดการตารางกะรายวัน และกำหนดกะพื้นฐานให้พนักงาน
กะการทำงานกำหนดเวลาเข้า-ออกงาน เวลาพัก และจำนวนชั่วโมงทำงานของพนักงาน
Available Endpoints
| Endpoint | Method | Description |
|---|---|---|
| Get Work Cycle Types | GET | ดึงรายการกะทั้งหมดในองค์กร |
| Get Employee Setting | GET | ดึงการตั้งค่ากะพื้นฐานของพนักงาน |
| Get Monthly Schedule | GET | ดึงตารางกะรายเดือนของพนักงาน |
| Update Employee Setting | POST | แก้ไขการตั้งค่ากะพื้นฐานของพนักงาน |
ประเภทกะการทำงาน
| Type | รหัส | Description |
|---|---|---|
| กะปกติ | 00 | กะมาตรฐาน เช่น 08:00-17:00 |
| กะคู่ (Dual Shift) | 04 | กะที่มี 2 ช่วงเวลาทำงานในวันเดียว |
รูปแบบกะ (Work Cycle Format)
| Format | Description | ตัวอย่าง |
|---|---|---|
weekly | กำหนดกะรายสัปดาห์ | จันทร์-ศุกร์ กะ A, เสาร์-อาทิตย์ หยุด |
daily | กำหนดกะรายวัน | ตารางกะหมุนเวียน |
fixed | กะคงที่ | ทุกวันกะ A |
โครงสร้างข้อมูลกะ
{
"code": "A",
"name": "A : 08:00-17:00",
"work_cycle_id": "1",
"work_cycle_type": "00",
"work_start_time": "08:00",
"work_end_time": "17:00",
"break_start_time": "12:00",
"break_end_time": "13:00",
"work_hour": "08:00:00",
"break_hour": "01:00:00"
}Quick Start
1. ดูรายการกะทั้งหมด
curl -X GET "https://openapi.humansoft.co.th/api/v1/open-apis/work-cycle/get-types" \
-H "Ocp-Apim-Subscription-Key: YOUR_API_KEY"2. ดูตารางกะรายเดือนของพนักงาน
curl -X GET "https://openapi.humansoft.co.th/api/v1/open-apis/work-cycle/get-employee-work-cycle-month?employee_code=EMP001&month_no=2026-01" \
-H "Ocp-Apim-Subscription-Key: YOUR_API_KEY"3. แก้ไขกะพื้นฐานของพนักงาน
curl -X POST "https://openapi.humansoft.co.th/api/v1/open-apis/work-cycle/update-employee-base-work-cycle-setting" \
-H "Ocp-Apim-Subscription-Key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"employee_code": "EMP001",
"work_cycle_format": "weekly",
"day_lists": [
{"day": "monday", "id": "V0MwMDE=", "code": "A", "name": "A : 08:00-17:00"},
{"day": "tuesday", "id": "V0MwMDE=", "code": "A", "name": "A : 08:00-17:00"}
]
}'Common Use Cases
- ดูรายการกะ - แสดง Dropdown เลือกกะในระบบ
- ดูตารางกะรายเดือน - แสดงปฏิทินกะของพนักงาน
- แก้ไขกะพื้นฐาน - กำหนดกะประจำวันให้พนักงาน
- ตรวจสอบสิทธิ์เปลี่ยนกะ - ตรวจสอบ Cut-off date
Cut-off Date
การเปลี่ยนกะมี Cut-off Date ที่กำหนดได้ในระบบ หลังจากวันที่กำหนดจะไม่สามารถแก้ไขกะได้
is_change_work_cycle = 'Y'- สามารถเปลี่ยนกะได้is_change_work_cycle = 'N'- ไม่สามารถเปลี่ยนกะได้ (เกิน Cut-off หรือรอบเงินเดือนปิด)
Related APIs
- Holiday - วันทำงาน/วันหยุด
- Overtime - ทำงานล่วงเวลา
- Time Leave - การลา
Last updated on