Skip to Content
🚀 Welcome to Humansoft Open API Documentation

Add Employee Financial

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

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

Endpoint

POST /api/v1/open-apis/employee/add-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_actionDescriptionCategory
constantเพิ่มค่าคงที่ (รายรับ/รายจ่ายคงที่)Income/Expense
fundเพิ่มกองทุนสำรองเลี้ยงชีพFund
welfareเพิ่มสวัสดิการBenefits
welfare-logเพิ่มบันทึกการใช้สวัสดิการBenefits
salary-auto-checkedเพิ่มเงินเดือนอัตโนมัติSalary
work-insuranceเพิ่มประกันสังคมInsurance

Action Details

constant - เพิ่มค่าคงที่

เพิ่มรายรับหรือรายจ่ายคงที่ให้พนักงาน

ParameterTypeRequiredDescription
salary_type_idstringYesID ประเภทเงินเดือน
employee_constant_amtnumberYesจำนวนเงิน
employee_constant_start_dtstringNoวันที่เริ่ม (YYYY-MM-DD)
employee_constant_end_dtstringNoวันที่สิ้นสุด (YYYY-MM-DD)

fund - เพิ่มกองทุนสำรองเลี้ยงชีพ

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

welfare - เพิ่มสวัสดิการ

ParameterTypeRequiredDescription
salary_type_idstringYesID ประเภทสวัสดิการ
welfare_yearstringYesปีสวัสดิการ
welfare_prev_amtnumberNoยอดยกมา
welfare_quota_amtnumberNoวงเงินสวัสดิการ

welfare-log - เพิ่มบันทึกการใช้สวัสดิการ

ParameterTypeRequiredDescription
welfare_employee_idstringYesID สวัสดิการพนักงาน
welfare_log_datestringYesวันที่ใช้ (YYYY-MM-DD)
welfare_log_amtnumberYesจำนวนเงินที่ใช้
welfare_log_remarkstringNoหมายเหตุ

salary-auto-checked - เพิ่มเงินเดือนอัตโนมัติ

ParameterTypeRequiredDescription
salary_type_idstringYesID ประเภทเงินเดือน

work-insurance - เพิ่มประกันสังคม

ParameterTypeRequiredDescription
master_salary_monthstringYesเดือนเงินเดือน (YYYY-MM)
log_balancenumberNoยอดคงเหลือ
log_sourcestringNoแหล่งที่มา

Response Format

Success Response

{ "code": 200, "message": "สำเร็จ", "payload": { "id": "20260121FC89F3BB9120" } }

Error Response

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

Code Examples

# เพิ่มค่าคงที่ (Constant) curl -X POST "https://openapi.humansoft.co.th/api/v1/open-apis/employee/add-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": "MjAyNjAxMjFGQzg5RjNCQjk1NTU=", "employee_constant_amt": 5000, "employee_constant_start_dt": "2024-01-01", "employee_constant_end_dt": "2024-12-31" }' # เพิ่มกองทุน (Fund) 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": "MjAyNjAxMjFGQzg5RjNCQjk1NTU=", "fund_employee_no": "M001", "fund_employee_date": "2024-01-15", "fund_employee_rate": 3, "fund_company_rate": 3 }' # เพิ่มสวัสดิการ (Welfare) curl -X POST "https://openapi.humansoft.co.th/api/v1/open-apis/employee/add-employee-financial?path_action=welfare" \ -H "Content-Type: application/json" \ -H "Ocp-Apim-Subscription-Key: YOUR_API_KEY" \ -d '{ "employee_code": "EMP001", "salary_type_id": "MjAyNjAxMjFGQzg5RjNCQjk1NTU=", "welfare_year": "2026", "welfare_quota_amt": 10000 }' # เพิ่มบันทึกการใช้สวัสดิการ (Welfare Log) curl -X POST "https://openapi.humansoft.co.th/api/v1/open-apis/employee/add-employee-financial?path_action=welfare-log" \ -H "Content-Type: application/json" \ -H "Ocp-Apim-Subscription-Key: YOUR_API_KEY" \ -d '{ "employee_code": "EMP001", "welfare_employee_id": "MjAyNjAxMjFXRTAxQjJDM0Q0RTU=", "welfare_log_date": "2024-06-15", "welfare_log_amt": 5000, "welfare_log_remark": "ใช้สวัสดิการรักษาพยาบาล" }'

Troubleshooting

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

Last updated on