Get Holiday Change List

ดึงรายการคำขอเปลี่ยนวันหยุดตามเงื่อนไขที่กำหนด พร้อมรองรับการ filter และ pagination

ใช้ API นี้เพื่อดึงรายการคำขอเปลี่ยนวันหยุด ติดตามสถานะการอนุมัติ หรือสร้างรายงานสรุป

Endpoint


GET /api/v1/open-apis/holiday-change/get-list

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

Request Parameters

Required Parameters

Parameter	Type	Required	Description	Example
`start_date`	string	Yes	วันที่เริ่มต้น (YYYY-MM-DD)	`2026-01-01`
`end_date`	string	Yes	วันที่สิ้นสุด (YYYY-MM-DD)	`2026-01-31`

Optional Parameters

Parameter	Type	Required	Description	Example
`employee_code`	string	No	รหัสพนักงาน	`EMP001`
`approve_flag`	string	No	สถานะการอนุมัติ (`01`, `02`, `03`)	`01`
`holiday_mode_lv`	string	No	โหมดการเปลี่ยน (`change`, `switch`)	`change`
`holiday_flag_lv`	string	No	ประเภทวันหยุด (`00`, `01`, `03`, `04`)	`01`
`keyword`	string	No	คำค้นหา (ชื่อ, รหัสพนักงาน)	`สมชาย`
`company_id`	string	No	ID บริษัท (Base64)	`MjAyNTExMjdENDU3M0M0MjE2Mzk=`
`branch_id`	string	No	ID สาขา (Base64)	`MjAyNTExMjdENDU3M0M0MjE2Mzk=`
`department_id`	string	No	ID แผนก (Base64)	`MjAyNTExMjdENDU3M0M0MjE2Mzk=`
`sort_by`	string	No	เรียงตาม field	`holiday_change_dt`
`sort_order`	string	No	ลำดับการเรียง (`ASC`, `DESC`)	`DESC`
`_PAGE`	number	No	หน้าที่ต้องการ	`1`
`_NUMBER_PER_PAGE`	number	No	จำนวนรายการต่อหน้า (1-100, ค่าเริ่มต้น 10)	`10`

Approve Flag Filter Values

Value	Status	Description
`01`	Pending	รออนุมัติทั้งหมด (รวม `04`-`08`)
`02`	Approved	อนุมัติแล้ว
`03`	Not Approved	ไม่อนุมัติ

Sort By Options

holiday_change_dt - วันที่เปลี่ยนวันหยุด (default, เรียงจากวันที่เก่าไปใหม่)
employee_code - รหัสพนักงาน
approve_flag - สถานะการอนุมัติ
created - วันที่สร้าง

เมื่อเรียงตาม holiday_change_dt (ค่าเริ่มต้น) ผลการเรียงจะกลับด้านกับ sort_order — ไม่ส่งหรือส่ง DESC จะได้วันที่เก่าไปใหม่ ส่วน ASC จะได้วันที่ใหม่ไปเก่า การเรียงตาม field อื่นเป็นไปตาม sort_order ตามปกติ

Response Format

Success Response (HTTP 200)


{
  "code": 200,
  "message": "สำเร็จ",
  "payload": [
    {
      "holiday_change_id": "20251127D4573C421639",
      "employee_code": "EMP001",
      "employee_name": "สมชาย",
      "employee_last_name": "ใจดี",
      "employee_nickname": "ชาย",
      "employee_name_en": "Somchai",
      "employee_last_name_en": "Jaidee",
      "employee_nickname_en": "Chai",
      "holiday_change_dt": "2026-01-15",
      "holiday_mode_lv": "change",
      "holiday_mode_name": "เปลี่ยนวันหยุด",
      "holiday_mode_name_en": "Change Holiday",
      "holiday_flag_lv": "00",
      "holiday_type": "Workday",
      "holiday_change_desc": "เปลี่ยนเป็นวันทำงานเนื่องจากต้องประชุมลูกค้า",
      "approve_flag": "01",
      "approve_status": "Pending",
      "approve_id": "20251127D4573C421639",
      "approve_upd": "2026-01-13 10:30:00",
      "approve_remark": "",
      "created": "2026-01-13 09:00:00",
      "created_by": "20251127D4573C421639",
      "last_upd": "2026-01-13 10:30:00",
      "last_upd_by": "20251127D4573C421639",
      "image_url": "https://cdn.humansoft.co.th/.../image/a1B2c3D4e5F6.png"
    }
  ],
  "_PAGINATION": {
    "_TOTAL_RECORDS": 25,
    "_PAGE": 1,
    "_NUMBER_PER_PAGE": 20
  }
}

