Get Default Quota
คำนวณโควตาการลาเริ่มต้นของพนักงานตามกฎธุรกิจที่ตั้งค่าไว้ในระบบ โดยไม่ดึงจากข้อมูลที่บันทึกแล้ว
Endpoint
GET /api/v1/open-apis/salary/get-data-filter?path_action=get_default_quotaQuery Parameters
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
path_action | string | Yes | - | ต้องเป็น get_default_quota | "get_default_quota" |
employee_code | string | Yes | - | รหัสพนักงาน (plain text) | "EMP001" |
time_leave_flag | string | Yes | - | รหัสประเภทการลา (01-09) | "06" |
quota_year | string | No | ปีปัจจุบัน | ปีโควตา (YYYY) | "2026" |
language_code | string | No | "TH" | ภาษาสำหรับแสดงผล | "TH", "EN" |
Response Format
Success Response
{
"code": 200,
"message": "สำเร็จ",
"payload": {
"employee_code": "EMP001",
"employee_name": "สมชาย",
"employee_last_name": "ใจดี",
"time_leave_flag": "06",
"time_leave_flag_name": "ลาพักร้อน",
"time_leave_flag_name_en": "Annual Leave",
"quota_year": "2026",
"quota": "10",
"unit": "วัน",
"work_months": 18,
"work_years": 1.5,
"calculation_method": "by_work_year"
}
}Response Fields
| Field | Type | Nullable | Description |
|---|---|---|---|
employee_code | string | No | รหัสพนักงาน |
employee_name | string | No | ชื่อพนักงาน (ตาม language_code) |
employee_last_name | string | No | นามสกุลพนักงาน (ตาม language_code) |
time_leave_flag | string | No | รหัสประเภทการลา |
time_leave_flag_name | string | No | ชื่อประเภทการลา (ไทย) |
time_leave_flag_name_en | string | No | ชื่อประเภทการลา (อังกฤษ) |
quota_year | string | No | ปีโควตา (YYYY) |
quota | string | No | จำนวนโควตาที่คำนวณได้ |
unit | string | No | หน่วย: "วัน" หรือ "ชั่วโมง" |
work_months | number | Yes | จำนวนเดือนที่ทำงาน |
work_years | number | Yes | จำนวนปีที่ทำงาน |
calculation_method | string | 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_default_quota&employee_code=EMP001&time_leave_flag=06"a_year=2026&language_code=TH" \
-H "Ocp-Apim-Subscription-Key: YOUR_API_KEY"Notes
- API นี้คำนวณโควตาจากกฎธุรกิจที่ตั้งค่าไว้ในระบบ ไม่ได้ดึงจากข้อมูลที่บันทึกแล้ว
- ใช้สำหรับดูว่าพนักงานควรได้โควตาเท่าไหร่ก่อนบันทึก
work_monthsและwork_yearsคำนวณจากวันเริ่มงานของพนักงาน- ผลลัพธ์อาจแตกต่างจากโควตาที่บันทึกจริง ถ้ามีการปรับโควตาด้วยมือ
Related APIs
- Get Quota by Employee - ดูโควตาที่บันทึกจริง
- Save Quota - บันทึกโควตา (ใช้ค่าจาก API นี้เป็นค่าเริ่มต้น)
- Get Leave Types - ดูประเภทการลาที่ใช้งานได้ (สำหรับเลือก time_leave_flag)
Last updated on