Delete Actual Leave

ลบรายการลาจริงของพนักงาน ระบบจะคำนวณยอดลาที่ใช้ไปในโควตาใหม่อัตโนมัติ

การลบข้อมูลไม่สามารถกู้คืนได้ กรุณาตรวจสอบให้แน่ใจก่อนดำเนินการ

Endpoint


POST /api/v1/open-apis/employee/delete-employee-setting?path_action=actual-quota

สิทธิ์ที่ต้องการ: API Key ต้องมีสิทธิ์ ข้อมูลพนักงานพื้นฐาน (employee:read:basic)

Query Parameters

Parameter	Type	Required	Description
`path_action`	string	Yes	ต้องเป็น `actual-quota`

Request Body

Parameter	Type	Required	Description
`time_leave_log_id`	string	Yes	ID ของรายการลาจริงที่ต้องการลบ (Base64)

time_leave_log_id ได้จาก response ของ Add Actual Leave ซึ่งเป็นค่า raw — ต้องแปลงเป็น Base64 ก่อนส่ง
หรือดูรายการลาจริงทั้งหมดได้จาก Get Actual Leave (ต้องมีสิทธิ์ payroll:read:self)

Example Request


{
  "time_leave_log_id": "MjAyNTExMjdENDU3M0M0MjE2Mzk="
}

Response Format

Success Response

payload คือข้อมูลของรายการลาจริงที่ถูกลบ


{
  "code": 200,
  "message": "Delete Actual Leave Success",
  "payload": {
    "time_leave_log_id": "20251127D4573C421639",
    "time_leave_source": "Manual",
    "employee_id": "20250101A1B2C3D4E5F6",
    "work_date": "2026-06-15",
    "in_year": "2026",
    "absence_flag_lv": "03",
    "absence_day": "1",
    "absence_sum_time": "08:00:00",
    "time_leave_desc": "ป่วยไข้หวัด"
  }
}

Response Fields

Field	Type	Description
`time_leave_log_id`	string	ID ของรายการลาจริงที่ถูกลบ
`time_leave_source`	string	แหล่งที่มาของรายการ เช่น `Manual`
`employee_id`	string	ID ของพนักงาน
`work_date`	string	วันที่ลา (`YYYY-MM-DD`)
`in_year`	string	ปีโควตาที่หัก (ค.ศ.)
`absence_flag_lv`	string	รหัสประเภทการลา
`absence_day`	string	จำนวนวันลา
`absence_sum_time`	string	เวลาลารวม `HH:MM:SS`
`time_leave_desc`	string/null	หมายเหตุการลา

Error Response

ไม่ส่ง time_leave_log_id


{
  "code": 400,
  "message": "ข้อมูลไม่ถูกต้อง",
  "errors": [
    "กรุณาระบุ 'time_leave_log_id'"
  ]
}

ไม่พบรายการลาจริง


{
  "code": 400,
  "message": "Actual leave record not found"
}

เงื่อนไข	Error Message
ไม่ส่ง `time_leave_log_id` หรือส่งค่าว่าง	`กรุณาระบุ 'time_leave_log_id'` (ใน `errors`)
ไม่พบรายการตาม `time_leave_log_id` (รวมถึงกรณีส่ง ID ที่ไม่ได้แปลงเป็น Base64)	`Actual leave record not found` (ใน `message`)

Code Examples

cURL


curl -X POST "https://openapi.humansoft.co.th/api/v1/open-apis/employee/delete-employee-setting?path_action=actual-quota" \
  -H "Content-Type: application/json" \
  -H "Ocp-Apim-Subscription-Key: YOUR_API_KEY" \
  -d '{
    "time_leave_log_id": "MjAyNTExMjdENDU3M0M0MjE2Mzk="
  }'

JavaScript


const response = await fetch(
  'https://openapi.humansoft.co.th/api/v1/open-apis/employee/delete-employee-setting?path_action=actual-quota',
  {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'Ocp-Apim-Subscription-Key': 'YOUR_API_KEY'
    },
    body: JSON.stringify({
      time_leave_log_id: 'MjAyNTExMjdENDU3M0M0MjE2Mzk='
    })
  }
)
const data = await response.json()
console.log(data.message, data.payload.work_date)

Python


import requests
 
url = "https://openapi.humansoft.co.th/api/v1/open-apis/employee/delete-employee-setting"
headers = {
    "Content-Type": "application/json",
    "Ocp-Apim-Subscription-Key": "YOUR_API_KEY"
}
params = {"path_action": "actual-quota"}
body = {
    "time_leave_log_id": "MjAyNTExMjdENDU3M0M0MjE2Mzk="
}
 
response = requests.post(url, headers=headers, params=params, json=body)
data = response.json()
print(data["message"], data["payload"]["work_date"])

PHP


<?php
$url = "https://openapi.humansoft.co.th/api/v1/open-apis/employee/delete-employee-setting?path_action=actual-quota";
 
$body = [
    "time_leave_log_id" => "MjAyNTExMjdENDU3M0M0MjE2Mzk="
];
 
$ch = curl_init($url);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($body));
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    "Content-Type: application/json",
    "Ocp-Apim-Subscription-Key: YOUR_API_KEY"
]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
 
$response = curl_exec($ch);
curl_close($ch);
 
$data = json_decode($response, true);
echo $data["message"] . " " . $data["payload"]["work_date"] . "\n";
?>

Notes

หลังลบ ระบบจะคำนวณยอดลาที่ใช้ไปของประเภทการลาและปีนั้นใหม่อัตโนมัติ (ยอดโควตาคงเหลือจะเพิ่มขึ้นตามรายการที่ลบ) ดูผลได้จาก Get Quota

Get Quota - ดึงข้อมูลโควตาการลา
Update Quota - บันทึกโควตาการลา
Add Actual Leave - เพิ่มรายการลาจริง