Holiday Change Events

Events ที่เกี่ยวข้องกับเอกสารคำร้องขอเลื่อน/สลับวันหยุด

ข้อมูลใน body ประกอบด้วยฟิลด์พื้นฐานของเอกสาร, ข้อมูลพนักงาน, สถานะการอนุมัติ, โหมดการเปลี่ยนวันหยุด และประเภทวันหยุด

holiday_change.created

เกิดขึ้นเมื่อสร้างคำร้องขอเลื่อน/สลับวันหยุดใหม่

ตัวอย่าง Payload:


{
  "request_id": "req_hc12345678",
  "event": "holiday_change.created",
  "event_occurred_at": "2025-01-20 14:00:00",
  "body": {
    "holiday_change_id": "HC2501004",
    "employee_id": "20250104MNOP3456",
    "holiday_mode_lv": "change",
    "holiday_flag_lv": "H01",
    "holiday_switch_dt": "2025-01-27",
    "switch_holiday_flag_lv_from": "",
    "switch_holiday_flag_lv_to": "",
    "holiday_change_dt": "2025-01-26",
    "holiday_change_date": "2025-01-26",
    "holiday_change_desc": "ขอเลื่อนวันหยุดไปทำธุระครอบครัว",
    "holiday_change_path": null,
    "approve_flag": "01",
    "approve_id": "",
    "approve_upd": null,
    "approve_remark": null,
    "approve_method": "01",
    "document_approve_flag": "01",
    "document_created_by": "EMP001",
    "document_last_upd_by": "EMP001",
    "employee_code": "EMP001",
    "employee_title_lv": "04",
    "company_id": "C001",
    "branch_id": "B001",
    "department_id": "D003",
    "position_id": "P004",
    "full_name": "ปิติ ดีใจ",
    "approval_status": "Pending",
    "source": "hms_admin",
    "resource_type": "holiday_change",
    "actor_id": "EMP001",
    "holiday_mode_name": "เปลี่ยนวันหยุด",
    "holiday_mode_name_en": "Change Holiday",
    "holiday_flag_name": "วันหยุดประจำสัปดาห์",
    "holiday_flag_name_en": "Weekly Holiday",
    "switch_from_flag_name": "วันทำงาน",
    "switch_from_flag_name_en": "Workday",
    "switch_to_flag_name": "วันทำงาน",
    "switch_to_flag_name_en": "Workday",
    "employee_title_name": "นาย"
  }
}

holiday_mode_lv = "change" → เลื่อนวันหยุดไปวันใหม่ (ใช้ holiday_flag_lv)
holiday_mode_lv = "switch" → สลับวันหยุดกับวันทำงาน (ใช้ switch_holiday_flag_lv_from / switch_holiday_flag_lv_to)

holiday_change.updated

เกิดขึ้นเมื่อแก้ไขข้อมูลเอกสารเลื่อน/สลับวันหยุด

ตัวอย่าง Payload:


{
  "request_id": "req_hc12345679",
  "event": "holiday_change.updated",
  "event_occurred_at": "2025-01-20 14:10:00",
  "body": {
    "holiday_change_id": "HC2501004",
    "employee_id": "20250104MNOP3456",
    "holiday_mode_lv": "change",
    "holiday_flag_lv": "H01",
    "holiday_switch_dt": "2025-01-27",
    "switch_holiday_flag_lv_from": "",
    "switch_holiday_flag_lv_to": "",
    "holiday_change_dt": "2025-01-27",
    "holiday_change_date": "2025-01-27",
    "holiday_change_desc": "ขอเลื่อนวันหยุดไปทำธุระครอบครัว (เปลี่ยนวัน)",
    "holiday_change_path": null,
    "approve_flag": "01",
    "approve_id": "",
    "approve_upd": null,
    "approve_remark": null,
    "approve_method": "01",
    "document_approve_flag": "01",
    "document_created_by": "EMP001",
    "document_last_upd_by": "EMP001",
    "employee_code": "EMP001",
    "employee_title_lv": "04",
    "company_id": "C001",
    "branch_id": "B001",
    "department_id": "D003",
    "position_id": "P004",
    "full_name": "ปิติ ดีใจ",
    "approval_status": "Pending",
    "source": "hms_admin",
    "resource_type": "holiday_change",
    "actor_id": "EMP001",
    "holiday_mode_name": "เปลี่ยนวันหยุด",
    "holiday_mode_name_en": "Change Holiday",
    "holiday_flag_name": "วันหยุดประจำสัปดาห์",
    "holiday_flag_name_en": "Weekly Holiday",
    "switch_from_flag_name": "วันทำงาน",
    "switch_from_flag_name_en": "Workday",
    "switch_to_flag_name": "วันทำงาน",
    "switch_to_flag_name_en": "Workday",
    "employee_title_name": "นาย"
  }
}

