Add Fund Log
เพิ่มรายการปรับปรุงกองทุนด้วยตนเอง สำหรับปรับปรุงยอดกองทุนพนักงานและ/หรือบริษัทในงวดที่ระบุ
Endpoint
POST /api/v1/open-apis/employee/add-employee-financial?path_action=fund-logRequest Body
| Parameter | Type | Required | Description | Example |
|---|---|---|---|---|
employee_id | string | Yes | ID พนักงาน (Base64 encoded) | |
fund_id | string | Yes | ID กองทุน (Base64 encoded) | |
year_month | string | Yes | งวดเดือน (YYYY-MM) | "2026-01" |
log_balance | number | Yes* | มูลค่าปรับปรุงพนักงาน (ต้องไม่เท่ากับ 0) | 1000 |
log_balance_company | number | Yes* | มูลค่าปรับปรุงบริษัท (ต้องไม่เท่ากับ 0) | 1000 |
log_remark | string | No | หมายเหตุ | "ปรับปรุงยอดกองทุน" |
*ต้องระบุ log_balance หรือ log_balance_company อย่างน้อย 1 ค่า และต้องไม่เท่ากับ 0
- ค่าบวก (+) = เพิ่มยอดกองทุน, ค่าลบ (-) = ลดยอดกองทุน
- ยอดสะสมจะถูกคำนวณใหม่อัตโนมัติหลังจากเพิ่ม log
Validation Rules
| Rule | Description |
|---|---|
employee_id | ต้องเป็น Base64 encoded และมีอยู่ในระบบ |
fund_id | ต้องเป็น Base64 encoded และมีอยู่ในระบบ |
year_month | ต้องเป็นรูปแบบ YYYY-MM |
| Balance | log_balance หรือ log_balance_company อย่างน้อย 1 ค่า ต้องไม่เท่ากับ 0 |
Response Format
Success Response
{
"code": 200,
"message": "Add Employee Fund Log Success",
"payload": {
"employee_id": "20260215EM01A2B3C4D5",
"fund_id": "20260215FD01A2B3C4D5",
"year_month": "2026-01",
"log_datetime": "2026-01-01 08:00:00",
"log_remark": "ปรับปรุงยอดกองทุน",
"employee_log": {
"log_balance": 1000,
"log_datetime": "2026-01-01 08:00:00",
"log_source": "Manual"
},
"company_log": {
"log_balance": 1000,
"log_datetime": "2026-01-01 08:00:00",
"log_source": "Manual"
},
"log_tracking_id": "20260215LT01A2B3C4D5"
}
}Response Fields
| Field | Type | Description |
|---|---|---|
employee_id | string | ID พนักงาน (plain text) |
fund_id | string | ID กองทุน (plain text) |
year_month | string | งวดเดือน (YYYY-MM) |
log_datetime | string | วันเวลาที่บันทึก log |
log_remark | string | หมายเหตุ |
employee_log | object|null | ข้อมูล log พนักงาน (null ถ้าไม่มี) |
employee_log.log_balance | number | มูลค่าปรับปรุงพนักงาน |
employee_log.log_source | string | แหล่งที่มา: Manual |
company_log | object|null | ข้อมูล log บริษัท (null ถ้าไม่มี) |
company_log.log_balance | number | มูลค่าปรับปรุงบริษัท |
company_log.log_source | string | แหล่งที่มา: Manual |
log_tracking_id | string | ID log tracking |
Error Response
{
"code": 400,
"message": "Validation failed",
"errors": [
"'log_balance' and 'log_balance_company' cannot both be zero"
]
}| HTTP Status | Description |
|---|---|
400 | พารามิเตอร์ไม่ถูกต้อง หรือ balance เป็น 0 ทั้งคู่ |
401 | API Key ไม่ถูกต้องหรือไม่ได้ส่ง |
Code Examples
cURL
curl -X POST "https://openapi.humansoft.co.th/api/v1/open-apis/employee/add-employee-financial?path_action=fund-log" \
-H "Ocp-Apim-Subscription-Key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"employee_id": "MjAyNjAyMTVFTTAxQTJCM0M0RDU=",
"fund_id": "MjAyNjAyMTVGRDAxQTJCM0M0RDU=",
"year_month": "2026-01",
"log_balance": 1000,
"log_balance_company": 1000,
"log_remark": "ปรับปรุงยอดกองทุน"
}'Notes
- ใช้สำหรับปรับปรุงยอดกองทุนด้วยตนเอง (Manual Adjustment)
- รายการที่เพิ่มจะมี
log_sourceเป็นManual - สามารถลบรายการที่เพิ่มด้วยตนเองได้ผ่าน Delete Fund Log หรือ Delete Company Fund Log
Related APIs
- List Funds - ดูรายการกองทุนทั้งหมด
- Get Fund - ดูข้อมูลกองทุนตาม ID
- Delete Fund Log - ลบรายการปรับปรุงกองทุนพนักงาน
- Delete Company Fund Log - ลบรายการปรับปรุงกองทุนบริษัท
Last updated on