Save Employee Plan
บันทึกหรือแก้ไขข้อมูลแผนกะรายวันของพนักงาน สามารถระบุกะงานและประเภทวันหยุดให้กับแต่ละวันที่ต้องการแก้ไขได้
Endpoint
POST /api/v1/open-apis/salary/update-data-filter?path_action=save_employee_planRequest Body
| Parameter | Type | Required | Description | Example |
|---|---|---|---|---|
employee_code | string | Yes | รหัสพนักงาน | "EMP001" |
work_cycle_plan_id | string | Yes | รหัสแผนกะ (Base64 encoded) | "MjAyNjAxMTZDNzU4RDI2RjcyRkU" |
date_lists | object | Yes | รายการวันที่ต้องการแก้ไข | ดูตัวอย่างด้านล่าง |
โครงสร้าง date_lists
Object ที่มี Key เป็นวันที่ (YYYY-MM-DD) และ Value เป็นข้อมูลกะงานของวันนั้น:
{
"2026-02-01": {
"work_cycle_code": "DAY",
"holiday_flag_lv": "01"
},
"2026-02-02": {
"work_cycle_code": "NIGHT",
"holiday_flag_lv": "01"
}
}| Field | Type | Description |
|---|---|---|
work_cycle_code | string | รหัสกะงาน |
holiday_flag_lv | string | รหัสประเภทวันหยุด |
- สามารถส่ง
work_cycle_code(รหัสที่ตั้งเอง) หรือwork_cycle_id(Base64 encoded) ก็ได้ - หากส่ง
holiday_flag_lvเป็นค่าว่างหรือ null จะถือว่าเป็นวันทำงานปกติ - วันที่ใน
date_listsต้องอยู่ในช่วงวันที่ของแผน
Response Format
Success Response
{
"code": 200,
"message": "สำเร็จ",
"payload": {
"work_cycle_plan_id": "20260116C758D26F72FE",
"employee_id": "202503219741427917A0",
"employee_code": "EMP001"
}
}Response Fields
| Field | Type | Description |
|---|---|---|
work_cycle_plan_id | string | รหัสแผนกะ (plain text 20 ตัวอักษร) |
employee_id | string | รหัสพนักงานในระบบ |
employee_code | string | รหัสพนักงาน |
Error Response
{
"code": 404,
"message": "Work cycle plan not found",
"payload": []
}Code Examples
cURL
curl -X POST "https://openapi.humansoft.co.th/api/v1/open-apis/salary/update-data-filter?path_action=save_employee_plan" \
-H "Ocp-Apim-Subscription-Key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"employee_code": "EMP001",
"work_cycle_plan_id": "MjAyNjAxMTZDNzU4RDI2RjcyRkU",
"date_lists": {
"2026-02-01": {
"work_cycle_code": "DAY",
"holiday_flag_lv": "01"
},
"2026-02-02": {
"work_cycle_code": "NIGHT",
"holiday_flag_lv": "01"
}
}
}'Notes
- ใช้สำหรับแก้ไขกะงานและวันหยุดรายวันของพนักงานแต่ละคนในแผน
- หลังจากบันทึกเสร็จแล้ว ให้เรียก Submit Employee Plan เพื่อส่งแผนเมื่อกรอกข้อมูลครบทุกวัน
Related APIs
- Get Employee Plan Detail - ดูข้อมูลแผนรายวันก่อนแก้ไข
- Submit Employee Plan - ส่งแผนเมื่อแก้ไขเสร็จแล้ว
- Apply Plan for Employee - นำแผนไปใช้กับพนักงานคนนี้
Last updated on