Skip to Content
🚀 Welcome to Humansoft Open API Documentation

Get Actual Leave

ดูประวัติการลาจริงของพนักงานตามประเภทการลาและปีที่ระบุ แสดงข้อมูลการลาแยกตามปี

Endpoint

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

Query Parameters

ParameterTypeRequiredDefaultDescriptionExample
path_actionstringYes-ต้องเป็น get_actual_leave"get_actual_leave"
employee_codestringYes-รหัสพนักงาน (plain text)"EMP001"
time_leave_flagstringYes-รหัสประเภทการลา (01-09)"06"
quota_yearstringYes-ปีโควตา (YYYY)"2026"
language_codestringNo"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", "actual_leave": [ { "actual_leave_id": "20260201AL01A2B3C4D5", "work_date": "2026-01-15", "absence_day": 1, "in_year": "2026", "time_leave_desc": "ลาพักร้อนประจำปี", "remark": "" }, { "actual_leave_id": "20260201AL02E3F4A5B6", "work_date": "2026-02-10", "absence_day": 0.5, "in_year": "2026", "time_leave_desc": "ลาพักร้อนครึ่งวันเช้า", "remark": "ธุระส่วนตัว" } ] } }

Response Fields

FieldTypeNullableDescription
employee_codestringNoรหัสพนักงาน
employee_namestringNoชื่อพนักงาน (ตาม language_code)
employee_last_namestringNoนามสกุลพนักงาน
time_leave_flagstringNoรหัสประเภทการลา
time_leave_flag_namestringNoชื่อประเภทการลา (ไทย)
time_leave_flag_name_enstringNoชื่อประเภทการลา (อังกฤษ)
actual_leave[].actual_leave_idstringNoID การลาจริง (plain text)
actual_leave[].work_datestringNoวันที่ลา (YYYY-MM-DD)
actual_leave[].absence_daynumberNoจำนวนวันที่ลา (รองรับทศนิยม เช่น 0.5 = ครึ่งวัน)
actual_leave[].in_yearstringNoปีที่นับโควตา
actual_leave[].time_leave_descstringYesรายละเอียดการลา
actual_leave[].remarkstringYesหมายเหตุ

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_actual_leave&employee_code=EMP001&time_leave_flag=06&quota_year=2026&language_code=TH" \ -H "Ocp-Apim-Subscription-Key: YOUR_API_KEY"

Notes

  • absence_day รองรับทศนิยม เช่น 0.5 = ลาครึ่งวัน, 1 = ลา 1 วัน
  • in_year คือปีที่นับโควตา อาจไม่ตรงกับปีของ work_date ในบางกรณี
  • ข้อมูลเรียงตาม work_date จากใหม่ไปเก่า

Last updated on