Pause / Resume Employee Fund

เปิดหรือปิดกองทุนของพนักงาน โดยไม่ลบข้อมูลการเป็นสมาชิก ใช้สำหรับหยุดหักชั่วคราวหรือเปิดหักใหม่

Endpoint


POST /api/v1/open-apis/employee/update-employee-financial?path_action=pause-fund

Request Body

Parameter	Type	Required	Description
`employee_code`	string	Yes*	รหัสพนักงาน
`employee_id`	string	Yes*	ID พนักงาน (Base64 encoded)
`fund_id`	string	Yes	ID กองทุน (Base64 encoded)

ต้องระบุ employee_code หรือ employee_id อย่างใดอย่างหนึ่ง ระบบจะสลับสถานะอัตโนมัติ (Y เป็น N หรือ N เป็น Y)

Response Format

Success Response


{
  "code": 200,
  "message": "Pause Fund Success",
  "payload": {
    "fund_employee_id": "20260215FE01A2B3C4D5",
    "employee_id": "20260215EM01A2B3C4D5",
    "fund_id": "20260215FD01A2B3C4D5",
    "publish_flag": "Y",
    "action": "เปิด",
    "action_en": "Open"
  }
}

Response Fields

Field	Type	Description
`fund_employee_id`	string	ID สมาชิกกองทุน
`employee_id`	string	ID พนักงาน
`fund_id`	string	ID กองทุน
`publish_flag`	string	สถานะหลังสลับ: `Y` = เปิด (หักเงิน), `N` = ปิด (หยุดหัก)
`action`	string	สถานะที่เปลี่ยน (ภาษาไทย)
`action_en`	string	สถานะที่เปลี่ยน (ภาษาอังกฤษ)

Error Responses

Missing required parameter (HTTP 400)


{
  "code": 400,
  "message": "Validation failed",
  "errors": [
    "Missing required parameter: 'employee_code'"
  ]
}

Fund not found (HTTP 400)


{
  "code": 400,
  "message": "Fund not found for employee_id: 20260215EM01A2B3C4D5, fund_id: 20260215FD01A2B3C4D5"
}

Validation Rules

Field	Rule
`employee_code` หรือ `employee_id`	ต้องระบุอย่างใดอย่างหนึ่ง, ต้องมีพนักงานในระบบ
`fund_id`	ต้องระบุ, ต้องเป็น Base64 encoded, ต้องมีกองทุนในระบบ
Fund Membership	พนักงานต้องเป็นสมาชิกกองทุนนั้นอยู่แล้ว

Code Examples

cURL


curl -X POST "https://openapi.humansoft.co.th/api/v1/open-apis/employee/update-employee-financial?path_action=pause-fund" \
  -H "Content-Type: application/json" \
  -H "Ocp-Apim-Subscription-Key: YOUR_API_KEY" \
  -d '{
    "employee_code": "EMP001",
    "fund_id": "MjAyNjAyMTVGRDAxQTJCM0M0RDU="
  }'

JavaScript


const response = await fetch(
  'https://openapi.humansoft.co.th/api/v1/open-apis/employee/update-employee-financial?path_action=pause-fund',
  {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'Ocp-Apim-Subscription-Key': 'YOUR_API_KEY'
    },
    body: JSON.stringify({
      employee_code: 'EMP001',
      fund_id: btoa('20260215FD01A2B3C4D5')
    })
  }
)
const data = await response.json()
console.log('Action:', data.payload.action_en, '- publish_flag:', data.payload.publish_flag)

Python


import requests
import base64
 
fund_id = base64.b64encode("20260215FD01A2B3C4D5".encode()).decode()
 
url = "https://openapi.humansoft.co.th/api/v1/open-apis/employee/update-employee-financial"
headers = {
    "Content-Type": "application/json",
    "Ocp-Apim-Subscription-Key": "YOUR_API_KEY"
}
params = {"path_action": "pause-fund"}
data = {
    "employee_code": "EMP001",
    "fund_id": fund_id
}
 
response = requests.post(url, headers=headers, params=params, json=data)
result = response.json()
print(f"Action: {result['payload']['action_en']} - publish_flag: {result['payload']['publish_flag']}")

PHP


<?php
$url = "https://openapi.humansoft.co.th/api/v1/open-apis/employee/update-employee-financial?path_action=pause-fund";
 
$data = [
    "employee_code" => "EMP001",
    "fund_id" => base64_encode("20260215FD01A2B3C4D5")
];
 
$ch = curl_init($url);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    "Content-Type: application/json",
    "Ocp-Apim-Subscription-Key: YOUR_API_KEY"
]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
 
$response = curl_exec($ch);
curl_close($ch);
 
$result = json_decode($response, true);
echo "Action: " . $result['payload']['action_en'] . " - publish_flag: " . $result['payload']['publish_flag'] . "\n";
?>

Notes

ใช้สำหรับหยุดหักชั่วคราว ไม่ใช่การลบออกจากกองทุน ข้อมูลการเป็นสมาชิกและยอดสะสมจะยังคงอยู่
เมื่อปิด (publish_flag = N) ระบบจะไม่หักเงินในงวดถัดไป
การเปิด/ปิดจะมีผลกับการหักเงินเดือนงวดถัดไป

List Funds - ดึงรายการกองทุนทั้งหมด
Get Fund - ดึงข้อมูลกองทุนตาม ID
Add Fund - เพิ่มกองทุนให้พนักงาน
Update Fund - แก้ไขข้อมูลกองทุน
Delete Fund - ลบกองทุน (ออกจากกองทุน)
Pull Back Fund - ดึงข้อมูลกองทุนที่ลบแล้วกลับมา