List Welfare Logs
ดึงรายการ Welfare Log ของพนักงานตามประเภทสวัสดิการและปี รวมทั้ง Log จากการอนุมัติเอกสารและ Log ที่สร้างแบบ Manual
Endpoint
POST /api/v1/open-apis/welfare/list_welfare_logRequest Parameters
Required Parameters
| Parameter | Type | Required | Description | Example |
|---|---|---|---|---|
salary_type_id | string (base64) | Yes | รหัสประเภทสวัสดิการ | "MjAyNjAzMDNTVFlQWDAwMDE=" |
employee_code | string | Yes | รหัสพนักงาน | "EMP001" |
welfare_year | string | Yes | ปีสวัสดิการ (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
| Field | Type | Description |
|---|---|---|
employee_welfare_log_id | string | รหัส Log (plain text) |
employee_id | string | รหัสพนักงาน (plain text) |
salary_type_id | string | รหัสประเภทสวัสดิการ (plain text) |
employee_welfare_year | string | ปีสวัสดิการ |
master_salary_month | string | รอบเงินเดือน (YYYY-MM) |
master_salary_report_id | string | รหัสรอบรายงาน (plain text) |
reference_id | string | รหัสเอกสารต้นทาง (plain text) — มีเฉพาะ Log จากการอนุมัติ |
welfare_dt | string | วันที่ใช้สวัสดิการ |
welfare_amt | string | จำนวนเงินต้นทาง |
log_balance | string | ยอดที่หักจากวงเงิน |
log_source | string | แหล่งที่มา: "Approve" หรือ "Manual" |
welfare_desc | string | รายละเอียด |
welfare_doc | string | URL ไฟล์แนบ |
log_datetime | string | วันเวลาที่บันทึก Log |
Error Response - Server Error (HTTP 400)
{
"code": 400,
"message": "Internal server error"
}Code Examples
cURL
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 Logreference_idจะมีค่าเมื่อ Log มาจากการอนุมัติเอกสาร
Related APIs
- Create Log - สร้าง Log แบบ Manual
- Delete Log - ลบ Log
Last updated on