Update Employee Setting
Router สำหรับแก้ไขข้อมูลการตั้งค่าพนักงาน รองรับการเรียกใช้งานแบบแยกเรื่องผ่าน path_action parameter
API นี้ใช้ Router Pattern - ระบุ path_action เพื่อเลือกประเภทการตั้งค่าที่ต้องการแก้ไข
Endpoint
POST /api/v1/open-apis/employee/update-employee-settingQuery Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
path_action | string | Yes | ประเภทข้อมูลที่ต้องการแก้ไข |
employee_code | string | Yes | รหัสพนักงาน |
ใช้ employee_code เพื่อระบุพนักงาน
พารามิเตอร์ที่ลงท้ายด้วย _id ต้องส่งเป็น Base64-encoded ของ raw internal ID
- Response จะ return raw string ID (เช่น
20260121FC89F3BB9120) - เมื่อนำ ID จาก response ไปใช้ใน request ถัดไป ต้อง encode เป็น Base64 ก่อน
Supported Actions
Basic Settings
| path_action | Description |
|---|---|
basic | บันทึกข้อมูลพื้นฐาน (วันทำงาน, ชั่วโมง, การปัดเศษ) |
approver | บันทึกผู้อนุมัติ (1-5 ลำดับ) |
work-cycle | บันทึกกะการทำงาน |
User Management
| path_action | Description |
|---|---|
user-groups | บันทึกกลุ่มผู้ใช้ |
reset-user-username | รีเซ็ตชื่อผู้ใช้ |
reset-user-password | รีเซ็ตรหัสผ่าน |
Time & Leave
| path_action | Description |
|---|---|
holiday | บันทึกวันทำงาน-วันหยุด |
ot | บันทึกประเภท OT (คนเดียว) |
ot-multiple | บันทึกประเภท OT (หลายคน) |
quota | บันทึกโควตาการลา |
Other Settings
| path_action | Description |
|---|---|
worktime-config | บันทึกการตั้งค่าเวลาทำงาน |
time-frame | บันทึกป้ายกำกับช่วงเวลา |
role-duty | บันทึกหน้าที่ปฏิบัติงาน |
cost-center | บันทึกศูนย์ต้นทุน |
Action Details
basic - บันทึกข้อมูลพื้นฐาน
| Parameter | Type | Required | Description |
|---|---|---|---|
days_per_month | string | No | วันทำงานต่อเดือน |
hours_per_day | string | No | ชั่วโมงต่อวัน |
round_month_config | string | No | การปัดเศษรอบเดือน (Y/N) |
round_worktime_config | string | No | การปัดเศษเวลาทำงาน (Y/N) |
holiday_apply_config | string | No | อนุญาตวันหยุดนักขัตฤกษ์ (Y/N) |
round_ot_config | string | No | การปัดเศษ OT (Y/N) |
approver - บันทึกผู้อนุมัติ
| Parameter | Type | Required | Description |
|---|---|---|---|
auth_first | string | No | ผู้อนุมัติลำดับที่ 1 |
auth_second | string | No | ผู้อนุมัติลำดับที่ 2 |
auth_third | string | No | ผู้อนุมัติลำดับที่ 3 |
auth_fourth | string | No | ผู้อนุมัติลำดับที่ 4 |
auth_fifth | string | No | ผู้อนุมัติลำดับที่ 5 |
การบันทึกผู้อนุมัติจะลบผู้อนุมัติเดิมทั้งหมดก่อนเพิ่มใหม่
work-cycle - บันทึกกะการทำงาน
| Parameter | Type | Required | Description |
|---|---|---|---|
work_cycle_lists | array | Yes | รายการกะการทำงานรายวัน |
user-groups - บันทึกกลุ่มผู้ใช้
| Parameter | Type | Required | Description |
|---|---|---|---|
usergroup_ids | array | Yes | รายการ ID กลุ่มผู้ใช้ |
reset-user-username - รีเซ็ตชื่อผู้ใช้
| Parameter | Type | Required | Description |
|---|---|---|---|
new_username | string | Yes | ชื่อผู้ใช้ใหม่ |
reset-user-password - รีเซ็ตรหัสผ่าน
| Parameter | Type | Required | Description |
|---|---|---|---|
new_password | string | Yes | รหัสผ่านใหม่ |
holiday - บันทึกวันทำงาน-วันหยุด
| Parameter | Type | Required | Description |
|---|---|---|---|
holiday_lists | array | Yes | รายการวันหยุดรายวัน (Mon-Sun) |
ot / ot-multiple - บันทึกประเภท OT
| Parameter | Type | Required | Description |
|---|---|---|---|
ot_type_ids | array | Yes | รายการ ID ประเภท OT |
employee_lists | array | No | รายการพนักงาน (สำหรับ ot-multiple) |
quota - บันทึกโควตาการลา
| Parameter | Type | Required | Description |
|---|---|---|---|
quota_lists | array | Yes | รายการโควตาการลา |
worktime-config - บันทึกการตั้งค่าเวลาทำงาน
| Parameter | Type | Required | Description |
|---|---|---|---|
worktime_config | object | Yes | การตั้งค่าเวลาทำงาน |
time-frame - บันทึกป้ายกำกับช่วงเวลา
| Parameter | Type | Required | Description |
|---|---|---|---|
time_frame_lists | array | Yes | รายการป้ายกำกับช่วงเวลา |
role-duty - บันทึกหน้าที่ปฏิบัติงาน
| Parameter | Type | Required | Description |
|---|---|---|---|
role_duty_lists | array | Yes | รายการหน้าที่ |
cost-center - บันทึกศูนย์ต้นทุน
| Parameter | Type | Required | Description |
|---|---|---|---|
cost_center_lists | array | Yes | รายการศูนย์ต้นทุน |
Response Format
Success Response
{
"code": 200,
"message": "Save Success",
"payload": {
// ข้อมูลที่บันทึกสำเร็จ
}
}Error Response
{
"code": 400,
"message": "ข้อมูลไม่ถูกต้อง",
"errors": [
"กรุณาระบุ 'path_action'",
"กรุณาระบุ 'employee_code'"
]
}Code Examples
cURL
# บันทึกข้อมูลพื้นฐาน
curl -X POST "https://openapi.humansoft.co.th/api/v1/open-apis/employee/update-employee-setting?path_action=basic&employee_code=EMP001" \
-H "Content-Type: application/json" \
-H "Ocp-Apim-Subscription-Key: YOUR_API_KEY" \
-d '{
"days_per_month": "26",
"hours_per_day": "8",
"round_month_config": "Y"
}'
# บันทึกผู้อนุมัติ
curl -X POST "https://openapi.humansoft.co.th/api/v1/open-apis/employee/update-employee-setting?path_action=approver&employee_code=EMP001" \
-H "Content-Type: application/json" \
-H "Ocp-Apim-Subscription-Key: YOUR_API_KEY" \
-d '{
"auth_first": "MjAyNjAxMjFENEU1RjZBN0I4Qzk=",
"auth_second": "MjAyNjAxMjFFNUY2QTdCOEM5RDA="
}'
# รีเซ็ตรหัสผ่าน
curl -X POST "https://openapi.humansoft.co.th/api/v1/open-apis/employee/update-employee-setting?path_action=reset-user-password" \
-H "Content-Type: application/json" \
-H "Ocp-Apim-Subscription-Key: YOUR_API_KEY" \
-d '{
"user_id": "MjAyNjAxMjFVUzAxQTJCM0M0RDU="
}'Auto Actions
การบันทึกข้อมูลจะมีการดำเนินการอัตโนมัติ:
- บันทึก Activity Log
- แจ้งเตือน HR
Troubleshooting
| Error | Solution |
|---|---|
| กรุณาระบุ ‘path_action’ | ต้องระบุ path_action ใน query parameter |
| กรุณาระบุ ‘employee_code’ | ต้องระบุ employee_code |
| Employee not found | ตรวจสอบว่า employee_code ถูกต้อง |
| ข้อมูลไม่อัพเดท | ตรวจสอบ format ของข้อมูลที่ส่ง |
Related APIs
- Add Employee Setting - เพิ่มการตั้งค่าพนักงาน
- Delete Employee Setting - ลบการตั้งค่าพนักงาน
- Get Employee Info - ดึงข้อมูลพนักงาน
Last updated on