Add Actual Leave
เพิ่มยอดลาจริงของพนักงาน (ยอดลาจริงคือการบันทึกการลาที่เกิดขึ้นจริงเพื่อหักจากโควตา)
Endpoint
POST /api/v1/open-apis/employee/add-employee-setting?path_action=quota-actual-leaveQuery Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
path_action | string | Yes | ต้องเป็น quota-actual-leave |
Request Body
| Parameter | Type | Required | Description |
|---|---|---|---|
employee_code | string | Yes | รหัสพนักงาน |
leave_type_id | string | Yes | ID ของประเภทการลา |
leave_date | string | Yes | วันที่ลา (รูปแบบ: YYYY-MM-DD) |
leave_days | number | Yes | จำนวนวันลา (เช่น 1, 0.5) |
ใช้ employee_code เพื่อระบุพนักงาน
Response Format
Success Response
{
"code": 200,
"message": "Add Actual Leave Success",
"payload": {
"actual_leave_id": "20260121AQ01A2B3C4D5",
"employee_id": "20260121EM01A2B3C4D5",
"leave_type_id": "20260121LT01A2B3C4D5",
"leave_type_name": "ลาป่วย",
"leave_date": "2567-03-15",
"leave_days": 1
}
}Response Fields
| Field | Type | Description |
|---|---|---|
actual_leave_id | string | ID ของยอดลาจริงที่สร้าง |
employee_id | string | ID ของพนักงาน |
leave_type_id | string | ID ของประเภทการลา |
leave_type_name | string | ชื่อประเภทการลา |
leave_date | string | วันที่ลา |
leave_days | number | จำนวนวันลา |
Error Response
{
"code": 400,
"message": "ไม่สำเร็จ",
"errors": [
"Missing required parameter: 'leave_date'",
"Missing required parameter: 'leave_days'"
]
}Validation Rules
| Field | Rule |
|---|---|
employee_code | ต้องระบุและต้องมีพนักงานในระบบ |
leave_type_id | ต้องระบุและต้องเป็นประเภทการลาที่มีอยู่ในระบบ |
leave_date | ต้องระบุในรูปแบบ YYYY-MM-DD |
leave_days | ต้องเป็นตัวเลขมากกว่า 0 (รองรับทศนิยม เช่น 0.5 สำหรับลาครึ่งวัน) |
Code Examples
cURL
curl -X POST "https://openapi.humansoft.co.th/api/v1/open-apis/employee/add-employee-setting?path_action=quota-actual-leave" \
-H "Content-Type: application/json" \
-H "Ocp-Apim-Subscription-Key: YOUR_API_KEY" \
-d '{
"employee_code": "EMP001",
"leave_type_id": "MjAyNjAxMjFMVDAxQTJCM0M0RDU=",
"leave_date": "2567-03-15",
"leave_days": 1
}'Notes
- ยอดลาจริงจะถูกหักจากโควตาการลาโดยอัตโนมัติ
- สามารถระบุลาครึ่งวันได้ โดยใช้
leave_days: 0.5 - ระบบจะเก็บ
actual_leave_idสำหรับใช้อ้างอิงในการลบภายหลัง
Related APIs
- Get Quota - ดึงข้อมูลโควตาการลา
- Update Quota - แก้ไขโควตาการลา
- Delete Actual Leave - ลบยอดลาจริง
Last updated on