Skip to Content
🚀 Welcome to Humansoft Open API Documentation

Update Employee Fund

แก้ไขข้อมูลกองทุนของพนักงาน เช่น เลขที่สมาชิก อัตราหัก ผู้รับผลประโยชน์ และหมายเหตุ

Endpoint

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

Request Body

ParameterTypeRequiredDescription
fund_employee_idstringYesID สมาชิกกองทุน (Base64 encoded)
fund_employee_nostringNoเลขที่สมาชิกกองทุน
fund_employee_datestringNoวันที่เข้าร่วมกองทุน (YYYY-MM-DD)
fund_employee_typestringNoวิธีคำนวณหักพนักงาน: 01 = เปอร์เซ็นต์, 02 = จำนวนเงินคงที่, 03 = สูตรคำนวณ
fund_employee_ratenumberNoอัตราหักพนักงาน
fund_company_typestringNoวิธีคำนวณสมทบบริษัท: 01 = เปอร์เซ็นต์, 02 = จำนวนเงินคงที่, 03 = สูตรคำนวณ
fund_company_ratenumberNoอัตราสมทบบริษัท
fund_employee_beneficiarystringNoชื่อผู้รับผลประโยชน์
fund_employee_remarkstringNoหมายเหตุ

สามารถส่งเฉพาะฟิลด์ที่ต้องการแก้ไข ฟิลด์อื่นจะคงค่าเดิม ไม่สามารถเปลี่ยน 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

FieldTypeDescription
fund_employee_idstringID สมาชิกกองทุน
fund_idstringID กองทุน
employee_idstringID พนักงาน
fund_employee_nostringเลขที่สมาชิกกองทุน
fund_employee_datestringวันที่เข้าร่วมกองทุน
fund_employee_typestringวิธีคำนวณหักพนักงาน
fund_employee_ratenumberอัตราหักพนักงาน
fund_company_typestringวิธีคำนวณสมทบบริษัท
fund_company_ratenumberอัตราสมทบบริษัท
fund_employee_beneficiarystringชื่อผู้รับผลประโยชน์
fund_employee_remarkstringหมายเหตุ

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

FieldRule
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 -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 อัตโนมัติ

  • List Funds - ดึงรายการกองทุนทั้งหมด
  • Get Fund - ดึงข้อมูลกองทุนตาม ID
  • Add Fund - เพิ่มกองทุนให้พนักงาน
  • Delete Fund - ลบกองทุน (ออกจากกองทุน)
  • Pause Fund - เปิด/ปิดกองทุน
  • Pull Back Fund - ดึงข้อมูลกองทุนกลับมาจาก log
Last updated on