Skip to Content
🚀 Welcome to Humansoft Open API Documentation

Get Default Quota

คำนวณโควตาการลาเริ่มต้นของพนักงานตามกฎธุรกิจที่ตั้งค่าไว้ในระบบ โดยไม่ดึงจากข้อมูลที่บันทึกแล้ว

Endpoint

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

Query Parameters

ParameterTypeRequiredDefaultDescriptionExample
path_actionstringYes-ต้องเป็น get_default_quota"get_default_quota"
employee_codestringYes-รหัสพนักงาน (plain text)"EMP001"
time_leave_flagstringYes-รหัสประเภทการลา (01-09)"06"
quota_yearstringNoปีปัจจุบันปีโควตา (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", "quota_year": "2026", "quota": "10", "unit": "วัน", "work_months": 18, "work_years": 1.5, "calculation_method": "by_work_year" } }

Response Fields

FieldTypeNullableDescription
employee_codestringNoรหัสพนักงาน
employee_namestringNoชื่อพนักงาน (ตาม language_code)
employee_last_namestringNoนามสกุลพนักงาน (ตาม language_code)
time_leave_flagstringNoรหัสประเภทการลา
time_leave_flag_namestringNoชื่อประเภทการลา (ไทย)
time_leave_flag_name_enstringNoชื่อประเภทการลา (อังกฤษ)
quota_yearstringNoปีโควตา (YYYY)
quotastringNoจำนวนโควตาที่คำนวณได้
unitstringNoหน่วย: "วัน" หรือ "ชั่วโมง"
work_monthsnumberYesจำนวนเดือนที่ทำงาน
work_yearsnumberYesจำนวนปีที่ทำงาน
calculation_methodstringYesวิธีคำนวณที่ใช้

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

Notes

  • API นี้คำนวณโควตาจากกฎธุรกิจที่ตั้งค่าไว้ในระบบ ไม่ได้ดึงจากข้อมูลที่บันทึกแล้ว
  • ใช้สำหรับดูว่าพนักงานควรได้โควตาเท่าไหร่ก่อนบันทึก
  • work_months และ work_years คำนวณจากวันเริ่มงานของพนักงาน
  • ผลลัพธ์อาจแตกต่างจากโควตาที่บันทึกจริง ถ้ามีการปรับโควตาด้วยมือ

  • Get Quota by Employee - ดูโควตาที่บันทึกจริง
  • Save Quota - บันทึกโควตา (ใช้ค่าจาก API นี้เป็นค่าเริ่มต้น)
  • Get Leave Types - ดูประเภทการลาที่ใช้งานได้ (สำหรับเลือก time_leave_flag)
Last updated on