Update Salary Auto Checked
บันทึก/แก้ไขรายการรายรับ/รายจ่ายอัตโนมัติของพนักงาน (Batch Update) โดยจะลบรายการเดิมทั้งหมดแล้วสร้างใหม่ตามที่ส่งมา
Endpoint
POST /api/v1/open-apis/employee/update-employee-financial?path_action=salary-auto-checkedAPI นี้จะลบรายการอัตโนมัติเดิมทั้งหมดของพนักงาน แล้วสร้างใหม่ตาม salaryTypeLists ที่ส่งมา (Replace All)
Request Body
| Parameter | Type | Required | Description |
|---|---|---|---|
employee_code | string | Yes | รหัสพนักงาน |
employeeLists | array | Yes | รายการพนักงานและรายการอัตโนมัติ |
employeeLists[].employee_id | string | Yes | ID พนักงาน (Base64 encoded) |
employeeLists[].salaryTypeLists | array | Yes | รายการ salary_type ที่ต้องการเปิด |
employeeLists[].salaryTypeLists[].id | string | Yes | ID salary_type (Base64 encoded) |
Validation Rules
| Rule | Description |
|---|---|
employee_code | ต้องมีอยู่ในระบบ |
employeeLists | ต้องเป็น array ที่ไม่ว่าง |
employeeLists[].employee_id | ต้องเป็น Base64 encoded |
salaryTypeLists[].id | ต้องเป็น Base64 encoded |
Response Format
Success Response
{
"code": 200,
"message": "Update Auto Checked Success",
"payload": {
"employee_id": "20260215EM01A2B3C4D5",
"employee_code": "EMP001",
"saved_items_count": 3,
"saved_items": [
"20260215ST01A2B3C4D5",
"20260215ST02E3F4A5B6",
"20260215ST03F4G5B6C7"
]
}
}Response Fields
| Field | Type | Description |
|---|---|---|
employee_id | string | ID พนักงาน (plain text) |
employee_code | string | รหัสพนักงาน |
saved_items_count | number | จำนวนรายการที่บันทึก |
saved_items | array | รายการ salary_type_id ที่บันทึก (plain text) |
Error Response
{
"code": 400,
"message": "Validation failed",
"errors": [
"Missing or invalid parameter: 'employeeLists' (must be non-empty array)"
]
}| HTTP Status | Description |
|---|---|
400 | พารามิเตอร์ไม่ถูกต้อง |
401 | API Key ไม่ถูกต้องหรือไม่ได้ส่ง |
Code Examples
cURL
curl -X POST "https://openapi.humansoft.co.th/api/v1/open-apis/employee/update-employee-financial?path_action=salary-auto-checked" \
-H "Ocp-Apim-Subscription-Key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"employee_code": "EMP001",
"employeeLists": [
{
"employee_id": "MjAyNjAyMTVFTTAxQTJCM0M0RDU=",
"salaryTypeLists": [
{ "id": "MjAyNjAyMTVTVDAxQTJCM0M0RDU=" },
{ "id": "MjAyNjAyMTVTVDAyRTNGNEE1QjY=" },
{ "id": "MjAyNjAyMTVTVDAzRjRHNUI2Qzc=" }
]
}
]
}'Notes
ประเภทรายรับ/รายจ่ายอัตโนมัติที่ใช้บ่อย เช่น ประกันสังคม (SSO), ภาษี (Tax), ภาษีหัก ณ ที่จ่าย (Withholding Tax) สามารถดู salary_type_id ได้จาก List Salary Auto Checked API
Related APIs
- List Salary Auto Checked - ดูรายการอัตโนมัติทั้งหมด
- Get Salary Auto Checked - ดูข้อมูลรายการอัตโนมัติตาม ID
- Add Salary Auto Checked - เพิ่มรายการอัตโนมัติ (ทีละรายการ)
- Delete Salary Auto Checked - ลบรายการอัตโนมัติ
Last updated on