Get Employee Leave Quota

ดึงข้อมูลโควตาการลาของพนักงานในปีที่ระบุ รวมถึงโควตาวันหยุดพิเศษ

Endpoint


GET /api/v1/open-apis/employee/get-employee-data-filter?path_action=get-quota

สิทธิ์ที่ต้องการ: API Key ต้องมีสิทธิ์ ข้อมูลพนักงานพื้นฐาน (employee:read:basic)

Query Parameters

Parameter	Type	Required	Description
`path_action`	string	Yes	ต้องเป็น `get-quota`
`employee_code`	string	Yes	รหัสพนักงาน
`quota_year`	string	No	ปีโควตาเป็น ปี ค.ศ. (YYYY) เช่น `2026` — ถ้าไม่ส่งจะใช้ปีปัจจุบัน

quota_year ต้องเป็นปี ค.ศ. เท่านั้น หากส่งปีที่ไม่มีข้อมูลโควตา payload จะมีเฉพาะรายการวันหยุดพิเศษ

Response Format

Success Response


{
  "code": 200,
  "message": "สำเร็จ",
  "payload": [
    {
      "time_leave_flag_id": "20260101TLF00000001",
      "time_leave_flag": "01",
      "time_leave_flag_name": "ลากิจได้รับค่าจ้าง",
      "time_leave_flag_name_en": "Leave with paid",
      "time_leave_flag_unit": "Daily",
      "quota_year": "2026",
      "quota": "6",
      "actual": "1",
      "unit": "วัน",
      "percentage": 0.17
    },
    {
      "time_leave_flag_id": "20260101TLF00000003",
      "time_leave_flag": "03",
      "time_leave_flag_name": "ลาป่วยมีใบรับรองแพทย์",
      "time_leave_flag_name_en": "Medical Leave",
      "time_leave_flag_unit": "Daily",
      "quota_year": "2026",
      "quota": "30",
      "actual": "3",
      "unit": "วัน",
      "percentage": 0.1
    },
    {
      "time_leave_flag_name": "วันหยุดพิเศษ",
      "time_leave_flag_name_en": "Extra holiday",
      "actual": "0",
      "quota": "8",
      "unit": "ชั่วโมง",
      "holiday_key": "extra_holiday"
    }
  ]
}

Response Fields

payload เป็น Array ของโควตาแต่ละประเภทการลา เรียงตามรหัสประเภทการลา

Field	Type	Description
`time_leave_flag_id`	string	ID ของประเภทการลา
`time_leave_flag`	string	รหัสประเภทการลา เช่น `"01"`, `"03"`
`time_leave_flag_name`	string	ชื่อประเภทการลา (ไทย)
`time_leave_flag_name_en`	string	ชื่อประเภทการลา (อังกฤษ)
`time_leave_flag_unit`	string	หน่วยของประเภทการลา: `Daily` (วัน) หรือ `Hour` (ชั่วโมง)
`quota_year`	string	ปีโควตา (ค.ศ.)
`quota`	string	จำนวนโควตาทั้งหมด
`actual`	string	จำนวนที่ใช้ไปแล้ว
`unit`	string	หน่วยของ `quota` และ `actual`: `วัน` หรือ `ชั่วโมง`
`percentage`	number	สัดส่วนการใช้โควตา (`actual` ÷ `quota`) ค่าระหว่าง `0` ถึง `1`

รายการวันหยุดพิเศษ — รายการสุดท้ายของ payload เสมอ

Field	Type	Description
`holiday_key`	string	`"extra_holiday"` ใช้แยกรายการนี้ออกจากประเภทการลา
`time_leave_flag_name`	string	`วันหยุดพิเศษ`
`time_leave_flag_name_en`	string	`Extra holiday`
`quota`	string/null	จำนวนโควตาวันหยุดพิเศษ — เป็น `null` ถ้าพนักงานไม่มีโควตาในปีนั้น
`actual`	string/null	จำนวนที่ใช้ไปแล้ว — เป็น `null` ถ้าพนักงานไม่มีโควตาในปีนั้น
`unit`	string	`ชั่วโมง`

Response ไม่มีฟิลด์ยอดคงเหลือ ให้คำนวณจาก quota - actual
quota และ actual เป็นตัวเลขในรูปข้อความ (เช่น "6" หรือ "12.00") ต้องแปลงเป็นตัวเลขก่อนนำไปคำนวณ
ประเภทการลาที่สะสมโควตาข้ามปีได้ quota และ actual จะเป็นยอดรวมของทุกปีที่สะสม

Error Response

ไม่ส่ง employee_code


{
  "code": 400,
  "message": "ไม่สำเร็จ",
  "errors": [
    "กรุณาระบุ 'employee_code' สำหรับ action 'get-quota'"
  ]
}

ไม่พบพนักงาน


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

เงื่อนไข	HTTP	Error Message
ไม่ส่ง `employee_code` หรือส่งค่าว่าง	400	`กรุณาระบุ 'employee_code' สำหรับ action 'get-quota'` (ใน `errors`)
ไม่พบพนักงานตาม `employee_code`	400	`Employee not found with code: xxx` (ใน `error`)

Code Examples

cURL


curl -X GET "https://openapi.humansoft.co.th/api/v1/open-apis/employee/get-employee-data-filter?path_action=get-quota&employee_code=EMP001&quota_year=2026" \
  -H "Ocp-Apim-Subscription-Key: YOUR_API_KEY"

JavaScript


const params = new URLSearchParams({
  path_action: 'get-quota',
  employee_code: 'EMP001',
  quota_year: '2026'
})
 
const response = await fetch(
  `https://openapi.humansoft.co.th/api/v1/open-apis/employee/get-employee-data-filter?${params}`,
  {
    method: 'GET',
    headers: {
      'Ocp-Apim-Subscription-Key': 'YOUR_API_KEY'
    }
  }
)
const data = await response.json()
data.payload.forEach(item => {
  const quota = Number(item.quota ?? 0)
  const actual = Number(item.actual ?? 0)
  console.log(`${item.time_leave_flag_name}: คงเหลือ ${quota - actual}/${quota} ${item.unit}`)
})

Python


import requests
 
url = "https://openapi.humansoft.co.th/api/v1/open-apis/employee/get-employee-data-filter"
headers = {"Ocp-Apim-Subscription-Key": "YOUR_API_KEY"}
params = {
    "path_action": "get-quota",
    "employee_code": "EMP001",
    "quota_year": "2026"
}
 
response = requests.get(url, headers=headers, params=params)
data = response.json()
for item in data["payload"]:
    quota = float(item.get("quota") or 0)
    actual = float(item.get("actual") or 0)
    print(f"{item['time_leave_flag_name']}: คงเหลือ {quota - actual}/{quota} {item['unit']}")

PHP


<?php
$params = http_build_query([
    "path_action"   => "get-quota",
    "employee_code" => "EMP001",
    "quota_year"    => "2026"
]);
$url = "https://openapi.humansoft.co.th/api/v1/open-apis/employee/get-employee-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);
foreach ($data["payload"] as $item) {
    $quota = (float) ($item["quota"] ?? 0);
    $actual = (float) ($item["actual"] ?? 0);
    echo $item["time_leave_flag_name"] . ": คงเหลือ " . ($quota - $actual) . "/" . $quota . " " . $item["unit"] . "\n";
}
?>

Update Quota - แก้ไขโควตาการลา
Add Actual Leave - เพิ่มยอดลาจริง
Delete Actual Leave - ลบยอดลาจริง