Skip to Content
🚀 Welcome to Humansoft Open API Documentation
DocumentationWebhookEmployee Events

Employee Events

Events ที่เกี่ยวข้องกับข้อมูลพนักงาน


employee.create

เกิดขึ้นเมื่อมีการสร้างข้อมูลพนักงานใหม่ในระบบ

ตัวอย่าง Payload:

{ "request_id": "req_b12c34d56e78f901", "event": "employee.create", "event_occurred_at": "2025-01-23 09:30:00", "body": { "user_id": "USR001", "employee_id": "20250123ABC123DEF456", "employee_code": "EMP001", "signout_flag": "0", "employee_title_lv": "1", "employee_title_name": "นาย", "employee_name": "สมชาย", "employee_last_name": "ใจดี", "employee_nickname": "ชาย", "employee_name_en": "Somchai", "employee_last_name_en": "Jaidee", "effective_dt": "2025-01-01", "mobilephone": "0812345678", "emailaddress": "somchai@example.com", "birth_dt": "1990-05-15", "id_no": "1234567890123", "company_code": "COM001", "company_name": "บริษัท ABC จำกัด", "company_name_en": "ABC Company Limited", "branch_code": "BRN001", "branch_name": "สำนักงานใหญ่", "branch_name_en": "Head Office", "department_code": "DEP001", "department_name": "ฝ่ายทรัพยากรบุคคล", "department_name_en": "Human Resources", "division_code": "DIV001", "division_name": "แผนกบุคคล", "division_name_en": "Personnel Division", "section_code": "SEC001", "section_name": "หน่วยสรรหา", "section_name_en": "Recruitment Section", "position_code": "POS001", "position_name": "พนักงานทั่วไป", "position_name_en": "Staff" } }

employee.terminate

เกิดขึ้นเมื่อพนักงานลาออกหรือพ้นสภาพการเป็นพนักงาน

ตัวอย่าง Payload:

{ "request_id": "req_e45f67g89h01i234", "event": "employee.terminate", "event_occurred_at": "2025-01-23 14:30:00", "body": { "user_id": "USR001", "employee_id": "20250123ABC123DEF456", "employee_code": "EMP001", "signout_flag": "1", "employee_title_lv": "1", "employee_title_name": "นาย", "employee_name": "สมชาย", "employee_last_name": "ใจดี", "employee_nickname": "ชาย", "employee_name_en": "Somchai", "employee_last_name_en": "Jaidee", "effective_dt": "2025-01-01", "mobilephone": "0812345678", "emailaddress": "somchai@example.com", "birth_dt": "1990-05-15", "id_no": "1234567890123", "signout_dt": "2025-01-31", "company_name": "บริษัท ABC จำกัด", "company_name_en": "ABC Company Limited", "branch_name": "สำนักงานใหญ่", "branch_name_en": "Head Office", "department_name": "ฝ่ายทรัพยากรบุคคล", "department_name_en": "Human Resources", "position_name": "พนักงานทั่วไป", "position_name_en": "Staff" } }

signout_dt คือวันที่พ้นสภาพ/ลาออก และ signout_flag จะเป็น "1" เมื่อพนักงานพ้นสภาพแล้ว


employee.structure.change

เกิดขึ้นเมื่อพนักงานถูกย้ายแผนกหรือเปลี่ยนตำแหน่ง

ตัวอย่าง Payload:

{ "request_id": "req_d34e56f78g90h123", "event": "employee.structure.change", "event_occurred_at": "2025-01-23 11:00:00", "body": { "user_id": "USR001", "employee_id": "20250123ABC123DEF456", "employee_code": "EMP001", "signout_flag": "0", "employee_title_lv": "1", "employee_title_name": "นาย", "employee_name": "สมชาย", "employee_last_name": "ใจดี", "employee_nickname": "ชาย", "employee_name_en": "Somchai", "employee_last_name_en": "Jaidee", "effective_dt": "2025-01-01", "mobilephone": "0812345678", "emailaddress": "somchai@example.com", "birth_dt": "1990-05-15", "id_no": "1234567890123", "signout_dt": null, "position_code": "POS002", "position_name": "หัวหน้างาน", "position_name_en": "Supervisor", "company_code": "COM001", "company_name": "บริษัท ABC จำกัด", "company_name_en": "ABC Company Limited", "branch_code": "BRN001", "branch_name": "สำนักงานใหญ่", "branch_name_en": "Head Office", "department_code": "DEP002", "department_name": "ฝ่ายบัญชี", "department_name_en": "Accounting", "division_code": "DIV002", "division_name": "แผนกบัญชีทั่วไป", "division_name_en": "General Accounting", "section_code": "SEC002", "section_name": "หน่วยบัญชีลูกหนี้", "section_name_en": "AR Section" } }

