Update Employee OT

บันทึกการตั้งค่าสิทธิ์ OT ให้พนักงาน 1 คน — กำหนดว่าพนักงานสามารถทำ OT ประเภทใดได้บ้าง (1.0x - 7.0x)

Endpoint


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

Query Parameters

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

Request Body

Parameter	Type	Required	Description
`employee_code`	string	Yes	รหัสพนักงาน เช่น `"EMP001"`
`employee_ot_id`	string/null	No	ID record OT ที่จะอัพเดท — `null` = สร้างใหม่
`ot_1_0_able`	string	No	อนุญาต OT 1.0 เท่า (`"Y"` / `"N"`)
`ot_1_5_able`	string	No	อนุญาต OT 1.5 เท่า
`ot_2_0_able`	string	No	อนุญาต OT 2.0 เท่า
`ot_3_0_able`	string	No	อนุญาต OT 3.0 เท่า
`ot_4_0_able`	string	No	อนุญาต OT 4.0 เท่า
`ot_5_0_able`	string	No	อนุญาต OT 5.0 เท่า
`ot_6_0_able`	string	No	อนุญาต OT 6.0 เท่า
`ot_7_0_able`	string	No	อนุญาต OT 7.0 เท่า

ค่า Default ของ ot_x_able คือ "N" (ไม่อนุญาต) ถ้าไม่ส่งฟิลด์ใด ระบบจะใช้ค่า "N" ส่ง employee_ot_id เป็น null เพื่อสร้าง record ใหม่ หรือส่ง ID ที่ได้จาก GET endpoint เพื่ออัพเดท

Response Format

Success Response


{
  "code": 200,
  "message": "Save OT Success",
  "payload": {
    "employee_ot_id": "20260213ABC12345",
    "employee_id": "20260121FC89F3BB9120",
    "ot_1_0_able": "Y",
    "ot_1_5_able": "Y",
    "ot_2_0_able": "Y",
    "ot_3_0_able": "N",
    "ot_4_0_able": "N",
    "ot_5_0_able": "N",
    "ot_6_0_able": "N",
    "ot_7_0_able": "N"
  }
}

Response Fields

Field	Type	Description
`employee_ot_id`	string	รหัส OT record
`employee_id`	string	employee_id ของพนักงาน
`ot_1_0_able` ~ `ot_7_0_able`	string	สถานะ OT แต่ละประเภท (`"Y"` หรือ `"N"`)

Error Response


{
  "code": 400,
  "message": "ข้อมูลไม่ถูกต้อง",
  "errors": ["กรุณาระบุ 'employee_code'"]
}

เงื่อนไข	Error Message
ไม่ส่ง `employee_code` หรือว่าง	`กรุณาระบุ 'employee_code'`
`employee_code` ไม่มีในระบบ	`Employee not found with code: xxx`
`employee_ot_id` ไม่ถูกต้อง	`ไม่สามารถบันทึกการตั้งค่า OT ได้`

Code Examples

cURL


curl -X POST "https://openapi.humansoft.co.th/api/v1/open-apis/employee/update-employee-setting?path_action=save-ot" \
  -H "Content-Type: application/json" \
  -H "Ocp-Apim-Subscription-Key: YOUR_API_KEY" \
  -d '{
    "employee_code": "EMP001",
    "employee_ot_id": null,
    "ot_1_0_able": "Y",
    "ot_1_5_able": "Y",
    "ot_2_0_able": "Y",
    "ot_3_0_able": "N",
    "ot_4_0_able": "N",
    "ot_5_0_able": "N",
    "ot_6_0_able": "N",
    "ot_7_0_able": "N"
  }'

JavaScript


const response = await fetch(
  'https://openapi.humansoft.co.th/api/v1/open-apis/employee/update-employee-setting?path_action=save-ot',
  {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'Ocp-Apim-Subscription-Key': 'YOUR_API_KEY'
    },
    body: JSON.stringify({
      employee_code: 'EMP001',
      employee_ot_id: null,
      ot_1_0_able: 'Y',
      ot_1_5_able: 'Y',
      ot_2_0_able: 'Y',
      ot_3_0_able: 'N',
      ot_4_0_able: 'N',
      ot_5_0_able: 'N',
      ot_6_0_able: 'N',
      ot_7_0_able: 'N'
    })
  }
)
const data = await response.json()
console.log('Updated:', data.message)
console.log('OT Record ID:', data.payload.employee_ot_id)

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-ot"}
data = {
    "employee_code": "EMP001",
    "employee_ot_id": None,
    "ot_1_0_able": "Y",
    "ot_1_5_able": "Y",
    "ot_2_0_able": "Y",
    "ot_3_0_able": "N",
    "ot_4_0_able": "N",
    "ot_5_0_able": "N",
    "ot_6_0_able": "N",
    "ot_7_0_able": "N"
}
 
response = requests.post(url, headers=headers, params=params, json=data)
result = response.json()
print(f"Updated: {result['message']}")
print(f"OT Record ID: {result['payload']['employee_ot_id']}")

PHP


<?php
$url = "https://openapi.humansoft.co.th/api/v1/open-apis/employee/update-employee-setting?path_action=save-ot";
 
$data = [
    "employee_code" => "EMP001",
    "employee_ot_id" => null,
    "ot_1_0_able" => "Y",
    "ot_1_5_able" => "Y",
    "ot_2_0_able" => "Y",
    "ot_3_0_able" => "N",
    "ot_4_0_able" => "N",
    "ot_5_0_able" => "N",
    "ot_6_0_able" => "N",
    "ot_7_0_able" => "N"
];
 
$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";
echo "OT Record ID: " . $result['payload']['employee_ot_id'] . "\n";
?>

Get OT - ดึงข้อมูลสิทธิ์ OT ของพนักงาน
Update Multiple OT - บันทึกสิทธิ์ OT หลายคนพร้อมกัน