Skip to Content
🚀 Welcome to Humansoft Open API Documentation

List Welfare Logs

ดึงรายการ Welfare Log ของพนักงานตามประเภทสวัสดิการและปี รวมทั้ง Log จากการอนุมัติเอกสารและ Log ที่สร้างแบบ Manual

Endpoint

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

Request Parameters

Required Parameters

ParameterTypeRequiredDescriptionExample
salary_type_idstring (base64)Yesรหัสประเภทสวัสดิการ"MjAyNjAzMDNTVFlQWDAwMDE="
employee_codestringYesรหัสพนักงาน"EMP001"
welfare_yearstringYesปีสวัสดิการ (YYYY)"2026"

Request Body Example

{ "salary_type_id": "MjAyNjAzMDNTVFlQWDAwMDE=", "employee_code": "EMP001", "welfare_year": "2026" }

Response Format

Success Response (HTTP 200)

{ "code": 200, "message": "ดึงรายการสำเร็จ", "payload": [ { "employee_welfare_log_id": "20260315WLOG0000001", "employee_id": "20260309462FEF65EFCA", "salary_type_id": "20260303STYP00001", "employee_welfare_year": "2026", "master_salary_month": "2026-03", "master_salary_report_id": "20260303RPRT00001", "reference_id": "20260327WEL00000001", "welfare_dt": "2026-03-15", "welfare_amt": "5000.00", "log_balance": "5000.00", "log_source": "Approve", "welfare_desc": "ค่ารักษาพยาบาล", "welfare_doc": "https://openapi.humansoft.co.th/files/employee-welfares/...", "log_datetime": "2026-03-27 10:00:00" }, { "employee_welfare_log_id": "20260320WLOG0000002", "employee_id": "20260309462FEF65EFCA", "salary_type_id": "20260303STYP00001", "employee_welfare_year": "2026", "master_salary_month": "2026-03", "log_balance": "3000.00", "log_source": "Manual", "welfare_desc": "ค่ารักษาพยาบาลสะสม", "log_datetime": "2026-03-20 14:30:00" } ] }

ถ้าไม่มีข้อมูล payload จะเป็น []

Response Fields

FieldTypeDescription
employee_welfare_log_idstringรหัส Log (plain text)
employee_idstringรหัสพนักงาน (plain text)
salary_type_idstringรหัสประเภทสวัสดิการ (plain text)
employee_welfare_yearstringปีสวัสดิการ
master_salary_monthstringรอบเงินเดือน (YYYY-MM)
master_salary_report_idstringรหัสรอบรายงาน (plain text)
reference_idstringรหัสเอกสารต้นทาง (plain text) — มีเฉพาะ Log จากการอนุมัติ
welfare_dtstringวันที่ใช้สวัสดิการ
welfare_amtstringจำนวนเงินต้นทาง
log_balancestringยอดที่หักจากวงเงิน
log_sourcestringแหล่งที่มา: "Approve" หรือ "Manual"
welfare_descstringรายละเอียด
welfare_docstringURL ไฟล์แนบ
log_datetimestringวันเวลาที่บันทึก Log

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/list_welfare_log" \ -H "Ocp-Apim-Subscription-Key: YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "salary_type_id": "MjAyNjAzMDNTVFlQWDAwMDE=", "employee_code": "EMP001", "welfare_year": "2026" }'

Notes

ข้อควรทราบ:

  • salary_type_id ใน request ต้องเข้ารหัส Base64
  • ID ทั้งหมดใน response เป็น plain text
  • log_source = "Approve" คือ Log ที่ถูกสร้างอัตโนมัติเมื่อมีการอนุมัติเอกสารสวัสดิการ
  • log_source = "Manual" คือ Log ที่สร้างผ่าน API Create Log
  • reference_id จะมีค่าเมื่อ Log มาจากการอนุมัติเอกสาร
Last updated on