Update Employee Basic Setting

บันทึกข้อมูลการตั้งค่าพื้นฐานของพนักงาน เช่น วันทำงานต่อเดือน, ชั่วโมงทำงานต่อวัน, การปัดเศษ, กลุ่มบัญชี, LINE Token

Endpoint


POST /api/v1/open-apis/employee/update-employee-setting?path_action=save-basic

ฟิลด์ที่ไม่ส่งมาจะไม่ถูกเปลี่ยนแปลง (Partial Update) ส่งเฉพาะฟิลด์ที่ต้องการอัพเดท

Query Parameters

Parameter	Type	Required	Description
`path_action`	string	Yes	ต้องเป็น `save-basic` หรือ `basic`

Request Body

Employee Identification

Parameter	Type	Required	Description
`employee_code`	string	Yes	รหัสพนักงาน เช่น `"EMP001"`

Work Time Configuration

Parameter	Type	Required	Description	Example
`days_per_month`	string	No	จำนวนวันทำงานต่อเดือน (ต้องเป็น String)	`"26"`
`hours_per_day`	string	No	จำนวนชั่วโมงทำงานต่อวัน (format `HH:MM:SS`)	`"08:00:00"`

Rounding Configuration

Parameter	Type	Required	Description	Values
`round_month_config`	string	No	รอบการคำนวณเงินเดือน	`"Full"`, `"Split"`
`round_xtra_config`	string	No	รอบการคำนวณงวดพิเศษ	`"Y"`, `"N"`
`round_ot_config`	string	No	รอบการคำนวณงวดแยก OT	`"Y"`, `"N"`
`round_worktime_config`	string	No	รอบการคำนวณงวดแยกเวลาทำงาน	`"Y"`, `"N"`

Other Settings

Parameter	Type	Required	Description
`holiday_apply_config`	string	No	อนุญาตให้หยุดวันหยุดนักขัตฤกษ์ (`"Y"` / `"N"`)
`coa_account_group_id`	string	No	ตั้งค่าผังบัญชี (Base64 encoded)
`line_token_id`	string	No	LINE Notify Token ID (Base64 encoded)
`line_token_todolist_id`	string	No	LINE Notify Token ID สำหรับ To-do (Base64 encoded)
`chat_token`	string	No	Chat Token สำหรับส่งข้อมูลเข้ากลุ่มแชท

Response Format

Success Response


{
  "code": 200,
  "message": "Save Basic Info Success",
  "payload": {
    "employee_code": "EMP001",
    "employee_id": "20260121FC89F3BB9120",
    "days_per_month": "26",
    "hours_per_day": "08:00:00",
    "round_month_config": "Full",
    "round_xtra_config": "Y",
    "round_ot_config": "N",
    "round_worktime_config": "N",
    "holiday_apply_config": "Y",
    "coa_account_group_id": "",
    "line_token_id": "",
    "line_token_todolist_id": "",
    "chat_token": ""
  }
}

Error Response


{
  "code": "400",
  "message": "Validation failed",
  "errors": ["Missing required parameter: 'employee_code'"]
}

เงื่อนไข	Error Message
ไม่ส่ง `employee_code` หรือว่าง	`Missing required parameter: 'employee_code'`
`employee_code` ไม่มีในระบบ	`Employee not found with code: xxx`

Code Examples

cURL


curl -X POST "https://openapi.humansoft.co.th/api/v1/open-apis/employee/update-employee-setting?path_action=save-basic" \
  -H "Content-Type: application/json" \
  -H "Ocp-Apim-Subscription-Key: YOUR_API_KEY" \
  -d '{
    "employee_code": "EMP001",
    "days_per_month": "26",
    "hours_per_day": "08:00:00",
    "round_month_config": "Full",
    "round_xtra_config": "Y",
    "round_ot_config": "N",
    "round_worktime_config": "N",
    "holiday_apply_config": "Y"
  }'

JavaScript


const response = await fetch(
  'https://openapi.humansoft.co.th/api/v1/open-apis/employee/update-employee-setting?path_action=save-basic',
  {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'Ocp-Apim-Subscription-Key': 'YOUR_API_KEY'
    },
    body: JSON.stringify({
      employee_code: 'EMP001',
      days_per_month: '26',
      hours_per_day: '08:00:00',
      round_month_config: 'Full',
      holiday_apply_config: 'Y'
    })
  }
)
const data = await response.json()
console.log('Updated:', data.message)

Python


import requests
 
url = "https://openapi.humansoft.co.th/api/v1/open-apis/employee/update-employee-setting"
headers = {
    "Content-Type": "application/json",
    "Ocp-Apim-Subscription-Key": "YOUR_API_KEY"
}
params = {"path_action": "save-basic"}
data = {
    "employee_code": "EMP001",
    "days_per_month": "26",
    "hours_per_day": "08:00:00",
    "round_month_config": "Full",
    "holiday_apply_config": "Y"
}
 
response = requests.post(url, headers=headers, params=params, json=data)
result = response.json()
print(f"Updated: {result['message']}")

PHP


<?php
$url = "https://openapi.humansoft.co.th/api/v1/open-apis/employee/update-employee-setting?path_action=save-basic";
 
$data = [
    "employee_code" => "EMP001",
    "days_per_month" => "26",
    "hours_per_day" => "08:00:00",
    "round_month_config" => "Full",
    "holiday_apply_config" => "Y"
];
 
$ch = curl_init($url);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    "Content-Type: application/json",
    "Ocp-Apim-Subscription-Key: YOUR_API_KEY"
]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
 
$response = curl_exec($ch);
curl_close($ch);
 
$result = json_decode($response, true);
echo "Updated: " . $result['message'] . "\n";
?>

Notes

days_per_month ต้องเป็น String เช่น "26" ไม่ใช่ Number 26 และ hours_per_day ต้องเป็น format "HH:MM:SS" เช่น "08:00:00"

Update Approver - แก้ไขผู้อนุมัติของพนักงาน