holiday_change.deleted

เกิดขึ้นเมื่อลบหรือยกเลิกเอกสารเลื่อน/สลับวันหยุด

ตัวอย่าง Payload:


{
  "request_id": "req_hc12345680",
  "event": "holiday_change.deleted",
  "event_occurred_at": "2025-01-20 14:15:00",
  "body": {
    "holiday_change_id": "HC2501004",
    "employee_id": "20250104MNOP3456",
    "holiday_mode_lv": "change",
    "holiday_flag_lv": "H01",
    "holiday_switch_dt": "2025-01-27",
    "switch_holiday_flag_lv_from": "",
    "switch_holiday_flag_lv_to": "",
    "holiday_change_dt": "2025-01-27",
    "holiday_change_date": "2025-01-27",
    "holiday_change_desc": "ขอเลื่อนวันหยุดไปทำธุระครอบครัว (เปลี่ยนวัน)",
    "holiday_change_path": null,
    "approve_flag": "01",
    "approve_id": "",
    "approve_upd": null,
    "approve_remark": null,
    "approve_method": "01",
    "document_approve_flag": "01",
    "document_created_by": "EMP001",
    "document_last_upd_by": "EMP001",
    "employee_code": "EMP001",
    "employee_title_lv": "04",
    "company_id": "C001",
    "branch_id": "B001",
    "department_id": "D003",
    "position_id": "P004",
    "full_name": "ปิติ ดีใจ",
    "approval_status": "Pending",
    "source": "hms_admin",
    "resource_type": "holiday_change",
    "actor_id": "EMP001",
    "holiday_mode_name": "เปลี่ยนวันหยุด",
    "holiday_mode_name_en": "Change Holiday",
    "holiday_flag_name": "วันหยุดประจำสัปดาห์",
    "holiday_flag_name_en": "Weekly Holiday",
    "switch_from_flag_name": "วันทำงาน",
    "switch_from_flag_name_en": "Workday",
    "switch_to_flag_name": "วันทำงาน",
    "switch_to_flag_name_en": "Workday",
    "employee_title_name": "นาย"
  }
}

เมื่อได้รับ event นี้ เอกสารถูกลบออกจากระบบแล้ว ไม่สามารถกู้คืนได้

holiday_change.approval_progressed

เกิดขึ้นเมื่อมีการดำเนินการอนุมัติตามสายงาน (ยังไม่เสร็จสิ้น)

ตัวอย่าง Payload:


{
  "request_id": "req_hc12345681",
  "event": "holiday_change.approval_progressed",
  "event_occurred_at": "2025-01-21 09:00:00",
  "body": {
    "holiday_change_id": "HC2501004",
    "employee_id": "20250104MNOP3456",
    "holiday_mode_lv": "change",
    "holiday_flag_lv": "H01",
    "holiday_switch_dt": "2025-01-26",
    "switch_holiday_flag_lv_from": "",
    "switch_holiday_flag_lv_to": "",
    "holiday_change_dt": "2025-01-26",
    "holiday_change_date": "2025-01-26",
    "holiday_change_desc": "ขอเลื่อนวันหยุดไปทำธุระครอบครัว",
    "holiday_change_path": null,
    "approve_flag": "04",
    "approve_id": "MGR001",
    "approve_upd": "2025-01-21 09:00:00",
    "approve_remark": "รับทราบ",
    "approve_method": "01",
    "document_approve_flag": "01",
    "document_created_by": "EMP001",
    "document_last_upd_by": "MGR001",
    "employee_code": "EMP001",
    "employee_title_lv": "04",
    "company_id": "C001",
    "branch_id": "B001",
    "department_id": "D003",
    "position_id": "P004",
    "full_name": "ปิติ ดีใจ",
    "approval_status": "Approval Progressed Step 1",
    "source": "hms_admin",
    "resource_type": "holiday_change",
    "actor_id": "MGR001",
    "holiday_mode_name": "เปลี่ยนวันหยุด",
    "holiday_mode_name_en": "Change Holiday",
    "holiday_flag_name": "วันหยุดประจำสัปดาห์",
    "holiday_flag_name_en": "Weekly Holiday",
    "switch_from_flag_name": "วันทำงาน",
    "switch_from_flag_name_en": "Workday",
    "switch_to_flag_name": "วันทำงาน",
    "switch_to_flag_name_en": "Workday",
    "employee_title_name": "นาย"
  }
}

