Add Employee Financial
Router สำหรับเพิ่มข้อมูลการเงินพนักงาน รองรับการเรียกใช้งานแบบแยกเรื่องผ่าน path_action parameter
API นี้ใช้ Router Pattern - ระบุ path_action เพื่อเลือกประเภทข้อมูลการเงินที่ต้องการเพิ่ม
Endpoint
POST /api/v1/open-apis/employee/add-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 | Category |
|---|---|---|
constant | เพิ่มค่าคงที่ (รายรับ/รายจ่ายคงที่) | Income/Expense |
fund | เพิ่มกองทุนสำรองเลี้ยงชีพ | Fund |
welfare | เพิ่มสวัสดิการ | Benefits |
welfare-log | เพิ่มบันทึกการใช้สวัสดิการ | Benefits |
salary-auto-checked | เพิ่มเงินเดือนอัตโนมัติ | Salary |
work-insurance | เพิ่มประกันสังคม | Insurance |
Action Details
constant - เพิ่มค่าคงที่
เพิ่มรายรับหรือรายจ่ายคงที่ให้พนักงาน
| Parameter | Type | Required | Description |
|---|---|---|---|
salary_type_id | string | Yes | ID ประเภทเงินเดือน |
employee_constant_amt | number | Yes | จำนวนเงิน |
employee_constant_start_dt | string | No | วันที่เริ่ม (YYYY-MM-DD) |
employee_constant_end_dt | string | No | วันที่สิ้นสุด (YYYY-MM-DD) |
fund - เพิ่มกองทุนสำรองเลี้ยงชีพ
| Parameter | Type | Required | Description |
|---|---|---|---|
fund_id | string | Yes | ID กองทุน |
fund_employee_no | string | No | เลขสมาชิกกองทุน |
fund_employee_date | string | No | วันที่เข้ากองทุน |
fund_employee_type | string | No | ประเภทเงินสะสมพนักงาน |
fund_employee_rate | number | No | อัตราเงินสะสมพนักงาน (%) |
fund_company_type | string | No | ประเภทเงินสมทบบริษัท |
fund_company_rate | number | No | อัตราเงินสมทบบริษัท (%) |
welfare - เพิ่มสวัสดิการ
| Parameter | Type | Required | Description |
|---|---|---|---|
salary_type_id | string | Yes | ID ประเภทสวัสดิการ |
welfare_year | string | Yes | ปีสวัสดิการ |
welfare_prev_amt | number | No | ยอดยกมา |
welfare_quota_amt | number | No | วงเงินสวัสดิการ |
welfare-log - เพิ่มบันทึกการใช้สวัสดิการ
| Parameter | Type | Required | Description |
|---|---|---|---|
welfare_employee_id | string | Yes | ID สวัสดิการพนักงาน |
welfare_log_date | string | Yes | วันที่ใช้ (YYYY-MM-DD) |
welfare_log_amt | number | Yes | จำนวนเงินที่ใช้ |
welfare_log_remark | string | No | หมายเหตุ |
salary-auto-checked - เพิ่มเงินเดือนอัตโนมัติ
| Parameter | Type | Required | Description |
|---|---|---|---|
salary_type_id | string | Yes | ID ประเภทเงินเดือน |
work-insurance - เพิ่มประกันสังคม
| Parameter | Type | Required | Description |
|---|---|---|---|
master_salary_month | string | Yes | เดือนเงินเดือน (YYYY-MM) |
log_balance | number | No | ยอดคงเหลือ |
log_source | string | No | แหล่งที่มา |
Response Format
Success Response
{
"code": 200,
"message": "สำเร็จ",
"payload": {
"id": "20260121FC89F3BB9120"
}
}Error Response
{
"code": 400,
"message": "ข้อมูลไม่ถูกต้อง",
"errors": [
"กรุณาระบุ 'path_action'",
"กรุณาระบุ 'employee_code'"
]
}Code Examples
cURL
# เพิ่มค่าคงที่ (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
| Error | Solution |
|---|---|
| กรุณาระบุ ‘path_action’ | ต้องระบุ path_action ใน query parameter |
| กรุณาระบุ ‘employee_code’ | ต้องระบุ employee_code |
| ไม่พบไฟล์สำหรับ action | ตรวจสอบว่า path_action ตรงกับรายการที่รองรับ |
Related APIs
- Update Employee Financial - แก้ไขข้อมูลการเงิน
- Delete Employee Financial - ลบข้อมูลการเงิน
- Get Employee Info - ดึงข้อมูลพนักงาน (รวมข้อมูลการเงิน)
Last updated on