Add Employee Fund
เพิ่มกองทุนให้กับพนักงาน รองรับการคำนวณแบบเปอร์เซ็นต์ จำนวนเงินคงที่ และสูตรคำนวณ
Endpoint
POST /api/v1/open-apis/employee/add-employee-financial?path_action=fundRequest Body
| Parameter | Type | Required | Description |
|---|---|---|---|
employee_code | string | Yes | รหัสพนักงาน |
fund_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 ที่ส่งใน 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
| Field | Type | Description |
|---|---|---|
fund_employee_id | string | ID สมาชิกกองทุน |
employee_id | string | ID พนักงาน |
employee_code | string | รหัสพนักงาน |
fund_id | string | ID กองทุน |
fund_name | string | ชื่อกองทุน (ภาษาไทย) |
fund_name_en | string | ชื่อกองทุน (ภาษาอังกฤษ) |
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 | หมายเหตุ |
log_tracking_id | string | ID 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
| Field | Rule |
|---|---|
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
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 อัตโนมัติ
Related APIs
- List Funds - ดึงรายการกองทุนทั้งหมด
- Get Fund - ดึงข้อมูลกองทุนตาม ID
- Update Fund - แก้ไขข้อมูลกองทุน
- Delete Fund - ลบกองทุน (ออกจากกองทุน)
- Pause Fund - เปิด/ปิดกองทุน
- Pull Back Fund - ดึงข้อมูลกองทุนกลับมาจาก log
Last updated on