holiday_change.approved

เกิดขึ้นเมื่อการเลื่อน/สลับวันหยุดได้รับการอนุมัติเสร็จสมบูรณ์

ตัวอย่าง Payload:


{
  "request_id": "req_hc12345682",
  "event": "holiday_change.approved",
  "event_occurred_at": "2025-01-21 10:00:00",
  "body": {
    "holiday_change_id": "HC2501004",
    "employee_id": "20250104MNOP3456",
    "holiday_mode_lv": "change",
    "holiday_flag_lv": "H01",
    "holiday_switch_dt": "2025-01-26",
    "switch_holiday_flag_lv_from": "",
    "switch_holiday_flag_lv_to": "",
    "holiday_change_dt": "2025-01-26",
    "holiday_change_date": "2025-01-26",
    "holiday_change_desc": "ขอเลื่อนวันหยุดไปทำธุระครอบครัว",
    "holiday_change_path": null,
    "approve_flag": "02",
    "approve_id": "MGR002",
    "approve_upd": "2025-01-21 10:00:00",
    "approve_remark": "อนุมัติ",
    "approve_method": "01",
    "document_approve_flag": "02",
    "document_created_by": "EMP001",
    "document_last_upd_by": "MGR002",
    "employee_code": "EMP001",
    "employee_title_lv": "04",
    "company_id": "C001",
    "branch_id": "B001",
    "department_id": "D003",
    "position_id": "P004",
    "full_name": "ปิติ ดีใจ",
    "approval_status": "Approved",
    "source": "hms_admin",
    "resource_type": "holiday_change",
    "actor_id": "MGR002",
    "holiday_mode_name": "เปลี่ยนวันหยุด",
    "holiday_mode_name_en": "Change Holiday",
    "holiday_flag_name": "วันหยุดประจำสัปดาห์",
    "holiday_flag_name_en": "Weekly Holiday",
    "switch_from_flag_name": "วันทำงาน",
    "switch_from_flag_name_en": "Workday",
    "switch_to_flag_name": "วันทำงาน",
    "switch_to_flag_name_en": "Workday",
    "employee_title_name": "นาย"
  }
}

holiday_change.rejected

เกิดขึ้นเมื่อคำร้องเลื่อน/สลับวันหยุดถูกปฏิเสธ

ตัวอย่าง Payload:


{
  "request_id": "req_hc12345683",
  "event": "holiday_change.rejected",
  "event_occurred_at": "2025-01-21 10:05:00",
  "body": {
    "holiday_change_id": "HC2501004",
    "employee_id": "20250104MNOP3456",
    "holiday_mode_lv": "change",
    "holiday_flag_lv": "H01",
    "holiday_switch_dt": "2025-01-26",
    "switch_holiday_flag_lv_from": "",
    "switch_holiday_flag_lv_to": "",
    "holiday_change_dt": "2025-01-26",
    "holiday_change_date": "2025-01-26",
    "holiday_change_desc": "ขอเลื่อนวันหยุดไปทำธุระครอบครัว",
    "holiday_change_path": null,
    "approve_flag": "03",
    "approve_id": "MGR002",
    "approve_upd": "2025-01-21 10:05:00",
    "approve_remark": "ไม่อนุมัติ",
    "approve_method": "01",
    "document_approve_flag": "03",
    "document_created_by": "EMP001",
    "document_last_upd_by": "MGR002",
    "employee_code": "EMP001",
    "employee_title_lv": "04",
    "company_id": "C001",
    "branch_id": "B001",
    "department_id": "D003",
    "position_id": "P004",
    "full_name": "ปิติ ดีใจ",
    "approval_status": "Rejected",
    "source": "hms_admin",
    "resource_type": "holiday_change",
    "actor_id": "MGR002",
    "holiday_mode_name": "เปลี่ยนวันหยุด",
    "holiday_mode_name_en": "Change Holiday",
    "holiday_flag_name": "วันหยุดประจำสัปดาห์",
    "holiday_flag_name_en": "Weekly Holiday",
    "switch_from_flag_name": "วันทำงาน",
    "switch_from_flag_name_en": "Workday",
    "switch_to_flag_name": "วันทำงาน",
    "switch_to_flag_name_en": "Workday",
    "employee_title_name": "นาย"
  }
}

