Search Welfare Employee
ดึงยอดคงเหลือสวัสดิการของพนักงาน 1 คน ทุกประเภทสวัสดิการในปีที่กำหนด แสดงวงเงิน ยอดใช้ไป และยอดคงเหลือ
Endpoint
GET /api/v1/open-apis/welfare/search-welfare-employeeสิทธิ์ที่ต้องการ: API Key ต้องมีสิทธิ์ ข้อมูลการยื่นเอกสาร (document:manage)
Query Parameters
| Parameter | Type | Required | Description | Example |
|---|---|---|---|---|
employee_code | string | Yes | รหัสพนักงาน | "EMP001" |
welfare_year | string | Yes | ปีสวัสดิการ (YYYY) | "2026" |
Request Example
GET /api/v1/open-apis/welfare/search-welfare-employee?employee_code=EMP001&welfare_year=2026Response Format
Success Response (HTTP 200)
{
"code": 200,
"message": "ดึงข้อมูลสำเร็จ",
"payload": [
{
"salary_type_id": "20260303STYP00001",
"salary_type_name": "สวัสดิการรักษาพยาบาล",
"salary_type_name_en": "Medical Welfare",
"welfare_employee_id": "20260303WEMP00001",
"employee_id": "20260309462FEF65EFCA",
"welfare_year": "2026",
"welfare_prev_amt": "5000.00",
"welfare_quota_amt": "20000.00",
"used_welfare_amt": "8000.00",
"balance_welfare_amt": "17000.00"
},
{
"salary_type_id": "20260303STYP00002",
"salary_type_name": "สวัสดิการทันตกรรม",
"salary_type_name_en": "Dental Welfare",
"welfare_employee_id": null,
"employee_id": null,
"welfare_year": null,
"welfare_prev_amt": "0.00",
"welfare_quota_amt": "0.00",
"used_welfare_amt": "0.00",
"balance_welfare_amt": "0.00"
}
]
}Response Fields
| Field | Type | Description |
|---|---|---|
salary_type_id | string | รหัสประเภทสวัสดิการ |
salary_type_name | string | ชื่อประเภทสวัสดิการ (TH) |
salary_type_name_en | string | ชื่อประเภทสวัสดิการ (EN) |
welfare_employee_id | string | รหัส Config (null ถ้าไม่มี Config) |
employee_id | string | รหัสพนักงาน |
welfare_year | string | ปีสวัสดิการ |
welfare_prev_amt | string | ยอดยกมา |
welfare_quota_amt | string | วงเงินสวัสดิการ |
used_welfare_amt | string | ยอดที่ใช้ไปแล้ว |
balance_welfare_amt | string | ยอดคงเหลือ |
Error Response - Validation Failed (HTTP 422)
{
"code": 422,
"message": "Validation failed",
"errors": [
"'employee_id' or 'employee_code' is required"
]
}Error Response - Server Error (HTTP 400)
{
"code": 400,
"message": "Internal server error"
}Code Examples
cURL
curl -X GET "https://openapi.humansoft.co.th/api/v1/open-apis/welfare/search-welfare-employee?employee_code=EMP001&welfare_year=2026" \
-H "Ocp-Apim-Subscription-Key: YOUR_API_KEY"Notes
ข้อควรทราบ:
- ID ทั้งหมดใน response เป็น plain text
- API นี้คืนทุกประเภทสวัสดิการที่มีในระบบ ไม่ว่าพนักงานจะมี Config หรือไม่ (ถ้าไม่มี Config ยอดจะเป็น 0)
balance_welfare_amt=welfare_prev_amt+welfare_quota_amt-used_welfare_amtused_welfare_amtรวมทั้งยอดที่อนุมัติแล้วและเอกสารที่อยู่ระหว่างดำเนินการ
Related APIs
- List Balance - ดูยอดเฉพาะประเภทเดียว (ละเอียดกว่า)
- List Welfare Types - ดูรายการประเภทสวัสดิการพร้อมยอด
- Submit Welfare Employee Config - เพิ่ม Config สำหรับประเภทที่ยังไม่มี
Last updated on