Update Employee Financial
Router สำหรับแก้ไขข้อมูลการเงินพนักงาน รองรับการเรียกใช้งานแบบแยกเรื่องผ่าน path_action parameter
API นี้ใช้ Router Pattern - ระบุ path_action เพื่อเลือกประเภทข้อมูลการเงินที่ต้องการแก้ไข
Endpoint
POST /api/v1/open-apis/employee/update-employee-financialQuery Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
path_action | string | Yes | ประเภทข้อมูลที่ต้องการแก้ไข |
Base Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
employee_code | string | Yes | รหัสพนักงาน |
ใช้ employee_code เพื่อระบุพนักงาน
พารามิเตอร์ที่ลงท้ายด้วย _id ต้องส่งเป็น Base64-encoded ของ raw internal ID
- Response จะ return raw string ID (เช่น
20260121FC89F3BB9120) - เมื่อนำ ID จาก response ไปใช้ใน request ถัดไป ต้อง encode เป็น Base64 ก่อน
Supported Actions
| path_action | Description | Required ID |
|---|---|---|
constant | แก้ไขค่าคงที่ | employee_constant_id |
fund | แก้ไขกองทุน | employee_fund_id |
welfare | แก้ไขสวัสดิการ | welfare_employee_id |
pause-fund | หยุด/เปิดกองทุน | employee_fund_id |
pull-back-fund | ดึงข้อมูลกองทุนกลับจาก log | employee_fund_id |
salary-auto-checked | แก้ไขเงินเดือนอัตโนมัติ | salary_auto_checked_id |
save-tax-exception | บันทึกรายการลดหย่อนภาษี | - |
fill-tax-exception | เติมข้อมูลลดหย่อนภาษีจากปีก่อน | - |
Action Details
constant - แก้ไขค่าคงที่
| Parameter | Type | Required | Description |
|---|---|---|---|
employee_constant_id | string | Yes | ID ของค่าคงที่ |
salary_type_id | string | No | ID ประเภทเงินเดือน |
employee_constant_amt | number | No | จำนวนเงิน |
employee_constant_start_dt | string | No | วันที่เริ่ม |
employee_constant_end_dt | string | No | วันที่สิ้นสุด |
fund - แก้ไขกองทุน
| Parameter | Type | Required | Description |
|---|---|---|---|
fund_employee_id | string | Yes | ID ของกองทุน (Base64) |
fund_employee_no | string | No | เลขสมาชิกกองทุน |
fund_employee_date | string | No | วันที่เข้ากองทุน |
fund_employee_rate | number | No | อัตราเงินสะสมพนักงาน (%) |
fund_company_rate | number | No | อัตราเงินสมทบบริษัท (%) |
welfare - แก้ไขสวัสดิการ
| Parameter | Type | Required | Description |
|---|---|---|---|
welfare_employee_id | string | Yes | ID สวัสดิการพนักงาน |
welfare_prev_amt | number | No | ยอดยกมา |
welfare_quota_amt | number | No | วงเงินสวัสดิการ |
pause-fund - หยุด/เปิดกองทุน
| Parameter | Type | Required | Description |
|---|---|---|---|
fund_id | string | Yes | ID ของกองทุน (Base64) |
pull-back-fund - ดึงข้อมูลกองทุนกลับจาก log
ใช้ employee_code เป็นพารามิเตอร์หลัก
salary-auto-checked - แก้ไขเงินเดือนอัตโนมัติ
| Parameter | Type | Required | Description |
|---|---|---|---|
salary_auto_checked_id | string | Yes | ID ของรายการ |
checked_flag | string | No | สถานะตรวจสอบ (Y/N) |
Response Format
Success Response
{
"code": 200,
"message": "สำเร็จ",
"payload": {
// ข้อมูลที่แก้ไขสำเร็จ
}
}Error Response
{
"code": 400,
"message": "ข้อมูลไม่ถูกต้อง",
"errors": [
"กรุณาระบุ 'employee_constant_id'"
]
}Code Examples
cURL
# แก้ไขค่าคงที่
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
| Error | Solution |
|---|---|
| กรุณาระบุ ‘path_action’ | ต้องระบุ path_action ใน query parameter |
| กรุณาระบุ ‘employee_xxx_id’ | ต้องระบุ ID ของข้อมูลที่ต้องการแก้ไข |
| ไม่พบไฟล์สำหรับ action | ตรวจสอบว่า path_action ตรงกับรายการที่รองรับ |
Related APIs
- Add Employee Financial - เพิ่มข้อมูลการเงิน
- Delete Employee Financial - ลบข้อมูลการเงิน
- Get Employee Info - ดึงข้อมูลพนักงาน
Last updated on