Approve Resign

อนุมัติ ปฏิเสธ หรือเปลี่ยนสถานะการไหลเวียนของเอกสารลาออก

ใช้ API นี้เพื่อดำเนินการอนุมัติเอกสารลาออก ผู้อนุมัติสามารถเลือกอนุมัติ (Approve) ไม่อนุมัติ (Reject) หรือส่งกลับเพื่อตรวจสอบอีกครั้ง (Recheck) ได้

Endpoint


POST /api/v1/open-apis/resign/approve

Request Parameters

Required Parameters

Parameter	Type	Required	Description	Example
`resign_doc_id`	string (base64)	Yes	รหัสเอกสารที่ต้องการดำเนินการ (เข้ารหัส Base64)	`"MjAyNjAzMzBSREcwMDAwMDAwMQ=="`
`approve_flag`	string	Yes	สถานะใหม่ที่ต้องการเปลี่ยน	`"02"`
`employee_code`	string	Yes	รหัสพนักงานของผู้ยื่นขอลาออก	`"EMP001"`
`resign_doc_dt`	string	Yes	วันที่ขอลาออก (YYYY-MM-DD)	`"2026-03-30"`
`authorize_id`	string (base64)	Yes	ID ของผู้ดำเนินการอนุมัติ (เข้ารหัส Base64)	`"QXBwcm92ZXIwMQ=="`

Optional Parameters

Parameter	Type	Required	Description	Example
`authorize_line`	string	No	ตรวจสอบตามสายการบังคับบัญชา (`"true"` หรือ `"false"`)	`"true"`

Option Values: `approve_flag`

Code	English	ภาษาไทย	Description
`01`	Pending	รออนุมัติ	ยื่นเรื่องใหม่ หรือกำลังรอการพิจารณา
`02`	Approved	อนุมัติ	อนุมัติแบบสมบูรณ์
`03`	Not Approved	ไม่อนุมัติ	ถูกปฏิเสธคำขอ
`04`	Manager Approved Level 1	หัวหน้าอนุมัติลำดับที่ 1	ผ่านการอนุมัติโดยหัวหน้าลำดับที่ 1
`05`	Recheck	ตรวจสอบอีกครั้ง	ส่งเอกสารกลับไปตรวจสอบ
`06`	Manager Approved Level 2	หัวหน้าอนุมัติลำดับที่ 2	ผ่านการอนุมัติโดยหัวหน้าลำดับที่ 2
`07`	Manager Approved Level 3	หัวหน้าอนุมัติลำดับที่ 3	ผ่านการอนุมัติโดยหัวหน้าลำดับที่ 3
`08`	Manager Approved Level 4	หัวหน้าอนุมัติลำดับที่ 4	ผ่านการอนุมัติโดยหัวหน้าลำดับที่ 4
`09`	Manager Approved Level 5	หัวหน้าอนุมัติลำดับที่ 5	ผ่านการอนุมัติโดยหัวหน้าลำดับที่ 5

Request Body Example


{
  "resign_doc_id": "MjAyNjAzMzBSREcwMDAwMDAwMQ==",
  "approve_flag": "02",
  "employee_code": "EMP001",
  "resign_doc_dt": "2026-03-30",
  "authorize_id": "QXBwcm92ZXIwMQ==",
  "authorize_line": "true"
}

Response Format

Success Response (HTTP 200)


{
  "code": 200,
  "message": "อนุมัติเรียบร้อยแล้ว",
  "payload": {
    "resign_doc_id": "MjAyNjAzMzBSREcwMDAwMDAwMQ==",
    "approve_flag": "02",
    "hr_approve_flag": "N",
    "resign_doc_dt": "2026-03-30"
  }
}

Response Fields

Field	Type	Description
`resign_doc_id`	string	รหัสเอกสารลาออก
`approve_flag`	string	สถานะเอกสารที่อัปเดตแล้ว
`hr_approve_flag`	string	สถานะ HR (`N`/`Y`/`C`)
`resign_doc_dt`	string	วันที่ขอลาออก

Error Response - Validation Failed (HTTP 422)


{
  "code": 422,
  "message": "Validation failed",
  "errors": [
    "'employee_code' is required",
    "'resign_doc_id' is required"
  ]
}

Error Response - Payroll Period Closed (HTTP 400)


