Skip to Content
🚀 Welcome to Humansoft Open API Documentation

Set Work Cycle Plan

สร้างแผนกะใหม่หรือแก้ไขแผนกะที่มีอยู่ สำหรับกำหนดกะงานและวันหยุดของพนักงาน รองรับทั้งโหมดสร้างใหม่ (Create) และแก้ไข (Update)

Endpoint

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

Request Body

Create Mode - สร้างแผนกะใหม่

ParameterTypeRequiredDescriptionExample
year_monthstringYesเดือนของแผน (YYYY-MM)"2026-02"
work_date_fromstringYesวันที่เริ่มต้น (YYYY-MM-DD)"2026-02-01"
work_date_tostringYesวันที่สิ้นสุด (YYYY-MM-DD)"2026-02-28"
employee_listsarrayYesรายการพนักงาน[{"employee_code": "EMP001"}]

Update Mode - แก้ไขแผนกะ

ParameterTypeRequiredDescriptionExample
work_cycle_plan_idstringYesรหัสแผนกะ (Base64 encoded)"MjAyNjAxMTZDNzU4RDI2RjcyRkU"
work_date_fromstringYesวันที่เริ่มต้น (YYYY-MM-DD)"2026-02-01"
work_date_tostringYesวันที่สิ้นสุด (YYYY-MM-DD)"2026-02-28"
employee_listsarrayYesรายการพนักงานที่ต้องการให้มีในแผน[{"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

FieldTypeDescription
work_cycle_plan_idstringรหัสแผนกะ (plain text 20 ตัวอักษร)
year_monthstringเดือนของแผน (YYYY-MM)
work_date_fromstringวันที่เริ่มต้น (YYYY-MM-DD)
work_date_tostringวันที่สิ้นสุด (YYYY-MM-DD)

Error Response

{ "code": 400, "message": "Master salary report not found for year_month: 2026-02", "payload": [] }

Code Examples

# สร้างแผนกะใหม่ 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 ออกจากแผนโดยอัตโนมัติ

  • Get Work Cycle Plans - ดูรายการแผนกะทั้งหมด
  • Save Employee Plan - แก้ไขรายละเอียดกะงานรายวันของพนักงานในแผน
  • Delete Plan - ลบแผนกะ
Last updated on