Delete Leave
ลบคำขอลา
ใช้ API นี้เพื่อลบคำขอลาที่ยื่นผิดพลาดหรือไม่ต้องการแล้ว ระบบจะทำการลบข้อมูล
Endpoint
POST /api/v1/open-apis/time-leave/deleteRequest Parameters
| Parameter | Type | Required | Description | Example |
|---|---|---|---|---|
time_leave_id | string | Yes | ID ของคำขอที่ต้องการลบ | VExWMDAxMjM= |
Request Body Example
{
"time_leave_id": "VExWMDAxMjM="
}Response Format
Success Response (HTTP 200)
{
"code": 200,
"message": "ลบเอกสารสำเร็จ",
"payload": {
"time_leave_id": "VExWMDAxMjM="
}
}Error Response - Not Found (HTTP 400)
{
"code": 400,
"message": "ไม่สำเร็จ",
"error": "Time leave record not found"
}Error Response - Already Deleted (HTTP 400)
{
"code": 400,
"message": "ไม่สำเร็จ",
"error": "Time leave record already deleted"
}Error Response - Salary Period Closed (HTTP 400)
{
"code": 400,
"message": "ไม่สำเร็จ",
"error": "ไม่สามารถลบได้ งวดเงินเดือนปิดแล้ว"
}Response Fields
| Field | Type | Description |
|---|---|---|
time_leave_id | string | ID ของคำขอที่ลบ |
Code Examples
cURL
curl -X POST "https://openapi.humansoft.co.th/api/v1/open-apis/time-leave/delete" \
-H "Ocp-Apim-Subscription-Key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"time_leave_id": "VExWMDAxMjM="
}'Validation Rules
| Parameter | Validation | Error Message |
|---|---|---|
time_leave_id | ต้องระบุและเป็น string | Missing required parameter: 'time_leave_id' |
Business Rules
ข้อจำกัดการลบ:
- ไม่สามารถลบคำขอที่ลบไปแล้ว
- ไม่สามารถลบในงวดเงินเดือนที่ปิดแล้ว
- การลบคำขอจะเปลี่ยนสถานะข้อมูล สามารถตรวจสอบผลลัพธ์ได้จาก response
- Feed และ notifications ที่เกี่ยวข้องจะถูกลบด้วย
Error Handling
| Error | Cause | Solution |
|---|---|---|
Missing required parameter: 'time_leave_id' | ไม่ได้ส่ง time_leave_id | ตรวจสอบ request body |
Time leave record not found | ไม่พบคำขอ | ตรวจสอบ time_leave_id |
Time leave record already deleted | คำขอถูกลบไปแล้ว | ไม่ต้องดำเนินการ |
ไม่สามารถลบได้ งวดเงินเดือนปิดแล้ว | งวดเงินเดือนปิดแล้ว | ติดต่อ HR |
Notes
Use Cases
- ยกเลิกคำขอผิดพลาด - ลบคำขอที่ยื่นผิดวันหรือผิดประเภท
- ทำความสะอาดข้อมูล - ลบคำขอที่ไม่ต้องการแล้ว
- แก้ไขข้อมูล - ลบคำขอเดิมก่อนสร้างใหม่ (กรณีไม่สามารถ update ได้)
Related APIs
- Get Leave List - ดึงรายการคำขอลา
- Submit Leave - ยื่นคำขอลาใหม่
- Update Leave - แก้ไขคำขอลา
Last updated on