Skip to Content
🚀 Welcome to Humansoft Open API Documentation

Get List Resign

ดึงรายการเอกสารลาออกสำหรับ HR และผู้จัดการตามสายการบังคับบัญชา

ใช้ API นี้สำหรับ HR หรือผู้จัดการดึงรายการเอกสารลาออกของพนักงาน สามารถกรองตามปี เดือน สถานะ และรายชื่อพนักงานได้ ข้อมูลจะถูกจัดกลุ่มตามพนักงาน

Endpoint

GET /api/v1/open-apis/resign/get-list

Request Parameters

Optional Parameters

ParameterTypeRequiredDescriptionExample
authorize_linebooleanNotrue = แสดงเฉพาะสายอนุมัติของตัวเอง, false = HR/Admin mode (ค่าเริ่มต้น false)true
employee_listsarrayNoกรองเฉพาะพนักงานที่ระบุ รูปแบบ [{"id": "<base64_employee_id>"}][{"id": "Q0..."}]
yearstringNoปีที่ลาออก (YYYY)"2026"
monthstringNoเดือนที่ลาออก (M หรือ MM)"03"
approve_flagstringNoกรองตามสถานะเอกสาร"01"

Option Values: approve_flag (สถานะที่ใช้กรอง)

CodeEnglishภาษาไทยหมายเหตุ
01Pendingรออนุมัติกรองเอกสารที่ approve_flag อยู่ใน 01,04,05,06,07,08
02Approvedอนุมัติแล้วapprove_flag=02 และ hr_approve_flag=N
03Not Approvedไม่อนุมัติapprove_flag=03 และ hr_approve_flag=N
05Recheckตรวจสอบอีกครั้งapprove_flag=05 และ hr_approve_flag=N
YHR ConfirmedHR ยืนยันลาออกแล้วhr_approve_flag=Y
CCancelledยกเลิกการลาออก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

FieldTypeDescription
profileobjectข้อมูลพนักงานเจ้าของเอกสาร
profile.employee_codestringรหัสพนักงาน
profile.employee_namestringชื่อพนักงาน
profile.employee_last_namestringนามสกุลพนักงาน
profile.position_namestringตำแหน่ง
profile.department_namestringแผนก
profile.count_docsnumberจำนวนเอกสารลาออกของพนักงาน
docs.resignarrayรายการเอกสารลาออก
docs.resign[].doc_idstringรหัสเอกสารลาออก
docs.resign[].work_datestringวันที่มีผลการลาออก
docs.resign[].statusstringป้ายสถานะ
docs.resign[].approve_flagstringรหัสสถานะย่อ
docs.resign[].authorize_flagbooleanผู้เรียกมีสิทธิ์อนุมัติเอกสารนี้หรือไม่
docs.resign[].approve_bystringชื่อผู้ดำเนินการล่าสุด

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 -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
  • Get List Filter - ดูรายการเอกสารแบบมีเงื่อนไขกรอง
  • Get Detail - ดูรายละเอียดเอกสารลาออก
  • Approve Resign - อนุมัติเอกสาร
Last updated on