Update Employee Holiday

บันทึกวันทำงาน-วันหยุดประจำสัปดาห์ของพนักงาน สามารถกำหนดให้หลายคนพร้อมกันได้

Endpoint


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

Query Parameters

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

Request Body

Parameter	Type	Required	Description
`employee_lists`	array	Yes	รายการพนักงานและวันหยุด

employee_lists — แต่ละ item

Field	Type	Required	Description
`employee_code`	string	Yes	รหัสพนักงาน
`holiday_format`	string	Yes	รูปแบบ (ใช้ `"daily"`)
`day_lists`	array	Yes	รายการวัน 7 วัน

day_lists — แต่ละวัน

Field	Type	Required	Description	Example
`day`	string	Yes	ชื่อวัน (`Mon`, `Tue`, `Wed`, `Thu`, `Fri`, `Sat`, `Sun`)	`"Mon"`
`id`	string	Yes	`"00"` = วันทำงาน, `"03"` = วันหยุดพนักงาน	`"00"`

id = "00" หมายถึงวันทำงาน (Workday), id = "03" หมายถึงวันหยุดพนักงาน (Holiday)

Response Format

Success Response


{
  "code": 200,
  "message": "Save Holiday Success",
  "payload": {
    "employee_lists": [
      {
        "employee_code": "EMP001",
        "holiday_format": "daily",
        "day_lists": [
          { "day": "Mon", "id": "00" },
          { "day": "Tue", "id": "00" },
          { "day": "Wed", "id": "00" },
          { "day": "Thu", "id": "00" },
          { "day": "Fri", "id": "00" },
          { "day": "Sat", "id": "03" },
          { "day": "Sun", "id": "03" }
        ]
      }
    ]
  }
}

Error Response


{
  "code": "400",
  "message": "กรุณาระบุ 'employee_lists'"
}

เงื่อนไข	Error Message
ไม่ส่ง `employee_lists`	`กรุณาระบุ 'employee_lists'`
`employee_lists` ไม่เป็น array	`'employee_lists' ต้องเป็น array`
ไม่ส่ง `employee_code`	`ไม่พบ 'employee_code' ในรายการที่ x`
ไม่ส่ง `day_lists`	`ไม่พบ 'day_lists' ในรายการที่ x`
หา employee ไม่เจอ	`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-holiday" \
  -H "Content-Type: application/json" \
  -H "Ocp-Apim-Subscription-Key: YOUR_API_KEY" \
  -d '{
    "employee_lists": [
      {
        "employee_code": "EMP001",
        "holiday_format": "daily",
        "day_lists": [
          { "day": "Mon", "id": "00" },
          { "day": "Tue", "id": "00" },
          { "day": "Wed", "id": "00" },
          { "day": "Thu", "id": "00" },
          { "day": "Fri", "id": "00" },
          { "day": "Sat", "id": "03" },
          { "day": "Sun", "id": "03" }
        ]
      }
    ]
  }'

JavaScript


const response = await fetch(
  'https://openapi.humansoft.co.th/api/v1/open-apis/employee/update-employee-setting?path_action=save-holiday',
  {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'Ocp-Apim-Subscription-Key': 'YOUR_API_KEY'
    },
    body: JSON.stringify({
      employee_lists: [
        {
          employee_code: 'EMP001',
          holiday_format: 'daily',
          day_lists: [
            { day: 'Mon', id: '00' },
            { day: 'Tue', id: '00' },
            { day: 'Wed', id: '00' },
            { day: 'Thu', id: '00' },
            { day: 'Fri', id: '00' },
            { day: 'Sat', id: '03' },
            { day: 'Sun', id: '03' }
          ]
        }
      ]
    })
  }
)
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-holiday"}
data = {
    "employee_lists": [
        {
            "employee_code": "EMP001",
            "holiday_format": "daily",
            "day_lists": [
                {"day": "Mon", "id": "00"},
                {"day": "Tue", "id": "00"},
                {"day": "Wed", "id": "00"},
                {"day": "Thu", "id": "00"},
                {"day": "Fri", "id": "00"},
                {"day": "Sat", "id": "03"},
                {"day": "Sun", "id": "03"}
            ]
        }
    ]
}
 
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-holiday";
 
$data = [
    "employee_lists" => [
        [
            "employee_code" => "EMP001",
            "holiday_format" => "daily",
            "day_lists" => [
                ["day" => "Mon", "id" => "00"],
                ["day" => "Tue", "id" => "00"],
                ["day" => "Wed", "id" => "00"],
                ["day" => "Thu", "id" => "00"],
                ["day" => "Fri", "id" => "00"],
                ["day" => "Sat", "id" => "03"],
                ["day" => "Sun", "id" => "03"]
            ]
        ]
    ]
];
 
$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

day_lists ต้องมีครบ 7 วัน (Mon-Sun) ค่า id ต้องเป็น "00" หรือ "03" เท่านั้น

Get Holiday - ดึงข้อมูลวันหยุดประจำสัปดาห์ของพนักงาน