List Employee Funds

ดึงรายการกองทุนทั้งหมดของพนักงาน รวมทั้งกองทุนที่บริษัทมีและสถานะการเป็นสมาชิกของพนักงาน พร้อมยอดสะสมกองทุน

Endpoint


GET /api/v1/open-apis/employee/get-employee-data-filter?path_action=list-fund

Query Parameters

Parameter	Type	Required	Description
`path_action`	string	Yes	ต้องเป็น `list-fund`
`employee_code`	string	Yes	รหัสพนักงาน

Response Format

Success Response


{
  "code": 200,
  "message": "สำเร็จ",
  "payload": [
    {
      "fund_id": "20260215FD01A2B3C4D5",
      "fund_employee_id": "20260215FE01A2B3C4D5",
      "fund_employee_no": "M001",
      "fund_employee_date": "2024-01-15",
      "fund_employee_type": "01",
      "fund_employee_rate": 3,
      "fund_company_type": "01",
      "fund_company_rate": 3,
      "fund_employee_beneficiary": "นางสาวทดสอบ ระบบ",
      "fund_employee_balance": 50000,
      "fund_company_balance": 50000,
      "salary_type_name": "กองทุนสำรองเลี้ยงชีพ",
      "salary_type_name_en": "Provident Fund"
    },
    {
      "fund_id": "20260215FD02E3F4A5B6",
      "fund_employee_id": null,
      "fund_employee_no": null,
      "fund_employee_date": null,
      "fund_employee_type": null,
      "fund_employee_rate": null,
      "fund_company_type": null,
      "fund_company_rate": null,
      "fund_employee_beneficiary": null,
      "fund_employee_balance": null,
      "fund_company_balance": null,
      "salary_type_name": "กองทุนสำรองเลี้ยงชีพพิเศษ",
      "salary_type_name_en": "Special Provident Fund"
    }
  ]
}

Response Fields

Field	Type	Description
`fund_id`	string	ID กองทุน
`fund_employee_id`	string / null	ID สมาชิกกองทุน (null = ยังไม่ได้สมัคร)
`fund_employee_no`	string / null	เลขที่สมาชิกกองทุน
`fund_employee_date`	string / null	วันที่เข้าร่วมกองทุน
`fund_employee_type`	string / null	วิธีคำนวณหักพนักงาน: `01` = %, `02` = บาท, `03` = สูตร
`fund_employee_rate`	number / null	อัตราหักพนักงาน
`fund_company_type`	string / null	วิธีคำนวณสมทบบริษัท: `01` = %, `02` = บาท, `03` = สูตร
`fund_company_rate`	number / null	อัตราสมทบบริษัท
`fund_employee_beneficiary`	string / null	ชื่อผู้รับผลประโยชน์
`fund_employee_balance`	number / null	ยอดสะสมกองทุนพนักงาน
`fund_company_balance`	number / null	ยอดสะสมกองทุนบริษัท
`salary_type_name`	string	ชื่อกองทุน (ภาษาไทย)
`salary_type_name_en`	string	ชื่อกองทุน (ภาษาอังกฤษ)

API นี้จะแสดงกองทุนทั้งหมดที่บริษัทมี ไม่ใช่เฉพาะกองทุนที่พนักงานสมัคร หากกองทุนใดมี fund_employee_id เป็น null หมายความว่าพนักงานยังไม่ได้สมัครกองทุนนั้น

Error Response


{
  "code": 400,
  "message": "ไม่สำเร็จ",
  "error": "Employee not found with code: EMP001"
}

Code Examples

cURL


curl -X GET "https://openapi.humansoft.co.th/api/v1/open-apis/employee/get-employee-data-filter?path_action=list-fund&employee_code=EMP001" \
  -H "Ocp-Apim-Subscription-Key: YOUR_API_KEY"

JavaScript


const response = await fetch(
  'https://openapi.humansoft.co.th/api/v1/open-apis/employee/get-employee-data-filter?path_action=list-fund&employee_code=EMP001',
  {
    headers: {
      'Ocp-Apim-Subscription-Key': 'YOUR_API_KEY'
    }
  }
)
const data = await response.json()
console.log('Funds:', data.payload)

Python


import requests
 
url = "https://openapi.humansoft.co.th/api/v1/open-apis/employee/get-employee-data-filter"
headers = {"Ocp-Apim-Subscription-Key": "YOUR_API_KEY"}
params = {
    "path_action": "list-fund",
    "employee_code": "EMP001"
}
 
response = requests.get(url, headers=headers, params=params)
data = response.json()
print(f"Found {len(data['payload'])} funds")

PHP


<?php
$url = "https://openapi.humansoft.co.th/api/v1/open-apis/employee/get-employee-data-filter?path_action=list-fund&employee_code=EMP001";
 
$ch = curl_init($url);
curl_setopt($ch, CURLOPT_HTTPHEADER, ["Ocp-Apim-Subscription-Key: YOUR_API_KEY"]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
 
$response = curl_exec($ch);
curl_close($ch);
 
$data = json_decode($response, true);
echo "Found " . count($data['payload']) . " funds\n";
?>

Get Fund - ดึงข้อมูลกองทุนตาม ID
Add Fund - เพิ่มกองทุนให้พนักงาน
Update Fund - แก้ไขข้อมูลกองทุน
Delete Fund - ลบกองทุน (ออกจากกองทุน)
Pause Fund - เปิด/ปิดกองทุน
Pull Back Fund - ดึงข้อมูลกองทุนกลับมาจาก log