Skip to Content
🚀 Welcome to Humansoft Open API Documentation

Update Employee Financial

Router สำหรับแก้ไขข้อมูลการเงินพนักงาน รองรับการเรียกใช้งานแบบแยกเรื่องผ่าน path_action parameter

API นี้ใช้ Router Pattern - ระบุ path_action เพื่อเลือกประเภทข้อมูลการเงินที่ต้องการแก้ไข

Endpoint

POST /api/v1/open-apis/employee/update-employee-financial

Query Parameters

ParameterTypeRequiredDescription
path_actionstringYesประเภทข้อมูลที่ต้องการแก้ไข

Base Parameters

ParameterTypeRequiredDescription
employee_codestringYesรหัสพนักงาน

ใช้ employee_code เพื่อระบุพนักงาน

พารามิเตอร์ที่ลงท้ายด้วย _id ต้องส่งเป็น Base64-encoded ของ raw internal ID

  • Response จะ return raw string ID (เช่น 20260121FC89F3BB9120)
  • เมื่อนำ ID จาก response ไปใช้ใน request ถัดไป ต้อง encode เป็น Base64 ก่อน

Supported Actions

path_actionDescriptionRequired ID
constantแก้ไขค่าคงที่employee_constant_id
fundแก้ไขกองทุนemployee_fund_id
welfareแก้ไขสวัสดิการwelfare_employee_id
pause-fundหยุด/เปิดกองทุนemployee_fund_id
pull-back-fundดึงข้อมูลกองทุนกลับจาก logemployee_fund_id
salary-auto-checkedแก้ไขเงินเดือนอัตโนมัติsalary_auto_checked_id
save-tax-exceptionบันทึกรายการลดหย่อนภาษี-
fill-tax-exceptionเติมข้อมูลลดหย่อนภาษีจากปีก่อน-

Action Details

constant - แก้ไขค่าคงที่

ParameterTypeRequiredDescription
employee_constant_idstringYesID ของค่าคงที่
salary_type_idstringNoID ประเภทเงินเดือน
employee_constant_amtnumberNoจำนวนเงิน
employee_constant_start_dtstringNoวันที่เริ่ม
employee_constant_end_dtstringNoวันที่สิ้นสุด

fund - แก้ไขกองทุน

ParameterTypeRequiredDescription
fund_employee_idstringYesID ของกองทุน (Base64)
fund_employee_nostringNoเลขสมาชิกกองทุน
fund_employee_datestringNoวันที่เข้ากองทุน
fund_employee_ratenumberNoอัตราเงินสะสมพนักงาน (%)
fund_company_ratenumberNoอัตราเงินสมทบบริษัท (%)

welfare - แก้ไขสวัสดิการ

ParameterTypeRequiredDescription
welfare_employee_idstringYesID สวัสดิการพนักงาน
welfare_prev_amtnumberNoยอดยกมา
welfare_quota_amtnumberNoวงเงินสวัสดิการ

pause-fund - หยุด/เปิดกองทุน

ParameterTypeRequiredDescription
fund_idstringYesID ของกองทุน (Base64)

pull-back-fund - ดึงข้อมูลกองทุนกลับจาก log

ใช้ employee_code เป็นพารามิเตอร์หลัก

salary-auto-checked - แก้ไขเงินเดือนอัตโนมัติ

ParameterTypeRequiredDescription
salary_auto_checked_idstringYesID ของรายการ
checked_flagstringNoสถานะตรวจสอบ (Y/N)

Response Format

Success Response

{ "code": 200, "message": "สำเร็จ", "payload": { // ข้อมูลที่แก้ไขสำเร็จ } }

Error Response

{ "code": 400, "message": "ข้อมูลไม่ถูกต้อง", "errors": [ "กรุณาระบุ 'employee_constant_id'" ] }

Code Examples

# แก้ไขค่าคงที่ curl -X POST "https://openapi.humansoft.co.th/api/v1/open-apis/employee/update-employee-financial?path_action=constant" \ -H "Content-Type: application/json" \ -H "Ocp-Apim-Subscription-Key: YOUR_API_KEY" \ -d '{ "employee_code": "EMP001", "salary_type_id": "MjAyNjAxMjFGQzg5RjNCQjkxMjA=", "employee_constant_amt": 6000, "employee_constant_start_dt": "2024-01-01", "employee_constant_end_dt": "2024-12-31" }' # แก้ไขกองทุน curl -X POST "https://openapi.humansoft.co.th/api/v1/open-apis/employee/update-employee-financial?path_action=fund" \ -H "Content-Type: application/json" \ -H "Ocp-Apim-Subscription-Key: YOUR_API_KEY" \ -d '{ "employee_code": "EMP001", "fund_employee_id": "MjAyNjAxMjFGRTAxQzJEM0U0RjU=", "fund_employee_no": "M001", "fund_employee_rate": 5, "fund_company_rate": 5 }' # หยุดกองทุน curl -X POST "https://openapi.humansoft.co.th/api/v1/open-apis/employee/update-employee-financial?path_action=pause-fund" \ -H "Content-Type: application/json" \ -H "Ocp-Apim-Subscription-Key: YOUR_API_KEY" \ -d '{ "employee_code": "EMP001", "fund_id": "MjAyNjAxMjFGRDAxQTJCM0M0RDU=" }'

Troubleshooting

ErrorSolution
กรุณาระบุ ‘path_action’ต้องระบุ path_action ใน query parameter
กรุณาระบุ ‘employee_xxx_id’ต้องระบุ ID ของข้อมูลที่ต้องการแก้ไข
ไม่พบไฟล์สำหรับ actionตรวจสอบว่า path_action ตรงกับรายการที่รองรับ

Last updated on