Save Holiday Grid

บันทึกการแก้ไขวันหยุดของพนักงานแบบ Grid ทีละหลายคนพร้อมกันในช่วงเวลาที่กำหนด

ใช้ API นี้เพื่อบันทึกการเปลี่ยนแปลงประเภทวันหยุดรายวันที่แก้ไขบนตาราง Grid โดยอ้างอิง time_attendance_group_transac_id ที่ได้จาก Get Holiday Grid — ควรดึงตารางวันหยุดล่าสุดก่อนทุกครั้ง เพื่อให้ได้ ID รายการที่ถูกต้อง

Endpoint


POST /api/v1/open-apis/time-manage/edit-holiday-multiple

สิทธิ์ที่ต้องการ: API Key ต้องมีสิทธิ์ ข้อมูลการยื่นเอกสาร (document:manage)

Request Parameters

Parameter	Type	Required	Description	Example
`employee_lists`	array	Yes	รายชื่อพนักงานและตารางวันที่ต้องการแก้ไข (ดูโครงสร้างด้านล่าง)	`[...]`

`employee_lists[]`

Field	Type	Required	Description	Example
`employee_code`	string	Yes	รหัสพนักงานที่ต้องการบันทึกแก้ไข	`"EMP001"`
`day_lists`	array	Yes	รายการวันและรหัสสถานะวันหยุดใหม่ที่แก้ไข (ดูโครงสร้างด้านล่าง)	`[...]`

`employee_lists[].day_lists[]`

Field	Type	Required	Description	Example
`work_date`	string	Yes	วันที่ต้องการเปลี่ยนสถานะ (`YYYY-MM-DD`)	`"2026-07-01"`
`time_attendance_group_transac_id`	string	Yes	รหัสอ้างอิงรายการเวลาประจำวัน (ได้จาก Get Holiday Grid)	`"20260701ACD8956C44C3"`
`holiday_flag_lv`	string	Yes	รหัสประเภทวันหยุด (ดูตารางรหัสด้านล่าง)	`"03"`
`master_salary_report_id`	string	No	รหัสรอบเดือนประมวลผลเงินเดือน	`"202607286709D2934361"`

รหัสประเภทวันหยุด (holiday_flag_lv):

"00" = วันทำงาน
"01" = วันหยุดนักขัตฤกษ์
"03" = วันหยุดพนักงาน
"04" = วันหยุดพิเศษ

Request Body Example


{
  "employee_lists": [
    {
      "employee_code": "EMP001",
      "day_lists": [
        {
          "work_date": "2026-07-01",
          "time_attendance_group_transac_id": "20260701ACD8956C44C3",
          "holiday_flag_lv": "03",
          "master_salary_report_id": "202607286709D2934361"
        }
      ]
    }
  ]
}

Response Format

Success Response (HTTP 200)


{
  "code": 200,
  "message": "Edit Holiday Multiple Accept",
  "payload": {
    "status": "success",
    "employee_lists": [
      {
        "employee_code": "EMP001",
        "day_lists": [
          {
            "work_date": "2026-07-01",
            "time_attendance_group_transac_id": "20260701ACD8956C44C3",
            "status": "updated",
            "old_holiday_flag_lv": "00",
            "new_holiday_flag_lv": "03"
          }
        ]
      }
    ]
  }
}

Error Response - Validation Failed (HTTP 400)


{
  "code": 400,
  "message": "ไม่สำเร็จ",
  "errors": [
    "employee_lists[0].day_lists[0]: Please specify 'holiday_flag_lv'",
    "employee_lists[0].day_lists[1]: Invalid 'time_attendance_group_transac_id' (20260626FFA4A2A66734) - does not belong to employee 'EMP001'"
  ]
}

Error Response - Closed Payroll (HTTP 400)


{
  "code": 400,
  "message": "ไม่สามารถแก้ไขเอกสารได้เนื่องจากเกินกำหนดเวลาที่ร้องขอแล้ว",
  "errors": []
}

Error Response - Unauthorized (HTTP 401)


{
  "statusCode": 401,
  "message": "Access denied due to invalid subscription key. Make sure to provide a valid key for an active subscription."
}

Response Fields

`payload`

Field	Type	Nullable	Description
`status`	string	No	สถานะการดำเนินการภาพรวม (เช่น `"success"`)
`employee_lists`	array	No	รายการผลลัพธ์ของพนักงานแต่ละคน

`payload.employee_lists[]`

Field	Type	Nullable	Description
`employee_code`	string	No	รหัสพนักงานที่ดำเนินการแก้ไข
`day_lists`	array	No	รายการวันที่เปลี่ยนแปลงของพนักงานคนนั้น

`payload.employee_lists[].day_lists[]`

Field	Type	Nullable	Description
`work_date`	string	No	วันที่ทำการปรับปรุงวันหยุด (`YYYY-MM-DD`)
`time_attendance_group_transac_id`	string	No	รหัสอ้างอิงรายการเวลาประจำวัน
`status`	string	No	สถานะของวันนั้น: `"updated"` (อัปเดตสำเร็จ) หรือ `"unchanged"` (ไม่มีการเปลี่ยนแปลง)
`old_holiday_flag_lv`	string	Yes	รหัสประเภทวันหยุดเดิมก่อนแก้ไข
`new_holiday_flag_lv`	string	Yes	รหัสประเภทวันหยุดใหม่หลังแก้ไขสำเร็จ

