Save Employee Salary Auto Checked
บันทึกรายการรายรับ/รายจ่ายอัตโนมัติของพนักงานแบบ Batch โดยจะลบรายการเดิมทั้งหมดและเพิ่มรายการใหม่ที่ส่งมา
การบันทึกจะลบรายการเดิมทั้งหมดของพนักงานและเพิ่มเฉพาะรายการที่ส่งมาใหม่ ตรวจสอบให้แน่ใจว่าส่งรายการที่ต้องการทั้งหมด
Endpoint
POST /api/v1/open-apis/employee/update-employee-financial?path_action=save-salary-auto-checkedQuery Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
path_action | string | Yes | ต้องเป็น save-salary-auto-checked |
Request Body
| Parameter | Type | Required | Description |
|---|---|---|---|
employee_code | string | Yes | รหัสพนักงาน (plain text) |
salary_type_lists | array | Yes | รายการประเภทเงินเดือนอัตโนมัติ |
salary_type_lists[].salary_type_id | string | Yes | ID ของประเภทเงินเดือน (Base64 encoded) |
Response Format
Success Response
{
"code": 200,
"message": "Update Auto Checked Success",
"payload": {
"employee_id": "20260121EM01A2B3C4D5",
"employee_code": "EMP001",
"saved_items_count": 2,
"saved_items": [
{
"employee_auto_checked_id": "20260121AC01A2B3C4D5",
"salary_type_id": "20260121ST01A2B3C4D5"
},
{
"employee_auto_checked_id": "20260121AC02E3F4A5B6",
"salary_type_id": "20260121ST02E3F4A5B6"
}
]
}
}Response Fields
| Field | Type | Description |
|---|---|---|
employee_id | string | ID ของพนักงาน (plain text) |
employee_code | string | รหัสพนักงาน |
saved_items_count | number | จำนวนรายการที่บันทึก |
saved_items | array | รายการที่บันทึกทั้งหมด |
saved_items[].employee_auto_checked_id | string | ID รายการอัตโนมัติ (plain text) |
saved_items[].salary_type_id | string | ID ประเภทรายรับ/รายจ่าย (plain text) |
Error Response
{
"code": 400,
"message": "Validation failed",
"errors": [
"Missing required parameter: 'employee_code'"
]
}Validation Rules
| Field | Rule |
|---|---|
employee_code | ต้องระบุและต้องมีพนักงานในระบบ |
salary_type_lists | ต้องระบุเป็น array ที่มี salary_type_id |
salary_type_lists[].salary_type_id | ต้อง encode เป็น Base64 และต้องมีในระบบ |
Code Examples
cURL
curl -X POST "https://openapi.humansoft.co.th/api/v1/open-apis/employee/update-employee-financial?path_action=save-salary-auto-checked" \
-H "Content-Type: application/json" \
-H "Ocp-Apim-Subscription-Key: YOUR_API_KEY" \
-d '{
"employee_code": "EMP001",
"salary_type_lists": [
{"salary_type_id": "MjAyNjAxMjFTVDAxQTJCM0M0RDU="},
{"salary_type_id": "MjAyNjAxMjFTVDAyRTNGNEE1QjY="}
]
}'Notes
- Endpoint นี้ทำงานแบบ Batch: ลบรายการเดิมทั้งหมดของพนักงาน แล้วเพิ่มเฉพาะรายการที่ส่งมาใหม่
- หากต้องการเพิ่มทีละรายการโดยไม่กระทบรายการเดิม ให้ใช้ Add Salary Auto Checked แทน
salary_type_idในsalary_type_listsต้อง encode เป็น Base64- ฟิลด์
_idใน response เป็น plain text ไม่ได้ encode Base64 - การเปลี่ยนแปลงจะมีผลในการคำนวณเงินเดือนงวดถัดไป
Related APIs
- List Salary Auto Checked - ดึงรายการอัตโนมัติทั้งหมด
- Get Salary Auto Checked - ดึงข้อมูลรายการอัตโนมัติตาม ID
- Add Salary Auto Checked - เพิ่มรายการอัตโนมัติ (ทีละรายการ)
- Delete Salary Auto Checked - ลบรายการอัตโนมัติ
Last updated on