Skip to Content
🚀 Welcome to Humansoft Open API Documentation

Search Welfare Employee

ดึงยอดคงเหลือสวัสดิการของพนักงาน 1 คน ทุกประเภทสวัสดิการในปีที่กำหนด แสดงวงเงิน ยอดใช้ไป และยอดคงเหลือ

Endpoint

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

Request Body

ParameterTypeRequiredDescriptionExample
employee_codestringYesรหัสพนักงาน"EMP001"
welfare_yearstringYesปีสวัสดิการ (YYYY)"2026"

Request Body Example

{ "employee_code": "EMP001", "welfare_year": "2026" }

Response 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

FieldTypeDescription
salary_type_idstringรหัสประเภทสวัสดิการ
salary_type_namestringชื่อประเภทสวัสดิการ (TH)
salary_type_name_enstringชื่อประเภทสวัสดิการ (EN)
welfare_employee_idstringรหัส Config (null ถ้าไม่มี Config)
employee_idstringรหัสพนักงาน
welfare_yearstringปีสวัสดิการ
welfare_prev_amtstringยอดยกมา
welfare_quota_amtstringวงเงินสวัสดิการ
used_welfare_amtstringยอดที่ใช้ไปแล้ว
balance_welfare_amtstringยอดคงเหลือ

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 -X POST "https://openapi.humansoft.co.th/api/v1/open-apis/welfare/search_welfare_employee" \ -H "Ocp-Apim-Subscription-Key: YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "employee_code": "EMP001", "welfare_year": "2026" }'

Notes

ข้อควรทราบ:

  • ID ทั้งหมดใน response เป็น plain text
  • API นี้คืนทุกประเภทสวัสดิการที่มีในระบบ ไม่ว่าพนักงานจะมี Config หรือไม่ (ถ้าไม่มี Config ยอดจะเป็น 0)
  • balance_welfare_amt = welfare_prev_amt + welfare_quota_amt - used_welfare_amt
  • used_welfare_amt รวมทั้งยอดที่อนุมัติแล้วและเอกสารที่อยู่ระหว่างดำเนินการ
  • List Balance - ดูยอดเฉพาะประเภทเดียว (ละเอียดกว่า)
  • List Welfare Types - ดูรายการประเภทสวัสดิการพร้อมยอด
  • Submit Welfare Employee Config - เพิ่ม Config สำหรับประเภทที่ยังไม่มี
Last updated on