List Group By Employee

ดึงรายการเอกสารสวัสดิการจัดกลุ่มตามพนักงาน รองรับ Filter ตามองค์กร (บริษัท, สาขา, แผนก, ฝ่าย, ส่วน, ตำแหน่ง) และ Hashtag

Endpoint


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

Request Body

Required Parameters

Parameter	Type	Required	Description	Example
`year`	string	Yes	ปีสวัสดิการ (YYYY)	`"2026"`

Optional Parameters

Parameter	Type	Required	Description	Example
`approve_flag`	string	No	กรองตามสถานะ	`"01"`
`month`	string	No	กรองตามเดือน (MM)	`"03"`
`language_code`	string	No	ภาษาสำหรับชื่อผู้อนุมัติ (default: `"TH"`)	`"TH"`
`company_lists`	array	No	Filter บริษัท `[{"id": "base64"}]`	`[{"id": "MjAyNjAz..."}]`
`branch_lists`	array	No	Filter สาขา `[{"id": "base64"}]`	`[{"id": "MjAyNjAz..."}]`
`department_lists`	array	No	Filter แผนก `[{"id": "base64"}]`	`[{"id": "MjAyNjAz..."}]`
`division_lists`	array	No	Filter ฝ่าย `[{"id": "base64"}]`	`[{"id": "MjAyNjAz..."}]`
`section_lists`	array	No	Filter ส่วน `[{"id": "base64"}]`	`[{"id": "MjAyNjAz..."}]`
`position_lists`	array	No	Filter ตำแหน่ง `[{"id": "base64"}]`	`[{"id": "MjAyNjAz..."}]`
`employee_lists`	array	No	Filter เฉพาะพนักงาน `[{"id": "base64"}]`	`[{"id": "MjAyNjAz..."}]`
`hashtags`	array	No	Filter ตาม Hashtag	`["ค่ารักษา"]`

ค่า approve_flag

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

Request Body Example


{
  "year": "2026",
  "approve_flag": "01",
  "month": "03",
  "department_lists": [
    {"id": "MjAyNjAzMDNERVBUMDAwMDE="}
  ]
}

Response Format

Success Response (HTTP 200)


{
  "code": 200,
  "message": "ดึงรายการสำเร็จ",
  "payload": [
    {
      "employee_id": "20260309462FEF65EFCA",
      "employee_name": "สมหมาย",
      "employee_last_name": "พนักงาน",
      "employee_nickname": "หมาย",
      "employee_name_en": "Sommai",
      "employee_last_name_en": "Employee",
      "employee_nickname_en": "Mai",
      "company_id": "20260303COMP0001",
      "branch_id": "20260303BRNC0001",
      "department_id": "20260303DEPT0001",
      "position_id": "20260303POSN0001",
      "photograph": "https://...",
      "company_name": "บริษัท ตัวอย่าง จำกัด",
      "branch_name": "สาขากลาง",
      "department_name": "แผนกบุคคล",
      "position_name": "เจ้าหน้าที่",
      "step_approve": 1,
      "auth_first": "20260303MGR00001",
      "auth_first_id": "20260303MGR00001",
      "auth_first_code": "MGR001",
      "auth_first_name": "สมชาย ผู้จัดการ",
      "employee_welfares": [
        {
          "employee_welfare_id": "20260327WEL00000001",
          "employee_id": "20260309462FEF65EFCA",
          "welfare_dt": "2026-03-27",
          "welfare_amt": "5000.00",
          "welfare_desc": "ค่ารักษาพยาบาล",
          "approve_flag": "01",
          "welfare_status_name": "รออนุมัติ",
          "salary_type_name": "สวัสดิการรักษาพยาบาล",
          "salary_type_name_en": "Medical Welfare",
          "approve_employee_name": "สมชาย ผู้อนุมัติ"
        }
      ]
    }
  ]
}

Response Fields (Employee level)

