Set Work Cycle Plan
สร้างแผนกะใหม่หรือแก้ไขแผนกะที่มีอยู่ สำหรับกำหนดกะงานและวันหยุดของพนักงาน รองรับทั้งโหมดสร้างใหม่ (Create) และแก้ไข (Update)
Endpoint
POST /api/v1/open-apis/salary/update-data-filter?path_action=set_work_cycle_planRequest Body
Create Mode - สร้างแผนกะใหม่
| Parameter | Type | Required | Description | Example |
|---|---|---|---|---|
year_month | string | Yes | เดือนของแผน (YYYY-MM) | "2026-02" |
work_date_from | string | Yes | วันที่เริ่มต้น (YYYY-MM-DD) | "2026-02-01" |
work_date_to | string | Yes | วันที่สิ้นสุด (YYYY-MM-DD) | "2026-02-28" |
employee_lists | array | Yes | รายการพนักงาน | [{"employee_code": "EMP001"}] |
Update Mode - แก้ไขแผนกะ
| Parameter | Type | Required | Description | Example |
|---|---|---|---|---|
work_cycle_plan_id | string | Yes | รหัสแผนกะ (Base64 encoded) | "MjAyNjAxMTZDNzU4RDI2RjcyRkU" |
work_date_from | string | Yes | วันที่เริ่มต้น (YYYY-MM-DD) | "2026-02-01" |
work_date_to | string | Yes | วันที่สิ้นสุด (YYYY-MM-DD) | "2026-02-28" |
employee_lists | array | Yes | รายการพนักงานที่ต้องการให้มีในแผน | [{"employee_code": "EMP001"}] |
- การสร้างแผนใหม่ต้องระบุ
year_monthส่วนการแก้ไขแผนต้องระบุwork_cycle_plan_id employee_listsต้องมีอย่างน้อย 1 คนwork_date_fromต้องไม่เกินwork_date_to- ในโหมดแก้ไข ระบบจะซิงค์รายการพนักงานให้ตรงกับ
employee_listsที่ส่งมา (เพิ่มคนใหม่/ลบคนที่ไม่อยู่ในรายการ)
Response Format
Success Response
{
"code": 200,
"message": "Add new Work Cycle Success",
"payload": {
"work_cycle_plan_id": "20260116C758D26F72FE",
"year_month": "2026-02",
"work_date_from": "2026-02-01",
"work_date_to": "2026-02-28"
}
}กรณีแก้ไขแผน message จะเป็น "Save new Work Cycle Success"
Response Fields
| Field | Type | Description |
|---|---|---|
work_cycle_plan_id | string | รหัสแผนกะ (plain text 20 ตัวอักษร) |
year_month | string | เดือนของแผน (YYYY-MM) |
work_date_from | string | วันที่เริ่มต้น (YYYY-MM-DD) |
work_date_to | string | วันที่สิ้นสุด (YYYY-MM-DD) |
Error Response
{
"code": 400,
"message": "Master salary report not found for year_month: 2026-02",
"payload": []
}Code Examples
cURL
# สร้างแผนกะใหม่
curl -X POST "https://openapi.humansoft.co.th/api/v1/open-apis/salary/update-data-filter?path_action=set_work_cycle_plan" \
-H "Ocp-Apim-Subscription-Key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"year_month": "2026-02",
"work_date_from": "2026-02-01",
"work_date_to": "2026-02-28",
"employee_lists": [
{"employee_code": "EMP001"},
{"employee_code": "EMP002"}
]
}'
# แก้ไขแผนกะ
curl -X POST "https://openapi.humansoft.co.th/api/v1/open-apis/salary/update-data-filter?path_action=set_work_cycle_plan" \
-H "Ocp-Apim-Subscription-Key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"work_cycle_plan_id": "MjAyNjAxMTZDNzU4RDI2RjcyRkU",
"work_date_from": "2026-02-01",
"work_date_to": "2026-02-28",
"employee_lists": [
{"employee_code": "EMP001"}
]
}'Notes
- ระบบจะสร้างรายการรายวันให้กับพนักงานทุกคนในแผนโดยอัตโนมัติตามช่วงวันที่ที่กำหนด
- ในโหมดแก้ไข ระบบจะเพิ่มพนักงานใหม่และลบพนักงานที่ไม่อยู่ใน
employee_listsออกจากแผนโดยอัตโนมัติ
Related APIs
- Get Work Cycle Plans - ดูรายการแผนกะทั้งหมด
- Save Employee Plan - แก้ไขรายละเอียดกะงานรายวันของพนักงานในแผน
- Delete Plan - ลบแผนกะ
Last updated on