List Welfare Employee By Type
ดึงรายการพนักงานพร้อมข้อมูล Config สวัสดิการตามประเภทและปี รองรับ Pagination
Endpoint
POST /api/v1/open-apis/welfare/list_welfare_employee_by_typeRequest Parameters
Required Parameters
| Parameter | Type | Required | Description | Example |
|---|---|---|---|---|
salary_type_id | string (base64) | Yes | รหัสประเภทสวัสดิการ | "MjAyNjAzMDNTVFlQWDAwMDE=" |
welfare_year | string | Yes | ปีสวัสดิการ (YYYY) | "2026" |
Optional Parameters
| Parameter | Type | Required | Description | Example |
|---|---|---|---|---|
_PAGE | integer | No | หน้าที่ต้องการ (default: 1) | 1 |
_NUMBER_PER_PAGE | integer | No | จำนวนรายการต่อหน้า (default: ทั้งหมด) | 20 |
Request Body Example
{
"salary_type_id": "MjAyNjAzMDNTVFlQWDAwMDE=",
"welfare_year": "2026",
"_PAGE": 1,
"_NUMBER_PER_PAGE": 20
}Response Format
Success Response (HTTP 200)
{
"code": 200,
"message": "ดึงข้อมูลสำเร็จ",
"payload": [
{
"employee_id": "20260309462FEF65EFCA",
"employee_code": "EMP001",
"employee_name": "สมหมาย",
"employee_last_name": "พนักงาน",
"employee_nickname": "หมาย",
"company_name": "บริษัท ตัวอย่าง จำกัด",
"department_name": "แผนกบุคคล",
"position_name": "เจ้าหน้าที่",
"welfare_list": {
"welfare_employee_id": "20260303WEMP00001",
"employee_id": "20260309462FEF65EFCA",
"salary_type_id": "20260303STYP00001",
"welfare_year": "2026",
"welfare_quota_amt": "20000.00",
"welfare_prev_amt": "5000.00"
}
},
{
"employee_id": "20260309462FEF65EFCB",
"employee_code": "EMP002",
"employee_name": "สมศักดิ์",
"employee_last_name": "รักงาน",
"employee_nickname": "ศักดิ์",
"company_name": "บริษัท ตัวอย่าง จำกัด",
"department_name": "แผนกบัญชี",
"position_name": "นักบัญชี",
"welfare_list": null
}
],
"_PAGINATION": {
"_TOTAL_RECORDS": 50,
"_PAGE": 1,
"_NUMBER_PER_PAGE": 20
}
}Response Fields - payload[]
| Field | Type | Description |
|---|---|---|
employee_id | string | รหัสพนักงาน (plain text) |
employee_code | string | รหัสพนักงาน (ตัวอักษร) |
employee_name | string | ชื่อพนักงาน |
employee_last_name | string | นามสกุล |
employee_nickname | string | ชื่อเล่น |
company_name | string | ชื่อบริษัท |
department_name | string | ชื่อแผนก |
position_name | string | ชื่อตำแหน่ง |
welfare_list | object|null | Config สวัสดิการ (null = ยังไม่ได้ตั้งค่า) |
Response Fields - welfare_list (ถ้ามี)
| Field | Type | Description |
|---|---|---|
welfare_employee_id | string | รหัส Config (plain text) |
welfare_quota_amt | string | วงเงินสวัสดิการ |
welfare_prev_amt | string | ยอดยกมา |
Response Fields - _PAGINATION
| Field | Type | Description |
|---|---|---|
_TOTAL_RECORDS | integer | จำนวนพนักงานทั้งหมด |
_PAGE | integer | หน้าปัจจุบัน |
_NUMBER_PER_PAGE | integer | จำนวนรายการต่อหน้า |
Error Response - Validation Failed (HTTP 422)
{
"code": 422,
"message": "Validation failed",
"errors": [
"'salary_type_id' and 'welfare_year' are required"
]
}Code Examples
cURL
curl -X POST "https://openapi.humansoft.co.th/api/v1/open-apis/welfare/list_welfare_employee_by_type" \
-H "Ocp-Apim-Subscription-Key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"salary_type_id": "MjAyNjAzMDNTVFlQWDAwMDE=",
"welfare_year": "2026",
"_PAGE": 1,
"_NUMBER_PER_PAGE": 20
}'Notes
ข้อควรทราบ:
salary_type_idใน request ต้องเข้ารหัส Base64- ID ทั้งหมดใน response เป็น plain text
welfare_list = nullหมายความว่าพนักงานคนนั้นยังไม่มี Config สำหรับประเภทสวัสดิการนี้ในปีนั้น- ถ้าไม่ระบุ
_PAGEและ_NUMBER_PER_PAGEระบบจะคืนทุกรายการ
Related APIs
- Create Config - เพิ่ม Config ให้พนักงานที่
welfare_list = null - Update Multiple - อัปเดตหลายพนักงานพร้อมกัน
Last updated on