Get List Resign (Filtered)

ดึงรายการเอกสารลาออกแบบมีเงื่อนไขการกรอง

ใช้ API นี้เพื่อดึงรายการเอกสารลาออกแบบมีเงื่อนไข รองรับการกรองตามพนักงาน โครงสร้างองค์กร ปี เดือน และสถานะเอกสาร โดยระบบจะใช้ช่วงวันที่จากรอบเงินเดือนจริงเพื่อให้สอดคล้องกับงวดเงินเดือน

Endpoint


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

Request Parameters

Optional Parameters

Parameter	Type	Required	Description	Example
`employee_lists`	array	No	กรองเฉพาะพนักงานที่ระบุ รูปแบบ `[{"id":"<base64_employee_id>"}]`	`[{"id":"QzAwMUVNUDAwMQ=="}]`
`year`	string	No	ปีที่ลาออก (YYYY)	`"2026"`
`month`	string	No	เดือนที่ลาออก (M หรือ MM)	`"03"`
`approve_flag`	string	No	กรองตามสถานะเอกสาร	`"01"`
`company_lists`	array	No	กรองตามบริษัท	`[]`
`branch_lists`	array	No	กรองตามสาขา	`[]`
`department_lists`	array	No	กรองตามแผนก	`[]`
`division_lists`	array	No	กรองตามฝ่าย	`[]`
`section_lists`	array	No	กรองตามส่วนงาน	`[]`
`section_lists_lv01`	array	No	กรองตาม Section Lv01	`[]`
`section_lists_lv02`	array	No	กรองตาม Section Lv02	`[]`
`section_lists_lv03`	array	No	กรองตาม Section Lv03	`[]`
`section_lists_lv04`	array	No	กรองตาม Section Lv04	`[]`
`section_lists_lv05`	array	No	กรองตาม Section Lv05	`[]`

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


{
  "employee_lists": [
    {"id": "QzAwMUVNUDAwMQ=="}
  ],
  "year": "2026",
  "month": "03",
  "approve_flag": "01"
}

Response Format

Success Response (HTTP 200)


{
  "code": 200,
  "message": "ดึงข้อมูลรายการสำเร็จ",
  "payload": [
    {
      "doc_type": "Resign",
      "doc_id": "20260330RDG00000001",
      "work_date": "2026-04-30",
      "header": "ขอลาออก",
      "detail": "วันที่มีผล 30 เม.ย. 2569",
      "status": "รออนุมัติ",
      "approve_flag": "01",
      "authorize_flag": false,
      "created": "2026-03-30 09:00:00",
      "created_format": "30/03/2026 09:00",
      "approve_by": "สมชาย ใจดี"
    }
  ]
}

Response Fields

Field	Type	Description
`doc_type`	string	ประเภทเอกสาร (`"Resign"`)
`doc_id`	string	รหัสเอกสารลาออก
`work_date`	string	วันที่มีผลการลาออก (YYYY-MM-DD)
`header`	string	หัวข้อเอกสาร
`detail`	string	รายละเอียดสรุปของเอกสาร
`status`	string	ป้ายสถานะ
`approve_flag`	string	รหัสสถานะย่อ (`01`/`02`/`03`)
`authorize_flag`	boolean	ผู้เรียกมีสิทธิ์อนุมัติเอกสารนี้หรือไม่
`created`	string	วันเวลาที่สร้าง
`created_format`	string	วันเวลาที่สร้าง (DD/MM/YYYY HH:mm)
`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-filter" \
  -H "Ocp-Apim-Subscription-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "year": "2026",
    "month": "03",
    "approve_flag": "01"
  }'

JavaScript


const response = await fetch(
  'https://openapi.humansoft.co.th/api/v1/open-apis/resign/get-list-filter',
  {
    method: 'GET',
    headers: {
      'Ocp-Apim-Subscription-Key': 'YOUR_API_KEY',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      year: '2026',
      month: '03',
      approve_flag: '01'
    })
  }
)
 
const data = await response.json()
 
if (data.code === 200) {
  data.payload.forEach(doc => {
    console.log('เอกสาร:', doc.doc_id)
    console.log('สถานะ:', doc.status)
    console.log('วันที่ลาออก:', doc.work_date)
  })
} else {
  console.error('Error:', data.errors || data.message)
}

Python


import requests
 
url = "https://openapi.humansoft.co.th/api/v1/open-apis/resign/get-list-filter"
headers = {
    "Ocp-Apim-Subscription-Key": "YOUR_API_KEY",
    "Content-Type": "application/json"
}
payload = {
    "year": "2026",
    "month": "03",
    "approve_flag": "01"
}
 
response = requests.get(url, headers=headers, json=payload)
data = response.json()
 
if data['code'] == 200:
    for doc in data['payload']:
        print(f"เอกสาร: {doc['doc_id']} สถานะ: {doc['status']}")
else:
    print('Error:', data.get('errors') or data.get('message'))

PHP


<?php
$url = "https://openapi.humansoft.co.th/api/v1/open-apis/resign/get-list-filter";
 
$headers = [
    "Ocp-Apim-Subscription-Key: YOUR_API_KEY",
    "Content-Type: application/json"
];
 
$payload = [
    "year" => "2026",
    "month" => "03",
    "approve_flag" => "01"
];
 
$ch = curl_init($url);
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($payload));
 
$response = curl_exec($ch);
$data = json_decode($response, true);
 
if ($data['code'] === 200) {
    foreach ($data['payload'] as $doc) {
        echo "เอกสาร: {$doc['doc_id']} สถานะ: {$doc['status']}\n";
    }
} else {
    echo "Error: " . ($data['errors'][0] ?? $data['message']);
}
 
curl_close($ch);
?>

Notes

ข้อควรทราบ:

ค่า approve_flag ในผลลัพธ์จะถูกย่อเหลือ 3 ค่าหลัก: 01 (รออนุมัติ), 02 (อนุมัติ), 03 (ไม่อนุมัติ)
หากต้องการกรองด้วย month ควรระบุ year มาด้วยเสมอ มิฉะนั้นระบบจะใช้ปีปัจจุบัน
เมื่อระบุ month ระบบจะใช้ช่วงวันที่ของรอบเงินเดือนจริงแทนวันปฏิทิน
employee_lists ใช้ employee_id ที่เข้ารหัส Base64

Get List - ดูรายการเอกสาร (HR/Manager)
Get Detail - ดูรายละเอียดเอกสารลาออก
Submit Resign - ยื่นเอกสารลาออกใหม่
Delete Resign - ลบเอกสารลาออก