Get Extra Holiday Quota

ดึงโควตาวันหยุดพิเศษของพนักงาน แสดงโควตาทั้งหมด ใช้ไปแล้ว และคงเหลือ (หน่วยเป็นชั่วโมง)

Endpoint


GET /api/v1/open-apis/salary/get-data-filter?path_action=get_extra_holiday_quota

Request Parameters

Parameter	Type	Required	Description	Example
`employee_code`	string	Yes	รหัสพนักงาน	`"EMP001"`
`quota_year`	string	No	ปีที่ต้องการดูโควตา (YYYY) ค่าเริ่มต้น: ปีปัจจุบัน	`"2026"`
`language_code`	string	No	ภาษา: `TH` หรือ `EN` (ค่าเริ่มต้น: `TH`)	`"TH"`

Response Format

Success Response


{
  "code": 200,
  "message": "สำเร็จ",
  "payload": {
    "employee_code": "EMP001",
    "employee_id": "20260121FC89F3BB9120",
    "quota_year": "2026",
    "quota": 16.0,
    "actual": 8.0,
    "remaining": 8.0,
    "unit": "ชั่วโมง",
    "holiday_key": "extra_holiday"
  }
}

Response Fields

Field	Type	Nullable	Description
`employee_code`	string	No	รหัสพนักงาน
`employee_id`	string	No	รหัสพนักงานในระบบ (20 ตัวอักษร)
`quota_year`	string	No	ปีที่ดูโควตา (YYYY)
`quota`	number	No	โควตาทั้งหมด (ชั่วโมง)
`actual`	number	No	ใช้ไปแล้ว (ชั่วโมง)
`remaining`	number	No	คงเหลือ (ชั่วโมง) = quota - actual
`unit`	string	No	หน่วย: `"ชั่วโมง"` (TH) หรือ `"hours"` (EN)
`holiday_key`	string	No	รหัสประเภทวันหยุด: `"extra_holiday"`

Error Responses

Employee Not Found (404)


{
  "code": 404,
  "message": "Employee not found with code: EMP001"
}

Missing Required Parameter (400)


{
  "code": 400,
  "message": "ไม่สำเร็จ",
  "errors": {
    "employee_code": "employee_code is required"
  }
}

Invalid Year Format (400)


{
  "code": 400,
  "message": "ไม่สำเร็จ",
  "errors": {
    "quota_year": "Invalid format. Expected YYYY"
  }
}

Code Examples

cURL


# ดูโควตาวันหยุดพิเศษปีปัจจุบัน
curl -X GET "https://openapi.humansoft.co.th/api/v1/open-apis/salary/get-data-filter?path_action=get_extra_holiday_quota&employee_code=EMP001&language_code=TH" \
  -H "Ocp-Apim-Subscription-Key: YOUR_API_KEY"
 
# ดูโควตาวันหยุดพิเศษปี 2026
curl -X GET "https://openapi.humansoft.co.th/api/v1/open-apis/salary/get-data-filter?path_action=get_extra_holiday_quota&employee_code=EMP001&quota_year=2026&language_code=TH" \
  -H "Ocp-Apim-Subscription-Key: YOUR_API_KEY"

JavaScript


const params = new URLSearchParams({
  path_action: 'get_extra_holiday_quota',
  employee_code: 'EMP001',
  quota_year: '2026',
  language_code: 'TH'
})
const response = await fetch(
  `https://openapi.humansoft.co.th/api/v1/open-apis/salary/get-data-filter?${params}`,
  {
    method: 'GET',
    headers: { 'Ocp-Apim-Subscription-Key': 'YOUR_API_KEY' }
  }
)
const data = await response.json()
const quota = data.payload
console.log(`โควตาทั้งหมด: ${quota.quota} ${quota.unit}`)
console.log(`ใช้ไปแล้ว: ${quota.actual} ${quota.unit}`)
console.log(`คงเหลือ: ${quota.remaining} ${quota.unit}`)

Python


import requests
 
url = "https://openapi.humansoft.co.th/api/v1/open-apis/salary/get-data-filter"
headers = {"Ocp-Apim-Subscription-Key": "YOUR_API_KEY"}
params = {
    "path_action": "get_extra_holiday_quota",
    "employee_code": "EMP001",
    "quota_year": "2026",
    "language_code": "TH"
}
 
response = requests.get(url, headers=headers, params=params)
data = response.json()
quota = data["payload"]
print(f"โควตาทั้งหมด: {quota['quota']} {quota['unit']}")
print(f"ใช้ไปแล้ว: {quota['actual']} {quota['unit']}")
print(f"คงเหลือ: {quota['remaining']} {quota['unit']}")

PHP


<?php
$params = http_build_query([
    "path_action" => "get_extra_holiday_quota",
    "employee_code" => "EMP001",
    "quota_year" => "2026",
    "language_code" => "TH"
]);
$url = "https://openapi.humansoft.co.th/api/v1/open-apis/salary/get-data-filter?{$params}";
 
$ch = curl_init($url);
curl_setopt($ch, CURLOPT_HTTPHEADER, ["Ocp-Apim-Subscription-Key: YOUR_API_KEY"]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
 
$response = curl_exec($ch);
curl_close($ch);
 
$data = json_decode($response, true);
$quota = $data["payload"];
echo "โควตาทั้งหมด: {$quota['quota']} {$quota['unit']}\n";
echo "ใช้ไปแล้ว: {$quota['actual']} {$quota['unit']}\n";
echo "คงเหลือ: {$quota['remaining']} {$quota['unit']}\n";
?>

Notes

วันหยุดพิเศษ (Extra Holiday) เป็นวันหยุดที่บริษัทให้พนักงานเป็นพิเศษ โดยนับเป็นชั่วโมง (ไม่ใช่วัน)
ค่า remaining คำนวณจาก quota - actual หากใช้โควตาหมดแล้ว remaining จะเป็น 0
หาก remaining เป็น 0 พนักงานจะไม่สามารถใช้วันหยุดพิเศษเพิ่มได้
หากไม่ระบุ quota_year ระบบจะใช้ปีปัจจุบันเป็นค่าเริ่มต้น

ควรเรียก API นี้เพื่อตรวจสอบโควตาคงเหลือก่อนเลือกประเภทวันหยุดเป็น holiday_flag_lv = '04' (วันหยุดพิเศษ) ทุกครั้ง เพื่อป้องกันการเลือกวันหยุดเกินโควตาที่กำหนด

Get Holiday Types - ดึงรายการประเภทวันหยุด (ใช้ร่วมกับ code = ‘04’)
Get Work Shifts - ดึงรายการกะการทำงาน
Get Company Holidays - ดึงรายการวันหยุดบริษัท
Get Calendar Month - ดูปฏิทินทั้งเดือนตามรอบเงินเดือน