Update Multiple Employee OT

บันทึกการตั้งค่าสิทธิ์ OT ให้พนักงานหลายคนพร้อมกัน

Endpoint


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

Query Parameters

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

Request Body

Parameter	Type	Required	Description
`employee_lists`	array	Yes	รายการพนักงานและ flag OT

employee_lists — แต่ละ item

Field	Type	Required	Description
`employee_code`	string	Recommended	รหัสพนักงาน
`employee_id`	string	Optional	ID พนักงาน (Base64-encoded) — ใช้ได้ถ้าไม่ส่ง employee_code
`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 เท่า

แนะนำให้ใช้ employee_code แทน employee_id ถ้าพนักงานคนไหนไม่พบ ระบบจะ skip คนนั้นและดำเนินการต่อ

Response Format

Success Response


{
  "code": 200,
  "message": "Save OT Multiple Success",
  "payload": {
    "total_processed": 2,
    "employees": [
      {
        "employee_id": "20260121FC89F3BB9120",
        "employee_ot_id": "20260213OT01A2B3C4D5",
        "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"
      },
      {
        "employee_id": "20260121AB12CD34EF56",
        "employee_ot_id": "20260213ABC456",
        "ot_1_0_able": "N",
        "ot_1_5_able": "Y",
        "ot_2_0_able": "N",
        "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
`total_processed`	number	จำนวนพนักงานที่ประมวลผลสำเร็จ
`employees`	array	รายการผลลัพธ์แต่ละคน
`employees[].employee_id`	string	employee_id ของพนักงาน
`employees[].employee_ot_id`	string	รหัส OT record
`employees[].ot_x_able`	string	สถานะ OT แต่ละประเภท (`"Y"` หรือ `"N"`)

Error Response


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

เงื่อนไข	Error Message
ไม่ส่ง `employee_lists` หรือว่าง	`กรุณาระบุ 'employee_lists'`
`employee_lists` ไม่เป็น array	`'employee_lists' ต้องเป็น array`
หา employee ไม่เจอ	skip คนนั้น ทำต่อ

Code Examples

cURL


curl -X POST "https://openapi.humansoft.co.th/api/v1/open-apis/employee/update-employee-setting?path_action=save-ot-multiple" \
  -H "Content-Type: application/json" \
  -H "Ocp-Apim-Subscription-Key: YOUR_API_KEY" \
  -d '{
    "employee_lists": [
      {
        "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"
      },
      {
        "employee_code": "2222",
        "employee_ot_id": "20260213ABC456",
        "ot_1_0_able": "N",
        "ot_1_5_able": "Y",
        "ot_2_0_able": "N",
        "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-multiple',
  {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'Ocp-Apim-Subscription-Key': 'YOUR_API_KEY'
    },
    body: JSON.stringify({
      employee_lists: [
        {
          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'
        },
        {
          employee_code: '2222',
          employee_ot_id: '20260213ABC456',
          ot_1_0_able: 'N',
          ot_1_5_able: 'Y',
          ot_2_0_able: 'N',
          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('Total processed:', data.payload.total_processed)

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-multiple"}
data = {
    "employee_lists": [
        {
            "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"
        },
        {
            "employee_code": "2222",
            "employee_ot_id": "20260213ABC456",
            "ot_1_0_able": "N",
            "ot_1_5_able": "Y",
            "ot_2_0_able": "N",
            "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"Total processed: {result['payload']['total_processed']}")

PHP


<?php
$url = "https://openapi.humansoft.co.th/api/v1/open-apis/employee/update-employee-setting?path_action=save-ot-multiple";
 
$data = [
    "employee_lists" => [
        [
            "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"
        ],
        [
            "employee_code" => "2222",
            "employee_ot_id" => "20260213ABC456",
            "ot_1_0_able" => "N",
            "ot_1_5_able" => "Y",
            "ot_2_0_able" => "N",
            "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 "Total processed: " . $result['payload']['total_processed'] . "\n";
?>

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

Update Multiple Employee OT

Endpoint

Query Parameters

Request Body

employee_lists — แต่ละ item

Response Format

Success Response

Response Fields

Error Response

Code Examples

cURL

JavaScript

Python

PHP

Related APIs