Skip to Content
🚀 Welcome to Humansoft Open API Documentation

HR Approve Resign

HR ยืนยันการลาออกและอัปเดตข้อมูลพนักงานในระบบ

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

Endpoint

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

Request Parameters

Required Parameters

ParameterTypeRequiredDescriptionExample
resign_doc_idstring (base64)Yesรหัสเอกสารลาออก (เข้ารหัส Base64)"MjAyNjAzMzBSREcwMDAwMDAwMQ=="
resign_doc_dtstringYesวันที่มีผลการลาออก (YYYY-MM-DD)"2026-04-30"
employee_codestringYesรหัสพนักงาน"EMP001"
hr_approve_flagstringYesการตัดสินใจของ HR (Y, N, C)"Y"
authorize_idstring (base64)YesID ของผู้ดำเนินการ (เข้ารหัส Base64)"SFIwMDEwMQ=="
signout_type_flagstringYes*ประเภทการสิ้นสุดการจ้างงาน (*บังคับเมื่อ hr_approve_flag = "Y")"01"

Optional Parameters

ParameterTypeRequiredDescriptionExample
sso_out_dtstringNoวันที่สิ้นสุดสิทธิ์ประกันสังคม (YYYY-MM-DD) ค่าเริ่มต้นเท่ากับ resign_doc_dt"2026-05-31"
blacklist_flagstringNoบันทึก Blacklist ("Y" หรือ "N")"N"
retire_with_compensationstringNoได้รับเงินชดเชยหรือไม่"Y"
retirement_yearstringNoจำนวนปีสำหรับคำนวณเงินชดเชย"10"
resign_doc_remarkstringNoหมายเหตุเพิ่มเติม"ลาออกด้วยความสมัครใจ"
signout_fund_dtstringNoวันที่สิ้นสุดกองทุน (YYYY-MM-DD)"2026-04-30"
severance_pay_extranumberNoจำนวนเดือนที่จ่ายชดเชยเพิ่ม (เงินค่าตกใจ)1
tax_calculation_type_lvstringNoประเภทการคำนวณภาษี (01 ภงด หรือ 02 ใบแนบ)"01"
compensation_flagstringNoสถานะการจ่ายเงินชดเชย ("Y" หรือ "N")"Y"
retirement_severance_flagstringNoสถานะชดเชยเกษียณ ("Y" หรือ "N")"Y"
use_app_dtstringNoวันที่ให้พนักงานหยุดใช้งานแอปพลิเคชัน (YYYY-MM-DD)"2026-04-30"
hr_remarkstringNoหมายเหตุสำหรับ HR"พนักงานโอนย้ายบริษัท"
approve_flagstringNoสถานะการอนุมัติปัจจุบัน สำหรับบันทึก Activity Log"02"

Option Values: hr_approve_flag

CodeEnglishภาษาไทยผลกระทบต่อระบบ
YHR ApprovedHR อนุมัติยืนยันอัปเดตข้อมูลพนักงาน จัดการงวดเงินเดือน ลบสลิปอนาคต
NPending HRรอการพิจารณาอัปเดตสถานะเอกสารเท่านั้น ไม่มีผลต่อข้อมูลพนักงาน
CCancelledยกเลิกการลาออกอัปเดตสถานะเอกสารเป็นยกเลิก

Option Values: signout_type_flag

CodeEnglishภาษาไทย
01Resignationลาออก
02End of employment periodสิ้นสุดระยะเวลาการจ้าง
03Termination/Early Retirementเลิกจ้าง/โครงการเกษียณก่อนกำหนด
04Retireเกษียณอายุ
05Fired/Dismissedไล่ออก/ปลดออก/ให้ออก
06Deadเสียชีวิต
07Transferโอนย้ายสาขา
08Probation Failedไม่ผ่านทดลองงาน
09Immediate 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

FieldTypeDescription
resign_doc_idstringรหัสเอกสารลาออก
hr_approve_flagstringสถานะ HR ที่ถูกอัปเดต (Y/N/C)
approve_flagstringสถานะการอนุมัติล่าสุด
resign_doc_dtstringวันที่มีผลการลาออก
out_dtstring | 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 -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 ก่อนส่ง
  • Approve Resign - ผู้จัดการอนุมัติเอกสาร (ก่อน HR)
  • Get Before Sign Out - ดูข้อมูลพนักงานก่อนดำเนินการลาออก
  • Get Detail - ดูรายละเอียดเอกสารลาออก
Last updated on