Update Employee
แก้ไขข้อมูลพนักงานผ่าน Router Pattern โดยใช้ path_action เพื่อระบุประเภทการดำเนินการ รองรับการจัดการข้อมูล 3 หมวด: Setting, Profile และ Financial
API นี้ใช้ Router Pattern โดยส่ง path_action เพื่อระบุว่าต้องการดำเนินการอะไร เช่น add-family, save-work-cycle, delete-constant
Endpoint
POST /api/v1/open-apis/employee/update-employeeRequest Body
Common Parameters
| Parameter | Type | Required | Description | Example |
|---|---|---|---|---|
path_action | string | Yes | ประเภทการดำเนินการ | add-family |
employee_code | string | Yes | รหัสพนักงาน | EMP001 |
ใช้ employee_code เพื่อระบุพนักงาน
พารามิเตอร์ที่ลงท้ายด้วย _id ต้องส่งเป็น Base64-encoded ของ raw internal ID
- Response จะ return raw string ID (เช่น
20260121FC89F3BB9120) - เมื่อนำ ID จาก response ไปใช้ใน request ถัดไป ต้อง encode เป็น Base64 ก่อน
Parameter อื่นๆ จะแตกต่างกันตาม path_action ที่เลือก ดูรายละเอียดในแต่ละหมวดด้านล่าง
path_action Reference
Setting Operations
การจัดการการตั้งค่าพนักงาน:
| path_action | Operation | Description |
|---|---|---|
add-user | Create | สร้างบัญชีผู้ใช้งาน |
delete-user | Delete | ลบบัญชีผู้ใช้งาน |
reset-user-username | Update | รีเซ็ตชื่อผู้ใช้ |
reset-user-password | Update | รีเซ็ตรหัสผ่าน |
save-user-groups | Update | อัพเดตกลุ่มผู้ใช้งาน |
add-facial | Create | เพิ่มข้อมูลใบหน้า |
delete-facial | Delete | ลบข้อมูลใบหน้า |
save-basic | Update | บันทึกข้อมูลพื้นฐาน |
save-approver | Update | บันทึกผู้อนุมัติ |
save-work-cycle | Update | บันทึกกะการทำงาน |
save-holiday | Update | บันทึกวันหยุด |
save-ot | Update | บันทึกประเภท OT |
save-quota | Update | บันทึกโควตาการลา |
add-actual-quota | Create | เพิ่มโควตาจริง |
delete-actual-quota | Delete | ลบโควตาจริง |
Profile Operations
การจัดการข้อมูลส่วนตัว:
| path_action | Operation | Description |
|---|---|---|
add-family | Create | เพิ่มข้อมูลครอบครัว |
save-family | Update | บันทึกข้อมูลครอบครัว |
delete-family | Delete | ลบข้อมูลครอบครัว |
add-work | Create | เพิ่มประวัติการทำงาน |
save-work | Update | บันทึกประวัติการทำงาน |
delete-work | Delete | ลบประวัติการทำงาน |
add-education | Create | เพิ่มประวัติการศึกษา |
save-education | Update | บันทึกประวัติการศึกษา |
delete-education | Delete | ลบประวัติการศึกษา |
add-ability | Create | เพิ่มความสามารถพิเศษ |
save-ability | Update | บันทึกความสามารถพิเศษ |
delete-ability | Delete | ลบความสามารถพิเศษ |
add-language-skill | Create | เพิ่มทักษะภาษา |
save-language-skill | Update | บันทึกทักษะภาษา |
delete-language-skill | Delete | ลบทักษะภาษา |
add-typing-skill | Create | เพิ่มทักษะพิมพ์ดีด |
save-typing-skill | Update | บันทึกทักษะพิมพ์ดีด |
delete-typing-skill | Delete | ลบทักษะพิมพ์ดีด |
add-driving-skill | Create | เพิ่มทักษะขับขี่ |
save-driving-skill | Update | บันทึกทักษะขับขี่ |
delete-driving-skill | Delete | ลบทักษะขับขี่ |
add-training | Create | เพิ่มประวัติฝึกอบรม |
save-training | Update | บันทึกประวัติฝึกอบรม |
delete-training | Delete | ลบประวัติฝึกอบรม |
add-possess | Create | เพิ่มทรัพย์สิน |
save-possess | Update | บันทึกทรัพย์สิน |
delete-possess | Delete | ลบทรัพย์สิน |
add-hospital | Create | เพิ่มโรงพยาบาล |
save-hospital | Update | บันทึกโรงพยาบาล |
delete-hospital | Delete | ลบโรงพยาบาล |
add-document | Create | เพิ่มเอกสาร |
save-document | Update | บันทึกเอกสาร |
delete-document | Delete | ลบเอกสาร |
save-address | Update | บันทึกที่อยู่ |
Financial Operations
การจัดการข้อมูลการเงิน:
| path_action | Operation | Description |
|---|---|---|
add-constant | Create | เพิ่มรายรับ/รายจ่ายคงที่ |
save-constant | Update | บันทึกรายรับ/รายจ่ายคงที่ |
delete-constant | Delete | ลบรายรับ/รายจ่ายคงที่ |
add-fund | Create | เพิ่มกองทุน |
save-fund | Update | บันทึกกองทุน |
pause-fund | Update | เปิด/ปิดกองทุน (สลับสถานะ) |
pull-back-fund | Update | ดึงข้อมูลกองทุนกลับมาจาก log |
delete-fund | Delete | ลบกองทุน |
add-welfare | Create | เพิ่มสวัสดิการ |
save-welfare | Update | บันทึกสวัสดิการ |
delete-welfare | Delete | ลบสวัสดิการ |
add-work-insurance | Create | เพิ่มประกันสังคม |
delete-work-insurance | Delete | ลบประกันสังคม |
add-salary-auto-checked | Create | เพิ่มรายการตรวจสอบเงินเดือน |
save-salary-auto-checked | Update | บันทึกรายการตรวจสอบเงินเดือน |
delete-salary-auto-checked | Delete | ลบรายการตรวจสอบเงินเดือน |
save-tax-exception | Update | บันทึกรายการลดหย่อนภาษี |
fill-tax-exception | Update | เติมข้อมูลลดหย่อนภาษีจากปีก่อน |
delete-tax | Delete | ลบข้อมูลภาษีทั้งปี |
Manage Operations
การจัดการสถานะพนักงาน:
| path_action | Operation | Description |
|---|---|---|
sign-out | Update | บันทึกการลาออกของพนักงาน |
get-resign-doc | Read | ดึงเอกสารลาออก (PDF) |
reactive | Update | เปิดใช้งานพนักงานที่ลาออกอีกครั้ง |
Examples by Category
Example 1: Add Family Member
{
"path_action": "add-family",
"employee_code": "EMP001",
"relation_type": "01",
"family_name": "สมศักดิ์",
"family_last_name": "ใจดี",
"family_id_no": "1234567890123",
"family_birthday": "1960-05-15",
"family_mobile": "0811112222"
}relation_type Values:
| Code | Description |
|---|---|
01 | บิดา (Father) |
02 | มารดา (Mother) |
03 | คู่สมรส (Spouse) |
04 | บุตร (Child) |
05 | ผู้ติดต่อฉุกเฉิน (Emergency Contact) |
Example 2: Save Work Cycle
{
"path_action": "save-work-cycle",
"employee_code": "EMP001",
"work_cycle_data": {
"Mon": { "work_cycle_id": "MjAyNTExMjhEMUZBQURDNUQzNDg=", "active": true },
"Tue": { "work_cycle_id": "MjAyNTExMjhEMUZBQURDNUQzNDg=", "active": true },
"Wed": { "work_cycle_id": "MjAyNTExMjhEMUZBQURDNUQzNDg=", "active": true },
"Thu": { "work_cycle_id": "MjAyNTExMjhEMUZBQURDNUQzNDg=", "active": true },
"Fri": { "work_cycle_id": "MjAyNTExMjhEMUZBQURDNUQzNDg=", "active": true },
"Sat": { "work_cycle_id": null, "active": false },
"Sun": { "work_cycle_id": null, "active": false }
}
}Example 3: Add Constant (Salary)
{
"path_action": "add-constant",
"employee_code": "EMP001",
"salary_type_id": "MjAyNTExMjhEMUZBQURDNUQzNDg=",
"employee_constant_amt": 5000,
"employee_constant_start_dt": "2026-01-01",
"employee_constant_end_dt": "2026-12-31"
}Example 4: Reset User Password
{
"path_action": "reset-user-password",
"employee_code": "EMP001",
"new_password": "newSecurePassword123"
}Example 5: Delete Family Member
{
"path_action": "delete-family",
"employee_family_id": "MjAyNTExMjhEMUZBQURDNUQzNDg="
}Response Format
Success Response (HTTP 200)
{
"code": 200,
"message": "Add Family Success",
"payload": {
"employee_family_id": "20251128D1FAADC5D348",
"relation_type": "04",
"family_name": "สมชาย",
"family_last_name": "ใจดี"
}
}Error Response (HTTP 400)
{
"code": 400,
"message": "ข้อมูลไม่ถูกต้อง",
"errors": [
"กรุณาระบุ 'path_action'"
]
}Code Examples
cURL
# เพิ่มข้อมูลครอบครัว
curl -X POST "https://openapi.humansoft.co.th/api/v1/open-apis/employee/update-employee" \
-H "Ocp-Apim-Subscription-Key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"path_action": "add-family",
"employee_code": "EMP001",
"relation_type": "01",
"family_name": "สมศักดิ์",
"family_last_name": "ใจดี"
}'
# บันทึกกะการทำงาน
curl -X POST "https://openapi.humansoft.co.th/api/v1/open-apis/employee/update-employee" \
-H "Ocp-Apim-Subscription-Key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"path_action": "save-work-cycle",
"employee_code": "EMP001",
"work_cycle_data": {
"Mon": { "work_cycle_id": "MjAyNTExMjhEMUZBQURDNUQzNDg=", "active": true },
"Tue": { "work_cycle_id": "MjAyNTExMjhEMUZBQURDNUQzNDg=", "active": true }
}
}'
# เพิ่มรายรับคงที่
curl -X POST "https://openapi.humansoft.co.th/api/v1/open-apis/employee/update-employee" \
-H "Ocp-Apim-Subscription-Key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"path_action": "add-constant",
"employee_code": "EMP001",
"salary_type_id": "MjAyNTExMjhEMUZBQURDNUQzNDg=",
"employee_constant_amt": 5000
}'Delete Operations - ID Parameters
สำหรับ Delete operations ต้องระบุ ID ของข้อมูลที่ต้องการลบ:
| path_action | Required ID Parameter |
|---|---|
delete-family | employee_family_id |
delete-work | employee_work_id |
delete-education | employee_education_id |
delete-ability | employee_ability_id |
delete-language-skill | employee_language_skill_id |
delete-typing-skill | employee_typing_skill_id |
delete-driving-skill | employee_driving_skill_id |
delete-training | employee_training_id |
delete-possess | employee_possess_id |
delete-hospital | employee_hospital_id |
delete-document | employee_documents_id |
delete-constant | employee_constant_id |
delete-fund | fund_employee_id |
delete-welfare | welfare_employee_id |
delete-salary-auto-checked | employee_auto_checked_id |
delete-work-insurance | work_insurance_log_id |
delete-actual-quota | employee_actual_quota_id |
Notes
Important:
- ตรวจสอบ
path_actionให้ถูกต้องก่อนส่ง request - บาง operations ต้องการ
employee_codeบางอันต้องการ ID เฉพาะ (เช่นemployee_family_id) - Delete operations ไม่สามารถ undo ได้
Validation
- ทุก
path_actionต้องมีอยู่ในระบบ - Parameter ที่ required จะแตกต่างกันตาม
path_action - ข้อมูลที่แก้ไขต้องเป็นของพนักงานคนเดียวกัน
Related APIs
- Get Employee Info - ดึงข้อมูลพนักงานรายบุคคล
- Get Employee Data - ดึงข้อมูลเฉพาะบางหมวด
- Add Employee - เพิ่มพนักงานใหม่
- Constant API - จัดการรายรับ/รายจ่ายคงที่
- Fund API - จัดการกองทุน
- Manage API - จัดการสถานะพนักงาน (ลาออก/เปิดใช้งาน)
Last updated on