Field	Type	Description
`employee_id`	string	รหัสพนักงาน
`employee_name`	string	ชื่อพนักงาน
`employee_last_name`	string	นามสกุลพนักงาน
`employee_nickname`	string	ชื่อเล่น
`employee_name_en`	string	ชื่อพนักงาน (EN)
`employee_last_name_en`	string	นามสกุลพนักงาน (EN)
`employee_nickname_en`	string	ชื่อเล่น (EN)
`company_name`	string	ชื่อบริษัท
`branch_name`	string	ชื่อสาขา
`department_name`	string	ชื่อแผนก
`position_name`	string	ชื่อตำแหน่ง
`photograph`	string	URL รูปภาพ
`step_approve`	number	ขั้นตอนการอนุมัติปัจจุบัน
`auth_first`	string	รหัสผู้อนุมัติขั้นที่ 1
`auth_first_name`	string	ชื่อผู้อนุมัติขั้นที่ 1
`employee_welfares`	array	รายการเอกสารสวัสดิการ

Response Fields (Document level - employee_welfares[])

Field	Type	Description
`employee_welfare_id`	string	รหัสเอกสาร
`employee_id`	string	รหัสพนักงาน
`welfare_dt`	string	วันที่เบิก
`welfare_amt`	string	จำนวนเงิน
`welfare_desc`	string	รายละเอียด
`approve_flag`	string	สถานะเอกสาร
`welfare_status_name`	string	ชื่อสถานะ
`salary_type_name`	string	ชื่อประเภทสวัสดิการ (TH)
`salary_type_name_en`	string	ชื่อประเภทสวัสดิการ (EN)
`approve_employee_name`	string	ชื่อผู้อนุมัติ

Error Response - Validation Failed (HTTP 422)


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

Code Examples

cURL


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

JavaScript


const response = await fetch(
  'https://openapi.humansoft.co.th/api/v1/open-apis/welfare/list_group_by_employee',
  {
    method: 'POST',
    headers: {
      'Ocp-Apim-Subscription-Key': 'YOUR_API_KEY',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      year: '2026',
      approve_flag: '01'
    })
  }
)
 
const data = await response.json()
 
if (data.code === 200) {
  data.payload.forEach(emp => {
    console.log(`${emp.employee_name}: ${emp.employee_welfares.length} เอกสาร`)
  })
} else {
  console.error('Error:', data.errors || data.message)
}

Python


import requests
 
url = "https://openapi.humansoft.co.th/api/v1/open-apis/welfare/list_group_by_employee"
headers = {
    "Ocp-Apim-Subscription-Key": "YOUR_API_KEY",
    "Content-Type": "application/json"
}
payload = {
    "year": "2026",
    "approve_flag": "01"
}
 
response = requests.post(url, headers=headers, json=payload)
data = response.json()
 
if data["code"] == 200:
    for emp in data["payload"]:
        print(f"{emp['employee_name']}: {len(emp['employee_welfares'])} เอกสาร")
else:
    print("Error:", data.get("errors") or data.get("message"))

PHP


<?php
$url = "https://openapi.humansoft.co.th/api/v1/open-apis/welfare/list_group_by_employee";
 
$headers = [
    "Ocp-Apim-Subscription-Key: YOUR_API_KEY",
    "Content-Type: application/json"
];
 
$payload = [
    "year" => "2026",
    "approve_flag" => "01"
];
 
$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) {
    foreach ($data["payload"] as $emp) {
        echo $emp["employee_name"] . ": " . count($emp["employee_welfares"]) . " เอกสาร\n";
    }
} else {
    echo "Error: " . ($data["errors"][0] ?? $data["message"]);
}
 
curl_close($ch);
?>

Notes

ข้อควรทราบ:

company_lists, branch_lists, department_lists และ Filter อื่นๆ ใช้ {"id": "base64_id"} format
ถ้าระบุทั้ง branch_lists และ department_lists จะใช้ OR condition
approve_flag = "01" จะ expand เป็นกลุ่มรออนุมัติอัตโนมัติ (รวมสถานะ 01, 04, 05, 06, 07, 08)
รายการถูก scope ตามพนักงานที่ผู้ใช้มีสิทธิ์ดู
ทุก ID ใน response เป็น plain text

Group By Employee (Search) - เวอร์ชันขั้นสูงพร้อม authorize_flag
Get Detail - ดูรายละเอียดเอกสาร
Approve - อนุมัติเอกสาร

List Group By Employee

Endpoint

Request Body

Required Parameters

Optional Parameters

ค่า approve_flag

Request Body Example

Response Format

Success Response (HTTP 200)

Response Fields (Employee level)

Response Fields (Document level - employee_welfares[])

Error Response - Validation Failed (HTTP 422)

Code Examples

cURL

JavaScript

Python

PHP

Notes

Related APIs