Skip to Content
🚀 Welcome to Humansoft Open API Documentation

Get Quota by Employee

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

Endpoint

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

Query Parameters

ParameterTypeRequiredDefaultDescriptionExample
path_actionstringYes-ต้องเป็น get_quota_by_employee"get_quota_by_employee"
employee_codestringYes-รหัสพนักงาน (plain text)"EMP001"
quota_yearstringNoปีปัจจุบันปีโควตา (YYYY)"2026"
language_codestringNo"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

FieldTypeNullableDescription
time_leave_flagstringYesรหัสประเภทการลา (01-09) ไม่มีสำหรับวันหยุดพิเศษ
time_leave_flag_namestringNoชื่อประเภทการลา (ไทย)
time_leave_flag_name_enstringNoชื่อประเภทการลา (อังกฤษ)
actualnumberNoจำนวนที่ใช้ไปแล้ว
quotastringNoจำนวนโควตาทั้งหมด
unitstringNoหน่วย: "วัน" หรือ "ชั่วโมง"
holiday_keystringYes"extra_holiday" สำหรับวันหยุดพิเศษเท่านั้น
percentagenumberYesเปอร์เซ็นต์การใช้โควตา (สำหรับวันหยุดพิเศษ)

Error Response

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

Code Examples

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&quota_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 นี้แสดงเฉพาะประเภทการลาที่พนักงานมีโควตาอยู่

  • List Quotas - ดูรายการโควตาทั้งหมด
  • Get Quota by ID - ดูรายละเอียดโควตารายการเดียว
  • Get Default Quota - คำนวณโควตาเริ่มต้นจากกฎธุรกิจ
  • Save Quota - สร้าง/อัปเดตโควตา
Last updated on