Success Response - Switch Mode


{
  "code": 200,
  "message": "สำเร็จ",
  "payload": [
    {
      "holiday_change_id": "20251127D4573C421639",
      "employee_code": "EMP001",
      "employee_name": "สมชาย",
      "employee_last_name": "ใจดี",
      "employee_nickname": "ชาย",
      "employee_name_en": "Somchai",
      "employee_last_name_en": "Jaidee",
      "employee_nickname_en": "Chai",
      "holiday_change_dt": "2026-01-18",
      "holiday_mode_lv": "switch",
      "holiday_mode_name": "สลับวันหยุด",
      "holiday_mode_name_en": "Switch Holiday",
      "holiday_flag_lv": "03",
      "holiday_type": "Employee Holiday",
      "holiday_change_desc": "สลับวันหยุดกับวันทำงาน",
      "approve_flag": "02",
      "approve_status": "Approved",
      "approve_id": "20251127D4573C421639",
      "approve_upd": "2026-01-12 16:00:00",
      "approve_remark": "",
      "created": "2026-01-12 14:00:00",
      "created_by": "20251127D4573C421639",
      "last_upd": "2026-01-12 16:00:00",
      "last_upd_by": "20251127D4573C421639",
      "image_url": null,
      "holiday_switch_dt": "2026-01-20",
      "switch_holiday_flag_lv_from": "00",
      "switch_holiday_flag_lv_to": "03"
    }
  ],
  "_PAGINATION": {
    "_TOTAL_RECORDS": 1,
    "_PAGE": 1,
    "_NUMBER_PER_PAGE": 10
  }
}

Success Response - No Data (HTTP 200)


{
  "code": 200,
  "message": "สำเร็จ",
  "payload": [],
  "_PAGINATION": {
    "_TOTAL_RECORDS": 0,
    "_PAGE": 1,
    "_NUMBER_PER_PAGE": 10
  }
}

Error Response - Validation Failed (HTTP 400)


{
  "code": 400,
  "message": "ไม่สำเร็จ",
  "errors": [
    "Missing required parameter: 'start_date'",
    "'end_date' must be in format YYYY-MM-DD"
  ]
}

Error Response - Employee Not Found (HTTP 400)


{
  "code": 400,
  "message": "ไม่สำเร็จ",
  "error": "Employee not found: EMP001"
}

Response Fields

Field	Type	Description
`holiday_change_id`	string	ID ของคำขอเปลี่ยนวันหยุด
`employee_code`	string	รหัสพนักงาน
`employee_name`	string	ชื่อพนักงาน (ไทย)
`employee_last_name`	string	นามสกุลพนักงาน (ไทย)
`employee_nickname`	string	ชื่อเล่น (ไทย)
`employee_name_en`	string	ชื่อพนักงาน (อังกฤษ)
`employee_last_name_en`	string	นามสกุลพนักงาน (อังกฤษ)
`employee_nickname_en`	string	ชื่อเล่น (อังกฤษ)
`holiday_change_dt`	string	วันที่ต้องการเปลี่ยน
`holiday_mode_lv`	string	โหมดการเปลี่ยน (`change`, `switch`)
`holiday_mode_name`	string	ชื่อโหมด (ไทย)
`holiday_mode_name_en`	string	ชื่อโหมด (อังกฤษ)
`holiday_flag_lv`	string	รหัสประเภทวันหยุด
`holiday_type`	string	ชื่อประเภทวันหยุด (อังกฤษ)
`holiday_change_desc`	string	เหตุผลการเปลี่ยน
`approve_flag`	string	รหัสสถานะการอนุมัติ (ดูตาราง Approve Status Values)
`approve_status`	string	ชื่อสถานะการอนุมัติ (ดูตาราง Approve Status Values)
`approve_id`	string	user_id ของผู้ทำรายการล่าสุด (ผู้ยื่น/แก้ไขคำขอ หรือผู้อนุมัติ)
`approve_upd`	datetime	วันเวลาที่ปรับสถานะล่าสุด (ยื่น/แก้ไข/อนุมัติ)
`approve_remark`	string	หมายเหตุการอนุมัติ
`created`	datetime	วันเวลาที่สร้าง
`created_by`	string	user_id ของผู้สร้างเอกสาร
`last_upd`	datetime	วันเวลาที่แก้ไขล่าสุด
`last_upd_by`	string	user_id ของผู้แก้ไขล่าสุด
`image_url`	string \| null	URL ของไฟล์แนบ, `null` หากไม่มีไฟล์แนบ

