Pull Back Employee Fund

ดึงข้อมูลกองทุนกลับมาจาก log กู้คืนข้อมูลกองทุนทั้งหมดของพนักงานที่ถูกลบไปแล้ว

API นี้จะดึงกองทุนทั้งหมดที่ถูกลบกลับมาให้พนักงาน ไม่ใช่ดึงเฉพาะรายการเดียว และพนักงานต้องไม่มีข้อมูลกองทุนอยู่ในระบบแล้ว

Endpoint


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

Request Body

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

ต้องระบุ employee_code หรือ employee_id อย่างใดอย่างหนึ่ง

Response Format

Success Response (มีข้อมูลดึงกลับมา)


{
  "code": 200,
  "message": "Pull Back Employee Fund Success",
  "payload": {
    "employee_id": "20260215EM01A2B3C4D5",
    "restored_count": 2,
    "fund_ids": [
      "20260215FD01A2B3C4D5",
      "20260215FD02E3F4A5B6"
    ],
    "deleted_log_ids": [
      "20260215FL01A2B3C4D5",
      "20260215FL02E3F4A5B6"
    ]
  }
}

Success Response (ไม่มีข้อมูลให้ดึงกลับมา)


{
  "code": 200,
  "message": "No Data to Pull Back",
  "payload": []
}

Response Fields

Field	Type	Description
`employee_id`	string	ID พนักงาน
`restored_count`	number	จำนวนกองทุนที่ดึงกลับมา
`fund_ids`	array	รายการ Fund ID ที่ดึงกลับมา
`deleted_log_ids`	array	รายการ Fund Log ID ที่ถูกลบ

Error Responses

Missing required parameter (HTTP 400)


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

Employee already has fund records (HTTP 400)


{
  "code": 400,
  "message": "Employee already has fund records in comp_fund_employee"
}

Validation Rules

Field	Rule
`employee_code` หรือ `employee_id`	ต้องระบุอย่างใดอย่างหนึ่ง, ต้องมีพนักงานในระบบ
No Existing Fund	พนักงานต้องไม่มีข้อมูลกองทุนอยู่ในระบบแล้ว
Log Data Exists	ต้องมีข้อมูลใน log ที่สามารถดึงกลับมาได้

Code Examples

cURL


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

JavaScript


const response = await fetch(
  'https://openapi.humansoft.co.th/api/v1/open-apis/employee/update-employee-financial?path_action=pull-back-fund',
  {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'Ocp-Apim-Subscription-Key': 'YOUR_API_KEY'
    },
    body: JSON.stringify({
      employee_code: 'EMP001'
    })
  }
)
const data = await response.json()
console.log('Restored count:', data.payload.restored_count)

Python


import requests
 
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": "pull-back-fund"}
data = {
    "employee_code": "EMP001"
}
 
response = requests.post(url, headers=headers, params=params, json=data)
result = response.json()
print(f"Restored: {result['message']}")

PHP


<?php
$url = "https://openapi.humansoft.co.th/api/v1/open-apis/employee/update-employee-financial?path_action=pull-back-fund";
 
$data = [
    "employee_code" => "EMP001"
];
 
$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 "Restored: " . $result['message'] . "\n";
?>

Notes

ใช้สำหรับกู้คืนข้อมูลกองทุนที่ถูกลบไปแล้วทั้งหมดของพนักงาน
จะดึงเฉพาะ record ล่าสุดของแต่ละ fund_id กลับมา
ยอดสะสมกองทุนจะถูกกู้คืนมาด้วย
ถ้าพนักงานมีข้อมูลกองทุนอยู่แล้ว จะไม่สามารถ pull back ได้

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