Body Fields Reference

Base Document Fields (มีในทุก event)

Field	Type	Description
`employee_id`	string	รหัสพนักงานในระบบ (Internal ID)
`employee_code`	string	รหัสพนักงาน
`employee_title_lv`	string	รหัสคำนำหน้าชื่อ
`employee_title_name`	string	ชื่อคำนำหน้า เช่น นาย, นาง, นางสาว (เพิ่มให้อัตโนมัติ)
`full_name`	string	ชื่อ-นามสกุลพนักงาน
`company_id`	string	รหัสบริษัท
`branch_id`	string	รหัสสาขา
`department_id`	string	รหัสแผนก
`position_id`	string	รหัสตำแหน่ง
`approve_flag` / `document_approve_flag`	string	รหัสสถานะการอนุมัติ (`01` = Pending, `02` = Approved, `03` = Rejected, `04+` = Step X)
`approve_id`	string	รหัสพนักงานผู้อนุมัติ (ถ้ามี)
`approve_upd`	string	วันที่และเวลาที่อนุมัติ (YYYY-MM-DD HH:mm:ss)
`approve_remark`	string	หมายเหตุการอนุมัติ
`approve_method`	string	รหัสวิธีการอนุมัติ (เช่น `01`, `02`)
`approval_status`	string	สถานะการอนุมัติ (เช่น `Pending`, `Approved`, `Rejected`)
`document_created_by`	string	รหัสพนักงานผู้สร้างคำร้อง/เอกสาร
`document_last_upd_by`	string	รหัสพนักงานผู้อัปเดต/อนุมัติเอกสารล่าสุด
`source`	string	แหล่งที่มาของการทำรายการ (เช่น `hms_admin`, `openapi`)
`resource_type`	string	ประเภทของเอกสาร (เช่น `time_leave`, `overtime`)
`actor_id`	string	รหัสผู้ใช้งานที่ทำให้เกิด Event นี้ (เช่น ผู้ขอ, ผู้อนุมัติตามสายงาน)

Holiday Change Fields

Field	Type	Description
`holiday_change_id`	string	รหัสเอกสารเปลี่ยนวันหยุด
`holiday_change_dt`	string	วันที่เปลี่ยนวันหยุด (YYYY-MM-DD)
`holiday_mode_lv`	string	โหมดการเปลี่ยนวันหยุด (`change` = เลื่อนวันหยุด, `switch` = สลับวันหยุด)
`holiday_flag_lv`	string	รหัสประเภทวันหยุด
`holiday_switch_dt`	string	วันที่สลับวันหยุดด้วย (ถ้ามี)
`holiday_change_date`	string	วันที่ต้องการสลับหรือเลื่อนวันหยุด
`holiday_change_desc`	string	เหตุผลการเลื่อน/สลับวันหยุด
`holiday_change_path`	string	พาธไฟล์แนบ (ถ้ามี)
`holiday_mode_name`	string	ชื่อโหมดการทำงาน (ภาษาไทย เช่น “เปลี่ยนวันหยุด”)
`holiday_mode_name_en`	string	ชื่อโหมดการเปลี่ยนวันหยุด (English)
`holiday_flag_name`	string	ชื่อประเภทวันหยุด (กรณีโหมดเปลี่ยนวันหยุด)
`holiday_flag_name_en`	string	ชื่อประเภทวันหยุด (English)
`switch_from_flag_name`	string	ชื่อประเภทวันหยุดเดิม (ภาษาไทย)
`switch_from_flag_name_en`	string	ชื่อประเภทวันหยุดเดิม (English)
`switch_to_flag_name`	string	ชื่อประเภทวันหยุดใหม่ (ภาษาไทย)
`switch_to_flag_name_en`	string	ชื่อประเภทวันหยุดใหม่ (English)

สรุป Holiday Change Events

Event Code	คำอธิบาย
`holiday_change.created`	สร้างคำร้องขอเลื่อน/สลับวันหยุดใหม่
`holiday_change.updated`	แก้ไขข้อมูลเอกสาร
`holiday_change.deleted`	ลบหรือยกเลิกเอกสาร
`holiday_change.approval_progressed`	ดำเนินการอนุมัติตามสายงาน (ยังไม่เสร็จสิ้น)
`holiday_change.approved`	ได้รับการอนุมัติเสร็จสมบูรณ์
`holiday_change.rejected`	ถูกปฏิเสธ