Update Employee Fund
แก้ไขข้อมูลกองทุนของพนักงาน เช่น เลขที่สมาชิก อัตราหัก ผู้รับผลประโยชน์ และหมายเหตุ
Endpoint
POST /api/v1/open-apis/employee/update-employee-financial?path_action=save-fundRequest Body
| Parameter | Type | Required | Description |
|---|---|---|---|
fund_employee_id | string | Yes | ID สมาชิกกองทุน (Base64 encoded) |
fund_employee_no | string | No | เลขที่สมาชิกกองทุน |
fund_employee_date | string | No | วันที่เข้าร่วมกองทุน (YYYY-MM-DD) |
fund_employee_type | string | No | วิธีคำนวณหักพนักงาน: 01 = เปอร์เซ็นต์, 02 = จำนวนเงินคงที่, 03 = สูตรคำนวณ |
fund_employee_rate | number | No | อัตราหักพนักงาน |
fund_company_type | string | No | วิธีคำนวณสมทบบริษัท: 01 = เปอร์เซ็นต์, 02 = จำนวนเงินคงที่, 03 = สูตรคำนวณ |
fund_company_rate | number | No | อัตราสมทบบริษัท |
fund_employee_beneficiary | string | No | ชื่อผู้รับผลประโยชน์ |
fund_employee_remark | string | No | หมายเหตุ |
สามารถส่งเฉพาะฟิลด์ที่ต้องการแก้ไข ฟิลด์อื่นจะคงค่าเดิม ไม่สามารถเปลี่ยน fund_id ได้ หากต้องการเปลี่ยนกองทุนต้องลบและเพิ่มใหม่
Response Format
Success Response
{
"code": 200,
"message": "Update Fund Success",
"payload": {
"fund_employee_id": "20260215FE01A2B3C4D5",
"fund_id": "20260215FD01A2B3C4D5",
"employee_id": "20260215EM01A2B3C4D5",
"fund_employee_no": "M002",
"fund_employee_date": "2024-01-15",
"fund_employee_type": "01",
"fund_employee_rate": 5,
"fund_company_type": "01",
"fund_company_rate": 5,
"fund_employee_beneficiary": "นางสาวทดสอบ ระบบ (แก้ไข)",
"fund_employee_remark": ""
}
}Response Fields
| Field | Type | Description |
|---|---|---|
fund_employee_id | string | ID สมาชิกกองทุน |
fund_id | string | ID กองทุน |
employee_id | string | ID พนักงาน |
fund_employee_no | string | เลขที่สมาชิกกองทุน |
fund_employee_date | string | วันที่เข้าร่วมกองทุน |
fund_employee_type | string | วิธีคำนวณหักพนักงาน |
fund_employee_rate | number | อัตราหักพนักงาน |
fund_company_type | string | วิธีคำนวณสมทบบริษัท |
fund_company_rate | number | อัตราสมทบบริษัท |
fund_employee_beneficiary | string | ชื่อผู้รับผลประโยชน์ |
fund_employee_remark | string | หมายเหตุ |
Error Responses
Missing required parameter (HTTP 400)
{
"code": 400,
"message": "Validation failed",
"errors": [
"Missing required parameter: 'fund_employee_id'"
]
}Fund record not found (HTTP 400)
{
"code": 400,
"message": "Fund employee record not found with ID: MjAyNjAyMTVGRTAxQTJCM0M0RDU="
}Validation Rules
| Field | Rule |
|---|---|
fund_employee_id | ต้องระบุ, ต้องเป็น Base64 encoded, ต้องมีข้อมูลในระบบ |
fund_employee_date | ถ้าระบุ ต้องเป็นรูปแบบ YYYY-MM-DD |
fund_employee_type | ถ้าระบุ ต้องเป็น 01, 02, หรือ 03 |
fund_company_type | ถ้าระบุ ต้องเป็น 01, 02, หรือ 03 |
Code Examples
cURL
curl -X POST "https://openapi.humansoft.co.th/api/v1/open-apis/employee/update-employee-financial?path_action=save-fund" \
-H "Content-Type: application/json" \
-H "Ocp-Apim-Subscription-Key: YOUR_API_KEY" \
-d '{
"fund_employee_id": "MjAyNjAyMTVGRTAxQTJCM0M0RDU=",
"fund_employee_no": "M002",
"fund_employee_rate": 5,
"fund_company_rate": 5,
"fund_employee_beneficiary": "นางสาวทดสอบ ระบบ (แก้ไข)"
}'Notes
- การเปลี่ยนอัตราหักจะมีผลตั้งแต่งวดเงินเดือนถัดไป
- ระบบสร้าง log tracking และ activity backlog อัตโนมัติ
Related APIs
- List Funds - ดึงรายการกองทุนทั้งหมด
- Get Fund - ดึงข้อมูลกองทุนตาม ID
- Add Fund - เพิ่มกองทุนให้พนักงาน
- Delete Fund - ลบกองทุน (ออกจากกองทุน)
- Pause Fund - เปิด/ปิดกองทุน
- Pull Back Fund - ดึงข้อมูลกองทุนกลับมาจาก log
Last updated on