Skip to Content
🚀 Welcome to Humansoft Open API Documentation

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-employee

Request Body

Common Parameters

ParameterTypeRequiredDescriptionExample
path_actionstringYesประเภทการดำเนินการadd-family
employee_codestringYesรหัสพนักงาน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_actionOperationDescription
add-userCreateสร้างบัญชีผู้ใช้งาน
delete-userDeleteลบบัญชีผู้ใช้งาน
reset-user-usernameUpdateรีเซ็ตชื่อผู้ใช้
reset-user-passwordUpdateรีเซ็ตรหัสผ่าน
save-user-groupsUpdateอัพเดตกลุ่มผู้ใช้งาน
add-facialCreateเพิ่มข้อมูลใบหน้า
delete-facialDeleteลบข้อมูลใบหน้า
save-basicUpdateบันทึกข้อมูลพื้นฐาน
save-approverUpdateบันทึกผู้อนุมัติ
save-work-cycleUpdateบันทึกกะการทำงาน
save-holidayUpdateบันทึกวันหยุด
save-otUpdateบันทึกประเภท OT
save-quotaUpdateบันทึกโควตาการลา
add-actual-quotaCreateเพิ่มโควตาจริง
delete-actual-quotaDeleteลบโควตาจริง

Profile Operations

การจัดการข้อมูลส่วนตัว:

path_actionOperationDescription
add-familyCreateเพิ่มข้อมูลครอบครัว
save-familyUpdateบันทึกข้อมูลครอบครัว
delete-familyDeleteลบข้อมูลครอบครัว
add-workCreateเพิ่มประวัติการทำงาน
save-workUpdateบันทึกประวัติการทำงาน
delete-workDeleteลบประวัติการทำงาน
add-educationCreateเพิ่มประวัติการศึกษา
save-educationUpdateบันทึกประวัติการศึกษา
delete-educationDeleteลบประวัติการศึกษา
add-abilityCreateเพิ่มความสามารถพิเศษ
save-abilityUpdateบันทึกความสามารถพิเศษ
delete-abilityDeleteลบความสามารถพิเศษ
add-language-skillCreateเพิ่มทักษะภาษา
save-language-skillUpdateบันทึกทักษะภาษา
delete-language-skillDeleteลบทักษะภาษา
add-typing-skillCreateเพิ่มทักษะพิมพ์ดีด
save-typing-skillUpdateบันทึกทักษะพิมพ์ดีด
delete-typing-skillDeleteลบทักษะพิมพ์ดีด
add-driving-skillCreateเพิ่มทักษะขับขี่
save-driving-skillUpdateบันทึกทักษะขับขี่
delete-driving-skillDeleteลบทักษะขับขี่
add-trainingCreateเพิ่มประวัติฝึกอบรม
save-trainingUpdateบันทึกประวัติฝึกอบรม
delete-trainingDeleteลบประวัติฝึกอบรม
add-possessCreateเพิ่มทรัพย์สิน
save-possessUpdateบันทึกทรัพย์สิน
delete-possessDeleteลบทรัพย์สิน
add-hospitalCreateเพิ่มโรงพยาบาล
save-hospitalUpdateบันทึกโรงพยาบาล
delete-hospitalDeleteลบโรงพยาบาล
add-documentCreateเพิ่มเอกสาร
save-documentUpdateบันทึกเอกสาร
delete-documentDeleteลบเอกสาร
save-addressUpdateบันทึกที่อยู่

Financial Operations

การจัดการข้อมูลการเงิน:

path_actionOperationDescription
add-constantCreateเพิ่มรายรับ/รายจ่ายคงที่
save-constantUpdateบันทึกรายรับ/รายจ่ายคงที่
delete-constantDeleteลบรายรับ/รายจ่ายคงที่
add-fundCreateเพิ่มกองทุน
save-fundUpdateบันทึกกองทุน
pause-fundUpdateเปิด/ปิดกองทุน (สลับสถานะ)
pull-back-fundUpdateดึงข้อมูลกองทุนกลับมาจาก log
delete-fundDeleteลบกองทุน
add-welfareCreateเพิ่มสวัสดิการ
save-welfareUpdateบันทึกสวัสดิการ
delete-welfareDeleteลบสวัสดิการ
add-work-insuranceCreateเพิ่มประกันสังคม
delete-work-insuranceDeleteลบประกันสังคม
add-salary-auto-checkedCreateเพิ่มรายการตรวจสอบเงินเดือน
save-salary-auto-checkedUpdateบันทึกรายการตรวจสอบเงินเดือน
delete-salary-auto-checkedDeleteลบรายการตรวจสอบเงินเดือน
save-tax-exceptionUpdateบันทึกรายการลดหย่อนภาษี
fill-tax-exceptionUpdateเติมข้อมูลลดหย่อนภาษีจากปีก่อน
delete-taxDeleteลบข้อมูลภาษีทั้งปี

Manage Operations

การจัดการสถานะพนักงาน:

path_actionOperationDescription
sign-outUpdateบันทึกการลาออกของพนักงาน
get-resign-docReadดึงเอกสารลาออก (PDF)
reactiveUpdateเปิดใช้งานพนักงานที่ลาออกอีกครั้ง

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:

CodeDescription
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 -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_actionRequired ID Parameter
delete-familyemployee_family_id
delete-workemployee_work_id
delete-educationemployee_education_id
delete-abilityemployee_ability_id
delete-language-skillemployee_language_skill_id
delete-typing-skillemployee_typing_skill_id
delete-driving-skillemployee_driving_skill_id
delete-trainingemployee_training_id
delete-possessemployee_possess_id
delete-hospitalemployee_hospital_id
delete-documentemployee_documents_id
delete-constantemployee_constant_id
delete-fundfund_employee_id
delete-welfarewelfare_employee_id
delete-salary-auto-checkedemployee_auto_checked_id
delete-work-insurancework_insurance_log_id
delete-actual-quotaemployee_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
  • ข้อมูลที่แก้ไขต้องเป็นของพนักงานคนเดียวกัน

  • Get Employee Info - ดึงข้อมูลพนักงานรายบุคคล
  • Get Employee Data - ดึงข้อมูลเฉพาะบางหมวด
  • Add Employee - เพิ่มพนักงานใหม่
  • Constant API - จัดการรายรับ/รายจ่ายคงที่
  • Fund API - จัดการกองทุน
  • Manage API - จัดการสถานะพนักงาน (ลาออก/เปิดใช้งาน)
Last updated on