Get List Resign
ดึงรายการเอกสารลาออกสำหรับ HR และผู้จัดการตามสายการบังคับบัญชา
ใช้ API นี้สำหรับ HR หรือผู้จัดการดึงรายการเอกสารลาออกของพนักงาน สามารถกรองตามปี เดือน สถานะ และรายชื่อพนักงานได้ ข้อมูลจะถูกจัดกลุ่มตามพนักงาน
Endpoint
GET /api/v1/open-apis/resign/get-listRequest Parameters
Optional Parameters
| Parameter | Type | Required | Description | Example |
|---|---|---|---|---|
authorize_line | boolean | No | true = แสดงเฉพาะสายอนุมัติของตัวเอง, false = HR/Admin mode (ค่าเริ่มต้น false) | true |
employee_lists | array | No | กรองเฉพาะพนักงานที่ระบุ รูปแบบ [{"id": "<base64_employee_id>"}] | [{"id": "Q0..."}] |
year | string | No | ปีที่ลาออก (YYYY) | "2026" |
month | string | No | เดือนที่ลาออก (M หรือ MM) | "03" |
approve_flag | string | No | กรองตามสถานะเอกสาร | "01" |
Option Values: approve_flag (สถานะที่ใช้กรอง)
| Code | English | ภาษาไทย | หมายเหตุ |
|---|---|---|---|
01 | Pending | รออนุมัติ | กรองเอกสารที่ approve_flag อยู่ใน 01,04,05,06,07,08 |
02 | Approved | อนุมัติแล้ว | approve_flag=02 และ hr_approve_flag=N |
03 | Not Approved | ไม่อนุมัติ | approve_flag=03 และ hr_approve_flag=N |
05 | Recheck | ตรวจสอบอีกครั้ง | approve_flag=05 และ hr_approve_flag=N |
Y | HR Confirmed | HR ยืนยันลาออกแล้ว | hr_approve_flag=Y |
C | Cancelled | ยกเลิกการลาออก | hr_approve_flag=C |
Request Body Example
{
"authorize_line": false,
"year": "2026",
"month": "03",
"approve_flag": "01"
}Response Format
Success Response (HTTP 200)
{
"code": 200,
"message": "ดึงข้อมูลรายการสำเร็จ",
"payload": [
{
"profile": {
"employee_code": "EMP001",
"photograph": "images/emp001.jpg",
"employee_name": "สมชาย",
"employee_last_name": "ใจดี",
"employee_nickname": "ชาย",
"position_name": "พนักงานขาย",
"department_name": "ฝ่ายขาย",
"division_name": "สำนักงานใหญ่",
"count_docs": 1
},
"docs": {
"resign": [
{
"doc_type": "Resign",
"doc_id": "20260330RDG00000001",
"work_date": "2026-04-30",
"header": "ขอลาออก",
"detail": "วันที่มีผล 30 เม.ย. 2569",
"status": "รออนุมัติ",
"approve_flag": "01",
"authorize_flag": true,
"created": "2026-03-30 09:00:00",
"created_format": "30/03/2026 09:00",
"approve_by": "สมศักดิ์ ดีมาก"
}
]
}
}
]
}Response Fields
| Field | Type | Description |
|---|---|---|
profile | object | ข้อมูลพนักงานเจ้าของเอกสาร |
profile.employee_code | string | รหัสพนักงาน |
profile.employee_name | string | ชื่อพนักงาน |
profile.employee_last_name | string | นามสกุลพนักงาน |
profile.position_name | string | ตำแหน่ง |
profile.department_name | string | แผนก |
profile.count_docs | number | จำนวนเอกสารลาออกของพนักงาน |
docs.resign | array | รายการเอกสารลาออก |
docs.resign[].doc_id | string | รหัสเอกสารลาออก |
docs.resign[].work_date | string | วันที่มีผลการลาออก |
docs.resign[].status | string | ป้ายสถานะ |
docs.resign[].approve_flag | string | รหัสสถานะย่อ |
docs.resign[].authorize_flag | boolean | ผู้เรียกมีสิทธิ์อนุมัติเอกสารนี้หรือไม่ |
docs.resign[].approve_by | string | ชื่อผู้ดำเนินการล่าสุด |
Error Response - Validation Failed (HTTP 422)
{
"code": 422,
"message": "Validation failed",
"errors": ["'year' must be YYYY"]
}Error Response - Server Error (HTTP 400)
{
"code": 400,
"message": "เกิดข้อผิดพลาดในการดึงข้อมูล"
}Code Examples
cURL
curl -X GET "https://openapi.humansoft.co.th/api/v1/open-apis/resign/get-list" \
-H "Ocp-Apim-Subscription-Key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"authorize_line": true,
"year": "2026",
"month": "03",
"approve_flag": "01"
}'Notes
ข้อควรทราบ:
- ค่า
approve_flagในผลลัพธ์จะถูกย่อเหลือ01(Pending),02(Approved),03(Not Approved) เพื่อความง่ายในการแสดงผล - หาก
authorize_line = trueและผู้เรียกไม่มีพนักงานในสาย จะได้รับผลลัพธ์เป็น array ว่าง employee_listsใช้employee_idที่เข้ารหัส Base64
Related APIs
- Get List Filter - ดูรายการเอกสารแบบมีเงื่อนไขกรอง
- Get Detail - ดูรายละเอียดเอกสารลาออก
- Approve Resign - อนุมัติเอกสาร
Last updated on