Add Actual Leave
เพิ่มบันทึกการลาจริงของพนักงาน ระบบจะหักโควตาอัตโนมัติตามจำนวนวันที่ลา
Endpoint
POST /api/v1/open-apis/salary/add-data-filterRequest Body
| Parameter | Type | Required | Description | Example |
|---|---|---|---|---|
path_action | string | Yes | ต้องเป็น add_actual_leave | "add_actual_leave" |
employee_code | string | Yes | รหัสพนักงาน (plain text) | "EMP001" |
work_date | string | Yes | วันที่ลา (YYYY-MM-DD) | "2026-03-15" |
time_leave_flag | string | Yes | รหัสประเภทการลา (01-09) | "06" |
absence_day | number | Yes | จำนวนวันที่ลา (รองรับทศนิยม) | 1, 0.5 |
in_year | string | No | ปีที่นับโควตา (YYYY) ถ้าไม่ระบุจะใช้ปีจาก work_date | "2026" |
absence_sum_time | string | No | ชั่วโมงรวม (สำหรับหน่วยชั่วโมง) | "4:00" |
time_leave_desc | string | No | รายละเอียดการลา | "ลาพักร้อนประจำปี" |
remark | string | No | หมายเหตุ | "ธุระส่วนตัว" |
language_code | string | No | ภาษาสำหรับแสดงผล | "TH", "EN" |
ระบบจะตรวจสอบโควตาคงเหลือก่อนบันทึก ถ้าโควตาไม่เพียงพอจะได้ Error 400
Response Format
Success Response
{
"code": 200,
"message": "สำเร็จ",
"payload": {
"actual_leave_id": "20260315AL01A2B3C4D5",
"time_leave_log_id": "20260315TL01A2B3C4D5",
"employee_code": "EMP001",
"work_date": "2026-03-15",
"time_leave_flag": "06",
"absence_day": 1,
"in_year": "2026",
"time_leave_flag_name": "ลาพักร้อน",
"quota_before": 7.5,
"quota_after": 6.5,
"created": "2026-03-15 10:30:00"
}
}Response Fields
| Field | Type | Description |
|---|---|---|
actual_leave_id | string | ID การลาจริง (plain text) |
time_leave_log_id | string | ID บันทึกการลา (plain text) |
employee_code | string | รหัสพนักงาน |
work_date | string | วันที่ลา |
time_leave_flag | string | รหัสประเภทการลา |
absence_day | number | จำนวนวันที่ลา |
in_year | string | ปีที่นับโควตา |
time_leave_flag_name | string | ชื่อประเภทการลา |
quota_before | number | โควตาคงเหลือก่อนบันทึก |
quota_after | number | โควตาคงเหลือหลังบันทึก |
created | string | วันเวลาที่สร้างรายการ (YYYY-MM-DD HH:mm:ss) |
Error Response
{
"code": 400,
"message": "ไม่สำเร็จ",
"errors": ["Insufficient quota for leave type 06"]
}Code Examples
cURL
curl -X POST "https://openapi.humansoft.co.th/api/v1/open-apis/salary/add-data-filter" \
-H "Ocp-Apim-Subscription-Key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"path_action": "add_actual_leave",
"employee_code": "EMP001",
"work_date": "2026-03-15",
"time_leave_flag": "06",
"absence_day": 1,
"time_leave_desc": "ลาพักร้อนประจำปี"
}'Notes
absence_dayรองรับทศนิยม:0.5= ครึ่งวัน,1= เต็มวัน- ระบบหักโควตาอัตโนมัติ ดู
quota_beforeและquota_afterเพื่อตรวจสอบ - ถ้าไม่ระบุ
in_yearระบบจะใช้ปีจากwork_date actual_leave_idและtime_leave_log_idใช้อ้างอิงสำหรับแก้ไข/ลบภายหลัง
Related APIs
- Get Actual Leave - ดูประวัติการลาจริง
- Update Actual Leave - แก้ไขปีที่นับโควตา
- Delete Actual Leave - ลบบันทึกการลา (คืนโควตา)
- Get Quota by Employee - ดูโควตาคงเหลือ
Last updated on