Skip to Content
🚀 Welcome to Humansoft Open API Documentation

Save Employee Plan

บันทึกหรือแก้ไขข้อมูลแผนกะรายวันของพนักงาน สามารถระบุกะงานและประเภทวันหยุดให้กับแต่ละวันที่ต้องการแก้ไขได้

Endpoint

POST /api/v1/open-apis/salary/update-data-filter?path_action=save_employee_plan

Request Body

ParameterTypeRequiredDescriptionExample
employee_codestringYesรหัสพนักงาน"EMP001"
work_cycle_plan_idstringYesรหัสแผนกะ (Base64 encoded)"MjAyNjAxMTZDNzU4RDI2RjcyRkU"
date_listsobjectYesรายการวันที่ต้องการแก้ไขดูตัวอย่างด้านล่าง

โครงสร้าง 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" } }
FieldTypeDescription
work_cycle_codestringรหัสกะงาน
holiday_flag_lvstringรหัสประเภทวันหยุด
  • สามารถส่ง 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

FieldTypeDescription
work_cycle_plan_idstringรหัสแผนกะ (plain text 20 ตัวอักษร)
employee_idstringรหัสพนักงานในระบบ
employee_codestringรหัสพนักงาน

Error Response

{ "code": 404, "message": "Work cycle plan not found", "payload": [] }

Code Examples

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 เพื่อส่งแผนเมื่อกรอกข้อมูลครบทุกวัน

Last updated on