Payload นี้แสดงข้อมูล ปัจจุบัน หลังจากการเปลี่ยนแปลง ไม่มีข้อมูลก่อนเปลี่ยนแปลง


employee.purge

เกิดขึ้นเมื่อมีการลบข้อมูลพนักงานออกจากระบบ

ตัวอย่าง Payload:

{ "request_id": "req_c23d45e67f89g012", "event": "employee.purge", "event_occurred_at": "2025-01-23 10:15:00", "body": { "user_id": "USR001", "employee_id": "20250123ABC123DEF456", "employee_code": "EMP001", "signout_flag": "1", "employee_title_lv": "1", "employee_title_name": "นาย", "employee_name": "สมชาย", "employee_last_name": "ใจดี", "employee_nickname": "ชาย", "employee_name_en": "Somchai", "employee_last_name_en": "Jaidee", "company_name": "บริษัท ABC จำกัด", "branch_name": "สำนักงานใหญ่", "department_name": "ฝ่ายทรัพยากรบุคคล", "position_name": "พนักงานทั่วไป", "effective_dt": "2025-01-01", "mobilephone": "0812345678", "emailaddress": "somchai@example.com", "birth_dt": "1990-05-15", "id_no": "1234567890123" } }

สำคัญ: เมื่อได้รับ event นี้ ข้อมูลพนักงานถูกลบออกจากระบบ Humansoft แล้ว ควรดำเนินการลบหรือ archive ข้อมูลในระบบของคุณด้วย


Body Fields Reference

Employee Fields

FieldTypeDescription
user_idstringรหัส User ในระบบ
employee_idstringรหัสพนักงานในระบบ (Internal ID)
employee_codestringรหัสพนักงาน
signout_flagstringสถานะการพ้นสภาพ ("0" = ทำงานอยู่, "1" = พ้นสภาพ)
employee_title_lvstringรหัสคำนำหน้าชื่อ
employee_title_namestringคำนำหน้าชื่อ (นาย, นาง, นางสาว)
employee_namestringชื่อ (ภาษาไทย)
employee_last_namestringนามสกุล (ภาษาไทย)
employee_nicknamestringชื่อเล่น
employee_name_enstringชื่อ (ภาษาอังกฤษ)
employee_last_name_enstringนามสกุล (ภาษาอังกฤษ)
effective_dtstringวันที่เริ่มงาน (YYYY-MM-DD)
mobilephonestringเบอร์โทรศัพท์
emailaddressstringอีเมล
birth_dtstringวันเกิด (YYYY-MM-DD)
id_nostringเลขบัตรประชาชน

Organization Fields

FieldTypeDescription
company_codestringรหัสบริษัท
company_namestringชื่อบริษัท (ภาษาไทย)
company_name_enstringชื่อบริษัท (ภาษาอังกฤษ)
branch_codestringรหัสสาขา
branch_namestringชื่อสาขา (ภาษาไทย)
branch_name_enstringชื่อสาขา (ภาษาอังกฤษ)
department_codestringรหัสแผนก
department_namestringชื่อแผนก (ภาษาไทย)
department_name_enstringชื่อแผนก (ภาษาอังกฤษ)
division_codestringรหัสฝ่าย
division_namestringชื่อฝ่าย (ภาษาไทย)
division_name_enstringชื่อฝ่าย (ภาษาอังกฤษ)
section_codestringรหัสหน่วยงาน
section_namestringชื่อหน่วยงาน (ภาษาไทย)
section_name_enstringชื่อหน่วยงาน (ภาษาอังกฤษ)
position_codestringรหัสตำแหน่ง
position_namestringชื่อตำแหน่ง (ภาษาไทย)
position_name_enstringชื่อตำแหน่ง (ภาษาอังกฤษ)

Terminate-specific Fields

FieldTypeDescription
signout_dtstringวันที่พ้นสภาพ/ลาออก (YYYY-MM-DD)

สรุป Employee Events

Event Codeชื่อ Eventคำอธิบาย
employee.createสร้างพนักงานใหม่เมื่อมีการสร้างข้อมูลพนักงานใหม่ในระบบ
employee.terminateพนักงานลาออก/พ้นสภาพเมื่อพนักงานลาออกหรือพ้นสภาพการเป็นพนักงาน
employee.structure.changeพนักงานย้ายแผนก/ปรับตำแหน่งเมื่อพนักงานถูกย้ายแผนกหรือเปลี่ยนตำแหน่ง
employee.purgeลบข้อมูลพนักงานเมื่อมีการลบข้อมูลพนักงานออกจากระบบ
Last updated on