Switch Mode Additional Fields

Field	Type	Description
`holiday_switch_dt`	string	วันที่สลับไป
`switch_holiday_flag_lv_from`	string	ประเภทวันเดิม
`switch_holiday_flag_lv_to`	string	ประเภทวันใหม่

Approve Status Values

`approve_flag`	`approve_status`	Description
`01`	`Pending`	รออนุมัติ
`02`	`Approved`	อนุมัติแล้ว
`03`	`Not Approved`	ไม่อนุมัติ
`04`	`Manager Approved`	หัวหน้าอนุมัติขั้นที่ 1 แล้ว รอขั้นถัดไป
`05`	`Recheck`	ส่งกลับตรวจสอบอีกครั้ง
`06`	`Manager Approved`	หัวหน้าอนุมัติขั้นที่ 2 แล้ว รอขั้นถัดไป
`07`	`Manager Approved`	หัวหน้าอนุมัติขั้นที่ 3 แล้ว รอขั้นถัดไป
`08`	`Manager Approved`	หัวหน้าอนุมัติขั้นที่ 4 แล้ว รอขั้นถัดไป

Code Examples

cURL


curl -X GET "https://openapi.humansoft.co.th/api/v1/open-apis/holiday-change/get-list?start_date=2026-01-01&end_date=2026-01-31&approve_flag=01&_NUMBER_PER_PAGE=20" \
  -H "Ocp-Apim-Subscription-Key: YOUR_API_KEY"

JavaScript


const params = new URLSearchParams({
  start_date: '2026-01-01',
  end_date: '2026-01-31',
  approve_flag: '01',
  _NUMBER_PER_PAGE: '20'
})
 
const response = await fetch(
  `https://openapi.humansoft.co.th/api/v1/open-apis/holiday-change/get-list?${params}`,
  {
    method: 'GET',
    headers: {
      'Ocp-Apim-Subscription-Key': 'YOUR_API_KEY'
    }
  }
)
 
const data = await response.json()
 
// แสดงรายการคำขอ
data.payload.forEach(item => {
  console.log(`${item.employee_name}: ${item.holiday_change_dt} - ${item.approve_status}`)
})
 
// แสดง pagination info
console.log(`Total: ${data._PAGINATION._TOTAL_RECORDS} records`)

Python


import requests
 
url = "https://openapi.humansoft.co.th/api/v1/open-apis/holiday-change/get-list"
headers = {
    "Ocp-Apim-Subscription-Key": "YOUR_API_KEY"
}
params = {
    "start_date": "2026-01-01",
    "end_date": "2026-01-31",
    "approve_flag": "01",
    "_NUMBER_PER_PAGE": 20
}
 
response = requests.get(url, headers=headers, params=params)
data = response.json()
 
# แสดงรายการคำขอ
for item in data['payload']:
    print(f"{item['employee_name']}: {item['holiday_change_dt']} - {item['approve_status']}")
 
# แสดง pagination info
print(f"Total: {data['_PAGINATION']['_TOTAL_RECORDS']} records")

PHP