{
  "code": 400,
  "message": "การดำเนินการนี้ไม่สามารถทำได้ เนื่องจากอยู่ในรอบเงินเดือนที่ประมวลผลเสร็จสิ้นแล้ว"
}

Error Response - Not Found (HTTP 404)


{
  "code": 404,
  "message": "ไม่พบข้อมูล"
}

Code Examples

cURL


curl -X POST "https://openapi.humansoft.co.th/api/v1/open-apis/resign/approve" \
  -H "Ocp-Apim-Subscription-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "resign_doc_id": "MjAyNjAzMzBSREcwMDAwMDAwMQ==",
    "approve_flag": "02",
    "employee_code": "EMP001",
    "resign_doc_dt": "2026-03-30",
    "authorize_id": "QXBwcm92ZXIwMQ==",
    "authorize_line": "true"
  }'

JavaScript


const response = await fetch(
  'https://openapi.humansoft.co.th/api/v1/open-apis/resign/approve',
  {
    method: 'POST',
    headers: {
      'Ocp-Apim-Subscription-Key': 'YOUR_API_KEY',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      resign_doc_id: 'MjAyNjAzMzBSREcwMDAwMDAwMQ==',
      approve_flag: '02',
      employee_code: 'EMP001',
      resign_doc_dt: '2026-03-30',
      authorize_id: 'QXBwcm92ZXIwMQ==',
      authorize_line: 'true'
    })
  }
)
 
const data = await response.json()
 
if (data.code === 200) {
  console.log('อนุมัติสำเร็จ:', data.payload.resign_doc_id)
  console.log('สถานะ:', data.payload.approve_flag)
} else {
  console.error('Error:', data.errors || data.message)
}

Python


import requests
 
url = "https://openapi.humansoft.co.th/api/v1/open-apis/resign/approve"
headers = {
    "Ocp-Apim-Subscription-Key": "YOUR_API_KEY",
    "Content-Type": "application/json"
}
payload = {
    "resign_doc_id": "MjAyNjAzMzBSREcwMDAwMDAwMQ==",
    "approve_flag": "02",
    "employee_code": "EMP001",
    "resign_doc_dt": "2026-03-30",
    "authorize_id": "QXBwcm92ZXIwMQ==",
    "authorize_line": "true"
}
 
response = requests.post(url, headers=headers, json=payload)
data = response.json()
 
if data['code'] == 200:
    print('อนุมัติสำเร็จ:', data['payload']['resign_doc_id'])
else:
    print('Error:', data.get('errors') or data.get('message'))

PHP


<?php
$url = "https://openapi.humansoft.co.th/api/v1/open-apis/resign/approve";
 
$headers = [
    "Ocp-Apim-Subscription-Key: YOUR_API_KEY",
    "Content-Type: application/json"
];
 
$payload = [
    "resign_doc_id" => "MjAyNjAzMzBSREcwMDAwMDAwMQ==",
    "approve_flag" => "02",
    "employee_code" => "EMP001",
    "resign_doc_dt" => "2026-03-30",
    "authorize_id" => "QXBwcm92ZXIwMQ==",
    "authorize_line" => "true"
];
 
$ch = curl_init($url);
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($payload));
 
$response = curl_exec($ch);
$data = json_decode($response, true);
 
if ($data['code'] === 200) {
    echo "อนุมัติสำเร็จ: " . $data['payload']['resign_doc_id'] . "\n";
    echo "สถานะ: " . $data['payload']['approve_flag'];
} else {
    echo "Error: " . ($data['errors'][0] ?? $data['message']);
}
 
curl_close($ch);
?>

Notes

ข้อควรทราบ:

สถานะที่ได้รับคืน (approve_flag) อาจกระโดดข้ามระดับ หากผู้อนุมัติเป็นหัวหน้าลำดับที่สูงกว่าตาม Workflow ขององค์กร
สถานะ HR (hr_approve_flag) จะถูกรีเซ็ตเป็น N อัตโนมัติเมื่อสถานะเป็น Recheck (05)
วันที่ขอลาออก (resign_doc_dt) ต้องไม่อยู่ในงวดเงินเดือนที่ปิดแล้ว
พารามิเตอร์ resign_doc_id และ authorize_id ต้องเข้ารหัส Base64 ก่อนส่ง

Submit Resign - ยื่นเอกสารลาออกใหม่
HR Approve - HR ยืนยันการลาออก
Get Detail - ดูรายละเอียดเอกสารลาออก