Code Examples

cURL


curl -X POST "https://openapi.humansoft.co.th/api/v1/open-apis/time-manage/edit-holiday-multiple" \
  -H "Ocp-Apim-Subscription-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "employee_lists": [
      {
        "employee_code": "EMP001",
        "day_lists": [
          {
            "work_date": "2026-07-01",
            "time_attendance_group_transac_id": "20260701ACD8956C44C3",
            "holiday_flag_lv": "03",
            "master_salary_report_id": "202607286709D2934361"
          }
        ]
      }
    ]
  }'

JavaScript


const response = await fetch(
  'https://openapi.humansoft.co.th/api/v1/open-apis/time-manage/edit-holiday-multiple',
  {
    method: 'POST',
    headers: {
      'Ocp-Apim-Subscription-Key': 'YOUR_API_KEY',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      employee_lists: [
        {
          employee_code: 'EMP001',
          day_lists: [
            {
              work_date: '2026-07-01',
              time_attendance_group_transac_id: '20260701ACD8956C44C3',
              holiday_flag_lv: '03',
              master_salary_report_id: '202607286709D2934361'
            }
          ]
        }
      ]
    })
  }
)
 
const data = await response.json()
console.log(data)

Python


import requests
 
url = "https://openapi.humansoft.co.th/api/v1/open-apis/time-manage/edit-holiday-multiple"
headers = {
    "Ocp-Apim-Subscription-Key": "YOUR_API_KEY",
    "Content-Type": "application/json"
}
payload = {
    "employee_lists": [
        {
            "employee_code": "EMP001",
            "day_lists": [
                {
                    "work_date": "2026-07-01",
                    "time_attendance_group_transac_id": "20260701ACD8956C44C3",
                    "holiday_flag_lv": "03",
                    "master_salary_report_id": "202607286709D2934361"
                }
            ]
        }
    ]
}
 
response = requests.post(url, headers=headers, json=payload)
print(response.json())

PHP


<?php
$url = "https://openapi.humansoft.co.th/api/v1/open-apis/time-manage/edit-holiday-multiple";
 
$headers = [
    "Ocp-Apim-Subscription-Key: YOUR_API_KEY",
    "Content-Type: application/json"
];
 
$payload = [
    "employee_lists" => [
        [
            "employee_code" => "EMP001",
            "day_lists" => [
                [
                    "work_date" => "2026-07-01",
                    "time_attendance_group_transac_id" => "20260701ACD8956C44C3",
                    "holiday_flag_lv" => "03",
                    "master_salary_report_id" => "202607286709D2934361"
                ]
            ]
        ]
    ]
];
 
$ch = curl_init($url);
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($payload));
 
$response = curl_exec($ch);
print_r(json_decode($response, true));
 
curl_close($ch);
?>

Validation Rules

Parameter	Validation
`employee_lists`	ต้องส่งอาร์เรย์รายการพนักงานที่ต้องการแก้ไข
`employee_code` / `day_lists`	สมาชิกแต่ละคนใน `employee_lists` ต้องมีรหัสพนักงานและรายการรายวัน
`work_date` / `time_attendance_group_transac_id`	ทุกวันใน `day_lists` ต้องระบุวันที่และรหัสอ้างอิงรายการเวลา
`holiday_flag_lv`	ต้องระบุรหัสประเภทวันหยุด และห้ามเป็นค่าว่าง
`time_attendance_group_transac_id`	ต้องมีอยู่จริงในระบบ มิเช่นนั้นจะถูกปฏิเสธ

Business Rules

time_attendance_group_transac_id ที่ส่งเข้ามาต้องนำมาจาก Get Holiday Grid โดยตรง — ห้ามสร้างค่าขึ้นเอง
วันที่ผ่านกำหนดส่งข้อมูลหรือปิดงวดเงินเดือนแล้วจะไม่สามารถบันทึกแก้ไขได้ และระบบจะบล็อกเฉพาะพนักงานคนนั้นพร้อมส่ง error กลับทันที
หากส่ง holiday_flag_lv ที่ตรงกับค่าปัจจุบันของวันนั้น สถานะของวันจะเป็น "unchanged" (ไม่มีการเปลี่ยนแปลง)
บางกรณีระบบจะข้ามการอัปเดตวันนั้นแบบเงียบ (คืน status: "unchanged" โดยไม่แจ้ง error) เช่น เปลี่ยนเป็น holiday_flag_lv = "04" แล้วจำนวนวันหยุดเกินโควตาที่กำหนด หรือวันนั้นมี OT ที่อนุมัติแล้ว

Get Holiday Grid - ดึงตารางวันหยุดของพนักงานเพื่อนำ ID มาใช้แก้ไข
Get Work Cycle Grid - ดึงตารางกะการทำงานของพนักงานตามช่วงเวลา