HR Approve Resign
HR ยืนยันการลาออกและอัปเดตข้อมูลพนักงานในระบบ
ใช้ API นี้สำหรับ HR ดำเนินการยืนยันหรือยกเลิกการลาออกของพนักงาน เมื่อ hr_approve_flag = "Y" ระบบจะเปลี่ยนสถานะพนักงาน จัดการงวดเงินเดือน และลบสลิปเงินเดือนล่วงหน้าที่ยังไม่ถึงงวดอัตโนมัติ
Endpoint
POST /api/v1/open-apis/resign/hr-approveRequest Parameters
Required Parameters
| Parameter | Type | Required | Description | Example |
|---|---|---|---|---|
resign_doc_id | string (base64) | Yes | รหัสเอกสารลาออก (เข้ารหัส Base64) | "MjAyNjAzMzBSREcwMDAwMDAwMQ==" |
resign_doc_dt | string | Yes | วันที่มีผลการลาออก (YYYY-MM-DD) | "2026-04-30" |
employee_code | string | Yes | รหัสพนักงาน | "EMP001" |
hr_approve_flag | string | Yes | การตัดสินใจของ HR (Y, N, C) | "Y" |
authorize_id | string (base64) | Yes | ID ของผู้ดำเนินการ (เข้ารหัส Base64) | "SFIwMDEwMQ==" |
signout_type_flag | string | Yes* | ประเภทการสิ้นสุดการจ้างงาน (*บังคับเมื่อ hr_approve_flag = "Y") | "01" |
Optional Parameters
| Parameter | Type | Required | Description | Example |
|---|---|---|---|---|
sso_out_dt | string | No | วันที่สิ้นสุดสิทธิ์ประกันสังคม (YYYY-MM-DD) ค่าเริ่มต้นเท่ากับ resign_doc_dt | "2026-05-31" |
blacklist_flag | string | No | บันทึก Blacklist ("Y" หรือ "N") | "N" |
retire_with_compensation | string | No | ได้รับเงินชดเชยหรือไม่ | "Y" |
retirement_year | string | No | จำนวนปีสำหรับคำนวณเงินชดเชย | "10" |
resign_doc_remark | string | No | หมายเหตุเพิ่มเติม | "ลาออกด้วยความสมัครใจ" |
signout_fund_dt | string | No | วันที่สิ้นสุดกองทุน (YYYY-MM-DD) | "2026-04-30" |
severance_pay_extra | number | No | จำนวนเดือนที่จ่ายชดเชยเพิ่ม (เงินค่าตกใจ) | 1 |
tax_calculation_type_lv | string | No | ประเภทการคำนวณภาษี (01 ภงด หรือ 02 ใบแนบ) | "01" |
compensation_flag | string | No | สถานะการจ่ายเงินชดเชย ("Y" หรือ "N") | "Y" |
retirement_severance_flag | string | No | สถานะชดเชยเกษียณ ("Y" หรือ "N") | "Y" |
use_app_dt | string | No | วันที่ให้พนักงานหยุดใช้งานแอปพลิเคชัน (YYYY-MM-DD) | "2026-04-30" |
hr_remark | string | No | หมายเหตุสำหรับ HR | "พนักงานโอนย้ายบริษัท" |
approve_flag | string | No | สถานะการอนุมัติปัจจุบัน สำหรับบันทึก Activity Log | "02" |
Option Values: hr_approve_flag
| Code | English | ภาษาไทย | ผลกระทบต่อระบบ |
|---|---|---|---|
Y | HR Approved | HR อนุมัติยืนยัน | อัปเดตข้อมูลพนักงาน จัดการงวดเงินเดือน ลบสลิปอนาคต |
N | Pending HR | รอการพิจารณา | อัปเดตสถานะเอกสารเท่านั้น ไม่มีผลต่อข้อมูลพนักงาน |
C | Cancelled | ยกเลิกการลาออก | อัปเดตสถานะเอกสารเป็นยกเลิก |
Option Values: signout_type_flag
| Code | English | ภาษาไทย |
|---|---|---|
01 | Resignation | ลาออก |
02 | End of employment period | สิ้นสุดระยะเวลาการจ้าง |
03 | Termination/Early Retirement | เลิกจ้าง/โครงการเกษียณก่อนกำหนด |
04 | Retire | เกษียณอายุ |
05 | Fired/Dismissed | ไล่ออก/ปลดออก/ให้ออก |
06 | Dead | เสียชีวิต |
07 | Transfer | โอนย้ายสาขา |
08 | Probation Failed | ไม่ผ่านทดลองงาน |
09 | Immediate termination | เลิกจ้างกะทันหัน |
Request Body Example
{
"resign_doc_id": "MjAyNjAzMzBSREcwMDAwMDAwMQ==",
"resign_doc_dt": "2026-04-30",
"employee_code": "EMP001",
"hr_approve_flag": "Y",
"signout_type_flag": "01",
"sso_out_dt": "2026-04-30",
"blacklist_flag": "N",
"resign_doc_remark": "ลาออกด้วยความสมัครใจ",
"authorize_id": "SFIwMDEwMQ=="
}Response Format
Success Response (HTTP 200)
{
"code": 200,
"message": "HR อนุมัติเรียบร้อยแล้ว",
"payload": {
"resign_doc_id": "20260330RDG00000001",
"hr_approve_flag": "Y",
"approve_flag": "02",
"resign_doc_dt": "2026-04-30",
"out_dt": "2026-04-30"
}
}Response Fields
| Field | Type | Description |
|---|---|---|
resign_doc_id | string | รหัสเอกสารลาออก |
hr_approve_flag | string | สถานะ HR ที่ถูกอัปเดต (Y/N/C) |
approve_flag | string | สถานะการอนุมัติล่าสุด |
resign_doc_dt | string | วันที่มีผลการลาออก |
out_dt | string | null | วันที่สิ้นสุดการจ้างจริง (คำนวณจากรอบเงินเดือน) |
Error Response - Validation Failed (HTTP 422)
{
"code": 422,
"message": "Validation failed",
"errors": [
"'employee_code' is required",
"'hr_approve_flag' must be Y, N or C",
"'signout_type_flag' is required when hr_approve_flag = Y"
]
}Error Response - Employee Not Found (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/hr-approve" \
-H "Ocp-Apim-Subscription-Key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"resign_doc_id": "MjAyNjAzMzBSREcwMDAwMDAwMQ==",
"resign_doc_dt": "2026-04-30",
"employee_code": "EMP001",
"hr_approve_flag": "Y",
"signout_type_flag": "01",
"sso_out_dt": "2026-04-30",
"blacklist_flag": "N",
"resign_doc_remark": "ลาออกด้วยความสมัครใจ",
"authorize_id": "SFIwMDEwMQ=="
}'Notes
ข้อควรทราบ:
out_dtในผลลัพธ์อาจแตกต่างจากresign_doc_dtเนื่องจากระบบจะปรับวันตามรอบเงินเดือนsignout_type_flagเป็นข้อมูลบังคับเฉพาะเมื่อhr_approve_flag = "Y"เท่านั้น- เมื่อ HR ยืนยัน (
Y) ระบบจะลบสลิปเงินเดือนอนาคต ทำเครื่องหมายวันทำงานหลังวันลาออก และอัปเดตสถานะพนักงานอัตโนมัติ - พารามิเตอร์
resign_doc_idและauthorize_idต้องเข้ารหัส Base64 ก่อนส่ง
Related APIs
- Approve Resign - ผู้จัดการอนุมัติเอกสาร (ก่อน HR)
- Get Before Sign Out - ดูข้อมูลพนักงานก่อนดำเนินการลาออก
- Get Detail - ดูรายละเอียดเอกสารลาออก
Last updated on