Skip to Content
🚀 Welcome to Humansoft Open API Documentation

List Group By Employee (Search)

เวอร์ชันขั้นสูงของ List Group By Employee เพิ่มเติมด้วยการตรวจสอบสิทธิ์อนุมัติ (authorize_flag), สิทธิ์แก้ไข (edit_approve), Filter ตามช่วงวันที่ และรองรับสายบังคับบัญชา

Endpoint

POST /api/v1/open-apis/welfare/list_group_by_employee_search

Request Body

ParameterTypeRequiredDescriptionExample
yearstringNoปีสวัสดิการ (YYYY)"2026"
approve_flagstringNoกรองตามสถานะ ("01" = กลุ่มรออนุมัติ)"01"
monthstringNoกรองตามเดือน (MM)"03"
authorize_linestringNo"true" = ดึงพนักงานในสายบังคับบัญชา"true"
select_channel_idstringNoChannel filter เมื่อใช้ authorize_line"MjAyMjA0MDE1OEQ4"
salary_type_idstring (base64)Noกรองตามประเภทสวัสดิการ"MjAyMjAyMjA0MDE1OEQ4"
from_dtstringNoกรองวันที่เริ่มต้น (YYYY-MM-DD)"2026-03-01"
to_dtstringNoกรองวันที่สิ้นสุด (YYYY-MM-DD)"2026-03-31"
language_codestringNoภาษา ("TH" หรือ "EN", default: "TH")"TH"
company_listsarrayNoFilter บริษัท [{"id": "base64"}][{"id": "MjAyNjAz..."}]
branch_listsarrayNoFilter สาขา [{"id": "base64"}][{"id": "MjAyNjAz..."}]
department_listsarrayNoFilter แผนก [{"id": "base64"}][{"id": "MjAyNjAz..."}]
division_listsarrayNoFilter ฝ่าย [{"id": "base64"}][{"id": "MjAyNjAz..."}]
section_listsarrayNoFilter ส่วน [{"id": "base64"}][{"id": "MjAyNjAz..."}]
section_lists_lv01arrayNoFilter ส่วนย่อยระดับ 1 [{"id": "base64"}][{"id": "MjAyNjAz..."}]
section_lists_lv02arrayNoFilter ส่วนย่อยระดับ 2 [{"id": "base64"}][{"id": "MjAyNjAz..."}]
section_lists_lv03arrayNoFilter ส่วนย่อยระดับ 3 [{"id": "base64"}][{"id": "MjAyNjAz..."}]
section_lists_lv04arrayNoFilter ส่วนย่อยระดับ 4 [{"id": "base64"}][{"id": "MjAyNjAz..."}]
section_lists_lv05arrayNoFilter ส่วนย่อยระดับ 5 [{"id": "base64"}][{"id": "MjAyNjAz..."}]
position_listsarrayNoFilter ตำแหน่ง [{"id": "base64"}][{"id": "MjAyNjAz..."}]
employee_listsarrayNoFilter เฉพาะพนักงาน [{"id": "base64"}][{"id": "MjAyNjAz..."}]
hashtagsarrayNoFilter ตาม Hashtag["ค่ารักษา"]

ค่า approve_flag

ValueDescription
"01"รออนุมัติ (รวมสถานะ 01, 04, 05, 06, 07, 08, 09)
"02"อนุมัติแล้ว
"03"ไม่อนุมัติ
""ไม่กรอง (แสดงทุกสถานะ)

Request Body Example

{ "authorize_line": "true", "select_channel_id": "MjAyMjA0MDE1OEQ4", "approve_flag": "01", "year": "2026" }

Response Format

Success Response (HTTP 200)

{ "code": 200, "message": "ดึงรายการสำเร็จ", "payload": [ { "employee_id": "20260309462FEF65EFCA", "employee_code": "EMP001", "employee_name": "สมหมาย", "employee_last_name": "พนักงาน", "company_name": "บริษัท ตัวอย่าง จำกัด", "branch_name": "สาขากลาง", "department_name": "แผนกบุคคล", "position_name": "เจ้าหน้าที่", "photograph": "https://...", "step_approve": 1, "auth_first": "20260303MGR00001", "auth_first_name": "สมชาย ผู้จัดการ", "employee_welfares": [ { "employee_welfare_id": "20260327WEL00000001", "welfare_dt": "2026-03-27", "welfare_amt": "5000.00", "approve_flag": "01", "welfare_status_name": "รออนุมัติ", "salary_type_name": "สวัสดิการรักษาพยาบาล", "extra_round_include": "N", "auth_first": "20260303MGR00001", "authorize_flag": true, "edit_approve": true } ] } ] }

Response Fields (Employee level)

FieldTypeDescription
employee_idstringรหัสพนักงาน
employee_codestringรหัสพนักงาน (ตัวอักษร)
employee_namestringชื่อพนักงาน
employee_last_namestringนามสกุลพนักงาน
company_namestringชื่อบริษัท
branch_namestringชื่อสาขา
department_namestringชื่อแผนก
position_namestringชื่อตำแหน่ง
photographstringURL รูปภาพ
step_approvenumberขั้นตอนการอนุมัติปัจจุบัน
auth_firststringรหัสผู้อนุมัติขั้นที่ 1
auth_first_namestringชื่อผู้อนุมัติขั้นที่ 1
employee_welfaresarrayรายการเอกสารสวัสดิการ

Response Fields (Document level - employee_welfares[])

FieldTypeDescription
employee_welfare_idstringรหัสเอกสาร
welfare_dtstringวันที่เบิก
welfare_amtstringจำนวนเงิน
approve_flagstringสถานะเอกสาร
welfare_status_namestringชื่อสถานะ
salary_type_namestringชื่อประเภทสวัสดิการ
extra_round_includestringรวมในรอบพิเศษ (Y/N)
auth_firststringรหัสผู้อนุมัติขั้นที่ 1
authorize_flagbooleanผู้ใช้มีสิทธิ์อนุมัติเอกสารนี้
edit_approvebooleanผู้ใช้มีสิทธิ์แก้ไข/อนุมัติเอกสารนี้

Error Response - Validation Failed (HTTP 422)

{ "code": 422, "message": "Validation failed", "errors": [ "Missing required parameter: year" ] }

Code Examples

curl -X POST "https://openapi.humansoft.co.th/api/v1/open-apis/welfare/list_group_by_employee_search" \ -H "Ocp-Apim-Subscription-Key: YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "authorize_line": "true", "select_channel_id": "MjAyMjA0MDE1OEQ4", "approve_flag": "01", "year": "2026" }'

Notes

ข้อควรทราบ:

  • Response คืนเฉพาะพนักงานที่มีเอกสารซึ่งผู้ใช้มีสิทธิ์อนุมัติ (authorize_flag = true)
  • edit_approve = true หมายความว่าผู้ใช้สามารถกดอนุมัติเอกสารนั้นได้
  • approve_flag = "01" จะ expand เป็นกลุ่มรออนุมัติอัตโนมัติ (รวมสถานะ 01, 04, 05, 06, 07, 08, 09)
  • ถ้าใช้ authorize_line ให้ระบุ select_channel_id เพื่อกรอง Channel
  • Filter ที่เป็น array ใช้ {"id": "base64_id"} format
  • ทุก ID ใน response เป็น plain text
  • Group By Employee - เวอร์ชันพื้นฐาน ไม่มี authorize_flag
  • Approve - อนุมัติเอกสาร
  • Get Detail - ดูรายละเอียดเอกสาร
Last updated on