<?php
$params = http_build_query([
    'start_date' => '2026-01-01',
    'end_date' => '2026-01-31',
    'approve_flag' => '01',
    '_NUMBER_PER_PAGE' => 20
]);
 
$url = "https://openapi.humansoft.co.th/api/v1/open-apis/holiday-change/get-list?" . $params;
 
$headers = [
    "Ocp-Apim-Subscription-Key: YOUR_API_KEY",
];
 
$ch = curl_init($url);
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
 
$response = curl_exec($ch);
$data = json_decode($response, true);
 
// แสดงรายการคำขอ
foreach ($data['payload'] as $item) {
    echo "{$item['employee_name']}: {$item['holiday_change_dt']} - {$item['approve_status']}\n";
}
 
// แสดง pagination info
echo "Total: {$data['_PAGINATION']['_TOTAL_RECORDS']} records\n";
 
curl_close($ch);
?>

Validation Rules

Parameter	Validation	Error Message
`start_date`	ต้องระบุและรูปแบบ YYYY-MM-DD	`Missing required parameter: 'start_date'`
`end_date`	ต้องระบุและรูปแบบ YYYY-MM-DD	`Missing required parameter: 'end_date'`
`end_date`	ต้อง >= start_date	`'end_date' must be greater than or equal to 'start_date'`
`start_date`, `end_date`	ต้องอยู่ในรูปแบบ YYYY-MM-DD	`'start_date' must be in format YYYY-MM-DD`
`start_date`, `end_date`	ต้องเป็นวันที่ที่มีอยู่จริง	`'start_date' is not a valid date`
`approve_flag`	ต้องเป็น `01`, `02`, หรือ `03`	`'approve_flag' must be one of: 01, 02, 03`
`holiday_mode_lv`	ต้องเป็น `change` หรือ `switch`	`'holiday_mode_lv' must be 'change' or 'switch'`
`holiday_flag_lv`	ต้องเป็น `00`, `01`, `03`, หรือ `04`	`'holiday_flag_lv' must be one of: 00, 01, 03, 04`
`sort_by`	ต้องเป็น field ที่รองรับ	`'sort_by' must be one of: holiday_change_dt, employee_code, approve_flag, created`
`sort_order`	ต้องเป็น `ASC` หรือ `DESC`	`'sort_order' must be either 'ASC' or 'DESC'`
`_PAGE`	ต้องเป็นตัวเลขตั้งแต่ 1 ขึ้นไป	`'_PAGE' must be a positive number`
`_NUMBER_PER_PAGE`	ต้องเป็นตัวเลข 1-100	`'_NUMBER_PER_PAGE' must be a number between 1 and 100`

Notes

approve_flag = '01' จะดึงรายการที่รออนุมัติทุกระดับ (01, 04-08) รวมถึงเอกสารที่ถูกส่งกลับตรวจสอบอีกครั้ง (05)
ข้อมูล switch mode จะมี field เพิ่มเติม (holiday_switch_dt, switch_holiday_flag_lv_from, switch_holiday_flag_lv_to)

Use Cases

แสดงรายการรออนุมัติ - ใช้ approve_flag=01 เพื่อดึงคำขอที่รออนุมัติ
ค้นหาตามพนักงาน - ใช้ employee_code หรือ keyword เพื่อค้นหา
รายงานประจำเดือน - ใช้ start_date และ end_date ของเดือนนั้น
Filter ตามแผนก - ใช้ department_id เพื่อกรองตามแผนก

Error Handling

Error	Cause	Solution
`Missing required parameter: 'start_date'`	ไม่ได้ส่ง start_date	ตรวจสอบ query parameter
`'start_date' must be in format YYYY-MM-DD`	รูปแบบวันที่ไม่ถูกต้อง	ใช้รูปแบบ YYYY-MM-DD
`'end_date' must be greater than or equal to 'start_date'`	end_date น้อยกว่า start_date	ตรวจสอบช่วงวันที่
`Employee not found: XXX`	ไม่พบพนักงาน	ตรวจสอบ employee_code

Get Holiday Types - ดึงรายการประเภทวันหยุด
Submit Holiday Change - ยื่นคำขอเปลี่ยนวันหยุด