Skip to Content
🚀 Welcome to Humansoft Open API Documentation

Add Employee Fund

เพิ่มกองทุนให้กับพนักงาน รองรับการคำนวณแบบเปอร์เซ็นต์ จำนวนเงินคงที่ และสูตรคำนวณ

Endpoint

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

Request Body

ParameterTypeRequiredDescription
employee_codestringYesรหัสพนักงาน
fund_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 ที่ส่งใน request ต้องเป็น Base64 encoded สามารถดู fund_id ได้จาก List Funds API


Response Format

Success Response

{ "code": 200, "message": "Add Fund Success", "payload": { "fund_employee_id": "20260215FE01A2B3C4D5", "employee_id": "20260215EM01A2B3C4D5", "employee_code": "EMP001", "fund_id": "20260215FD01A2B3C4D5", "fund_name": "กองทุนสำรองเลี้ยงชีพ", "fund_name_en": "Provident Fund", "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_remark": "", "log_tracking_id": "20260215LT01A2B3C4D5" } }

Response Fields

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

Error Responses

Validation failed (HTTP 400)

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

Employee already has fund (HTTP 400)

{ "code": 400, "message": "Employee already has this fund" }

Validation Rules

FieldRule
employee_codeต้องระบุ และต้องมีพนักงานในระบบ
fund_idต้องระบุ, ต้องเป็น Base64 encoded, ต้องมีกองทุนในระบบ
fund_employee_dateถ้าระบุ ต้องเป็นรูปแบบ YYYY-MM-DD
fund_employee_typeถ้าระบุ ต้องเป็น 01, 02, หรือ 03
fund_company_typeถ้าระบุ ต้องเป็น 01, 02, หรือ 03
Duplicate Checkพนักงานไม่สามารถสมัครกองทุนเดียวกันซ้ำได้

Code Examples

curl -X POST "https://openapi.humansoft.co.th/api/v1/open-apis/employee/add-employee-financial?path_action=fund" \ -H "Content-Type: application/json" \ -H "Ocp-Apim-Subscription-Key: YOUR_API_KEY" \ -d '{ "employee_code": "EMP001", "fund_id": "MjAyNjAxMjFGRDAxQTJCM0M0RDU=", "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": "นางสาวทดสอบ ระบบ" }'

Notes

  • ฟิลด์ที่ไม่ได้ระบุจะใช้ค่าเริ่มต้น: fund_employee_type = 01, fund_company_type = 01, fund_employee_rate = 0, fund_company_rate = 0
  • ระบบจะเริ่มติดตามยอดสะสมกองทุนหลังจากเพิ่มสำเร็จ
  • ระบบสร้าง log tracking และ activity backlog อัตโนมัติ

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