Get Quota by Employee
ดึงรายการโควตาการลาทั้งหมดของพนักงานคนเดียวในปีที่ระบุ รวมถึงโควตาวันหยุดพิเศษ
Endpoint
GET /api/v1/open-apis/salary/get-data-filter?path_action=get_quota_by_employeeQuery Parameters
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
path_action | string | Yes | - | ต้องเป็น get_quota_by_employee | "get_quota_by_employee" |
employee_code | string | Yes | - | รหัสพนักงาน (plain text) | "EMP001" |
quota_year | string | No | ปีปัจจุบัน | ปีโควตา (YYYY) | "2026" |
language_code | string | No | "TH" | ภาษาสำหรับแสดงผล | "TH", "EN" |
Response Format
Success Response
{
"code": 200,
"message": "สำเร็จ",
"payload": [
{
"time_leave_flag": "01",
"time_leave_flag_name": "ลากิจได้รับค่าจ้าง",
"time_leave_flag_name_en": "Leave with paid",
"actual": 2,
"quota": "10",
"unit": "วัน"
},
{
"time_leave_flag": "03",
"time_leave_flag_name": "ลาป่วยมีใบรับรองแพทย์",
"time_leave_flag_name_en": "Medical Leave",
"actual": 1,
"quota": "30",
"unit": "วัน"
},
{
"time_leave_flag": "06",
"time_leave_flag_name": "ลาพักร้อน",
"time_leave_flag_name_en": "Annual Leave",
"actual": 3.5,
"quota": "10",
"unit": "วัน"
},
{
"holiday_key": "extra_holiday",
"time_leave_flag_name": "วันหยุดพิเศษ",
"time_leave_flag_name_en": "Extra Holiday",
"actual": 2,
"quota": "8",
"unit": "ชั่วโมง",
"percentage": 25
}
]
}Response Fields
| Field | Type | Nullable | Description |
|---|---|---|---|
time_leave_flag | string | Yes | รหัสประเภทการลา (01-09) ไม่มีสำหรับวันหยุดพิเศษ |
time_leave_flag_name | string | No | ชื่อประเภทการลา (ไทย) |
time_leave_flag_name_en | string | No | ชื่อประเภทการลา (อังกฤษ) |
actual | number | No | จำนวนที่ใช้ไปแล้ว |
quota | string | No | จำนวนโควตาทั้งหมด |
unit | string | No | หน่วย: "วัน" หรือ "ชั่วโมง" |
holiday_key | string | Yes | "extra_holiday" สำหรับวันหยุดพิเศษเท่านั้น |
percentage | number | Yes | เปอร์เซ็นต์การใช้โควตา (สำหรับวันหยุดพิเศษ) |
Error Response
{
"code": 404,
"message": "Employee not found with code: EMP001",
"payload": []
}Code Examples
cURL
curl -X GET "https://openapi.humansoft.co.th/api/v1/open-apis/salary/get-data-filter?path_action=get_quota_by_employee&employee_code=EMP001"a_year=2026&language_code=TH" \
-H "Ocp-Apim-Subscription-Key: YOUR_API_KEY"Notes
- ถ้าไม่ระบุ
quota_yearระบบจะใช้ปีปัจจุบัน - รายการวันหยุดพิเศษจะมี
holiday_key: "extra_holiday"แทนที่จะมีtime_leave_flag - วันหยุดพิเศษใช้หน่วยเป็น
"ชั่วโมง"และมีฟิลด์percentageแสดงเปอร์เซ็นต์การใช้ - API นี้แสดงเฉพาะประเภทการลาที่พนักงานมีโควตาอยู่
Related APIs
- List Quotas - ดูรายการโควตาทั้งหมด
- Get Quota by ID - ดูรายละเอียดโควตารายการเดียว
- Get Default Quota - คำนวณโควตาเริ่มต้นจากกฎธุรกิจ
- Save Quota - สร้าง/อัปเดตโควตา
Last updated on