Skip to Content
🚀 Welcome to Humansoft Open API Documentation

Add Fund Log

เพิ่มรายการปรับปรุงกองทุนด้วยตนเอง สำหรับปรับปรุงยอดกองทุนพนักงานและ/หรือบริษัทในงวดที่ระบุ

Endpoint

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

Request Body

ParameterTypeRequiredDescriptionExample
employee_idstringYesID พนักงาน (Base64 encoded)
fund_idstringYesID กองทุน (Base64 encoded)
year_monthstringYesงวดเดือน (YYYY-MM)"2026-01"
log_balancenumberYes*มูลค่าปรับปรุงพนักงาน (ต้องไม่เท่ากับ 0)1000
log_balance_companynumberYes*มูลค่าปรับปรุงบริษัท (ต้องไม่เท่ากับ 0)1000
log_remarkstringNoหมายเหตุ"ปรับปรุงยอดกองทุน"

*ต้องระบุ log_balance หรือ log_balance_company อย่างน้อย 1 ค่า และต้องไม่เท่ากับ 0

  • ค่าบวก (+) = เพิ่มยอดกองทุน, ค่าลบ (-) = ลดยอดกองทุน
  • ยอดสะสมจะถูกคำนวณใหม่อัตโนมัติหลังจากเพิ่ม log

Validation Rules

RuleDescription
employee_idต้องเป็น Base64 encoded และมีอยู่ในระบบ
fund_idต้องเป็น Base64 encoded และมีอยู่ในระบบ
year_monthต้องเป็นรูปแบบ YYYY-MM
Balancelog_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

FieldTypeDescription
employee_idstringID พนักงาน (plain text)
fund_idstringID กองทุน (plain text)
year_monthstringงวดเดือน (YYYY-MM)
log_datetimestringวันเวลาที่บันทึก log
log_remarkstringหมายเหตุ
employee_logobject|nullข้อมูล log พนักงาน (null ถ้าไม่มี)
employee_log.log_balancenumberมูลค่าปรับปรุงพนักงาน
employee_log.log_sourcestringแหล่งที่มา: Manual
company_logobject|nullข้อมูล log บริษัท (null ถ้าไม่มี)
company_log.log_balancenumberมูลค่าปรับปรุงบริษัท
company_log.log_sourcestringแหล่งที่มา: Manual
log_tracking_idstringID log tracking

Error Response

{ "code": 400, "message": "Validation failed", "errors": [ "'log_balance' and 'log_balance_company' cannot both be zero" ] }
HTTP StatusDescription
400พารามิเตอร์ไม่ถูกต้อง หรือ balance เป็น 0 ทั้งคู่
401API Key ไม่ถูกต้องหรือไม่ได้ส่ง

Code Examples

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

  • List Funds - ดูรายการกองทุนทั้งหมด
  • Get Fund - ดูข้อมูลกองทุนตาม ID
  • Delete Fund Log - ลบรายการปรับปรุงกองทุนพนักงาน
  • Delete Company Fund Log - ลบรายการปรับปรุงกองทุนบริษัท
Last updated on