Work Cycle Change (เปลี่ยนกะ)
API สำหรับจัดการคำขอเปลี่ยนกะการทำงานของพนักงาน
ภาพรวม
Work Cycle Change API ช่วยให้พนักงานสามารถยื่นคำขอเปลี่ยนกะหรือสลับกะกับวันอื่น โดยผ่านระบบอนุมัติอัตโนมัติ
การเปลี่ยนกะต้องผ่านการอนุมัติจากผู้บังคับบัญชาตามที่บริษัทกำหนด
Available Endpoints
| Endpoint | Method | Description |
|---|---|---|
| Get Work Cycle Types | GET | ดึงรายการกะทั้งหมด |
| Get Change List | GET | ดึงรายการคำขอเปลี่ยนกะ |
| Submit Change Request | POST | ยื่นคำขอเปลี่ยนกะ |
| Update Change Request | POST | แก้ไขคำขอเปลี่ยนกะ |
| Delete Change Request | POST | ลบคำขอเปลี่ยนกะ |
โหมดการเปลี่ยนกะ
| Mode | รหัส | Description |
|---|---|---|
| เปลี่ยนกะ | change | เปลี่ยนกะของวันที่ระบุเป็นกะอื่น |
| สลับกะ | switch | สลับกะระหว่าง 2 วัน |
Change Mode (เปลี่ยนกะ)
เปลี่ยนกะของวันที่ระบุเป็นกะอื่น เช่น:
- วันที่ 15 ม.ค. ปกติเข้ากะ A (08:00-17:00) → เปลี่ยนเป็นกะ B (13:00-22:00)
Switch Mode (สลับกะ)
สลับกะระหว่าง 2 วัน เช่น:
- วันที่ 15 ม.ค. กะ A สลับกับ วันที่ 16 ม.ค. กะ B
สถานะการอนุมัติ
| Status | รหัส | Description |
|---|---|---|
| รออนุมัติ | 01 | คำขออยู่ระหว่างรอการอนุมัติ |
| อนุมัติแล้ว | 02 | คำขอได้รับการอนุมัติ |
| ไม่อนุมัติ | 03 | คำขอไม่ได้รับการอนุมัติ |
| ยกเลิก | 04 | คำขอถูกยกเลิก |
| ส่งกลับแก้ไข | 05 | คำขอถูกส่งกลับให้แก้ไข |
| รออนุมัติระดับ 2-4 | 06-08 | คำขอรอผู้อนุมัติระดับสูงขึ้น |
Quick Start
1. ดูรายการกะทั้งหมด
curl -X GET "https://openapi.humansoft.co.th/api/v1/open-apis/work-cycle-change/get-types" \
-H "Ocp-Apim-Subscription-Key: YOUR_API_KEY"2. ยื่นคำขอเปลี่ยนกะ
curl -X POST "https://openapi.humansoft.co.th/api/v1/open-apis/work-cycle-change/submit" \
-H "Ocp-Apim-Subscription-Key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"employee_code": "EMP001",
"work_cycle_change_dt": "2026-01-20",
"work_cycle_mode_lv": "change",
"work_cycle_id": "V0MwMDI=",
"work_cycle_change_desc": "ต้องไปธุระช่วงเช้า"
}'3. ดูรายการคำขอเปลี่ยนกะ
curl -X GET "https://openapi.humansoft.co.th/api/v1/open-apis/work-cycle-change/get-list?start_date=2026-01-01&end_date=2026-01-31&employee_code=EMP001" \
-H "Ocp-Apim-Subscription-Key: YOUR_API_KEY"Common Use Cases
- พนักงานขอเปลี่ยนกะ - ยื่นคำขอเปลี่ยนกะในวันที่ต้องการ
- สลับกะกับเพื่อนร่วมงาน - สลับกะระหว่าง 2 วัน
- HR ตรวจสอบคำขอ - ดูรายการคำขอเปลี่ยนกะทั้งหมด
- แก้ไข/ยกเลิกคำขอ - แก้ไขหรือลบคำขอที่ยังไม่อนุมัติ
Business Rules
ข้อจำกัดการเปลี่ยนกะ:
- ไม่สามารถเปลี่ยนกะในวันที่มี OT ได้
- ไม่สามารถเปลี่ยนกะในงวดเงินเดือนที่ปิดแล้ว
- ไม่สามารถแก้ไข/ลบคำขอที่อนุมัติแล้ว
- มี Cut-off date และ Quota limit ตามที่บริษัทกำหนด
Related APIs
- Work Cycle - กะการทำงาน
- Overtime - ทำงานล่วงเวลา
- Time Leave - การลา
Last updated on