Work Cycle Change Events

Events ที่เกี่ยวข้องกับเอกสารคำร้องขอเปลี่ยน/สลับกะการทำงาน

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

work_cycle_change.created

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

ตัวอย่าง Payload:


{
  "request_id": "req_wc12345678",
  "event": "work_cycle_change.created",
  "event_occurred_at": "2025-01-25 11:15:00",
  "body": {
    "work_cycle_change_id": "WC2501003",
    "employee_id": "20250103IJKL9012",
    "work_cycle_mode_lv": "change",
    "work_cycle_id": "20251127921FE47E6F79",
    "work_cycle_switch_dt": "0000-00-00",
    "switch_work_cycle_id_from": null,
    "switch_work_cycle_id_to": null,
    "work_cycle_change_dt": "2025-01-26",
    "work_cycle_change_desc": "เปลี่ยนกะถาวร",
    "work_cycle_change_path": null,
    "approve_flag": "01",
    "document_approve_flag": "01",
    "approve_id": "",
    "approve_upd": null,
    "approve_remark": null,
    "approve_method": "01",
    "document_created_by": "EMP001",
    "document_last_upd_by": "EMP001",
    "employee_code": "EMP001",
    "employee_title_lv": "03",
    "company_id": "C001",
    "branch_id": "B001",
    "department_id": "D002",
    "position_id": "P003",
    "full_name": "มานะ ขยัน",
    "approval_status": "Pending",
    "source": "hms_admin",
    "resource_type": "work_cycle_change",
    "actor_id": "EMP001",
    "work_cycle_mode_name": "เปลี่ยนกะ",
    "work_cycle_mode_name_en": "Change Shift",
    "work_cycle_code": "iyt001",
    "work_cycle_type_lv": "04",
    "work_start_time": "08:00:00",
    "work_end_time": "17:00:00",
    "work_hour": "08:00:00",
    "employee_title_name": "นาย"
  }
}

work_cycle_mode_lv = "switch" → สลับกะกับพนักงานคนอื่น (มี switch_from และ switch_to)
work_cycle_mode_lv = "change" → เปลี่ยนกะของตัวเอง (จะมี work_cycle_id แทน switch_*)

work_cycle_change.updated

เกิดขึ้นเมื่อแก้ไขข้อมูลเอกสารเปลี่ยน/สลับกะ

ตัวอย่าง Payload:


{
  "request_id": "req_wc12345679",
  "event": "work_cycle_change.updated",
  "event_occurred_at": "2025-01-25 11:20:00",
  "body": {
    "work_cycle_change_id": "WC2501003",
    "employee_id": "20250103IJKL9012",
    "work_cycle_mode_lv": "switch",
    "work_cycle_id": "",
    "switch_work_cycle_id_from": "CYC001",
    "switch_work_cycle_id_to": "CYC003",
    "work_cycle_change_dt": "2025-01-26",
    "work_cycle_change_desc": "สลับกะกับพนักงานท่านอื่น (เปลี่ยนกะเป้าหมาย)",
    "work_cycle_change_path": null,
    "approve_flag": "01",
    "document_approve_flag": "01",
    "approve_id": "",
    "approve_upd": null,
    "approve_remark": null,
    "approve_method": "01",
    "document_created_by": "EMP001",
    "document_last_upd_by": "EMP001",
    "employee_code": "EMP001",
    "employee_title_lv": "03",
    "company_id": "C001",
    "branch_id": "B001",
    "department_id": "D002",
    "position_id": "P003",
    "full_name": "มานะ ขยัน",
    "approval_status": "Pending",
    "source": "hms_admin",
    "resource_type": "work_cycle_change",
    "actor_id": "EMP001",
    "work_cycle_mode_name": "สลับกะ",
    "work_cycle_mode_name_en": "Switch Shift",
    "switch_from": {
      "work_cycle_code": "SHIFT_A",
      "work_start_time": "08:00:00",
      "work_end_time": "17:00:00",
      "work_hour": "08:00:00"
    },
    "switch_to": {
      "work_cycle_code": "SHIFT_C",
      "work_start_time": "22:00:00",
      "work_end_time": "06:00:00",
      "work_hour": "08:00:00"
    },
    "employee_title_name": "นาย"
  }
}

work_cycle_change.deleted

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

ตัวอย่าง Payload:


{
  "request_id": "req_wc12345680",
  "event": "work_cycle_change.deleted",
  "event_occurred_at": "2025-01-25 11:25:00",
  "body": {
    "work_cycle_change_id": "WC2501003",
    "employee_id": "20250103IJKL9012",
    "work_cycle_mode_lv": "switch",
    "work_cycle_id": "",
    "switch_work_cycle_id_from": "CYC001",
    "switch_work_cycle_id_to": "CYC003",
    "work_cycle_change_dt": "2025-01-26",
    "work_cycle_change_desc": "สลับกะกับพนักงานท่านอื่น (เปลี่ยนกะเป้าหมาย)",
    "work_cycle_change_path": null,
    "approve_flag": "01",
    "document_approve_flag": "01",
    "approve_id": "",
    "approve_upd": null,
    "approve_remark": null,
    "approve_method": "01",
    "document_created_by": "EMP001",
    "document_last_upd_by": "EMP001",
    "employee_code": "EMP001",
    "employee_title_lv": "03",
    "company_id": "C001",
    "branch_id": "B001",
    "department_id": "D002",
    "position_id": "P003",
    "full_name": "มานะ ขยัน",
    "approval_status": "Pending",
    "source": "hms_admin",
    "resource_type": "work_cycle_change",
    "actor_id": "EMP001",
    "work_cycle_mode_name": "สลับกะ",
    "work_cycle_mode_name_en": "Switch Shift",
    "switch_from": {
      "work_cycle_code": "SHIFT_A",
      "work_start_time": "08:00:00",
      "work_end_time": "17:00:00",
      "work_hour": "08:00:00"
    },
    "switch_to": {
      "work_cycle_code": "SHIFT_C",
      "work_start_time": "22:00:00",
      "work_end_time": "06:00:00",
      "work_hour": "08:00:00"
    },
    "employee_title_name": "นาย"
  }
}

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

work_cycle_change.approval_progressed

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

ตัวอย่าง Payload:


{
  "request_id": "req_wc12345681",
  "event": "work_cycle_change.approval_progressed",
  "event_occurred_at": "2025-01-25 12:00:00",
  "body": {
    "work_cycle_change_id": "WC2501003",
    "employee_id": "20250103IJKL9012",
    "work_cycle_mode_lv": "switch",
    "work_cycle_id": "",
    "switch_work_cycle_id_from": "CYC001",
    "switch_work_cycle_id_to": "CYC002",
    "work_cycle_change_dt": "2025-01-26",
    "work_cycle_change_desc": "สลับกะกับพนักงานท่านอื่น",
    "work_cycle_change_path": null,
    "approve_flag": "04",
    "document_approve_flag": "04",
    "approve_id": "MGR001",
    "approve_upd": "2025-01-25 12:00:00",
    "approve_remark": "รับทราบ",
    "approve_method": "01",
    "document_created_by": "EMP001",
    "document_last_upd_by": "MGR001",
    "employee_code": "EMP001",
    "employee_title_lv": "03",
    "company_id": "C001",
    "branch_id": "B001",
    "department_id": "D002",
    "position_id": "P003",
    "full_name": "มานะ ขยัน",
    "approval_status": "Approval Progressed Step 1",
    "source": "hms_admin",
    "resource_type": "work_cycle_change",
    "actor_id": "MGR001",
    "work_cycle_mode_name": "สลับกะ",
    "work_cycle_mode_name_en": "Switch Shift",
    "switch_from": {
      "work_cycle_code": "SHIFT_A",
      "work_start_time": "08:00:00",
      "work_end_time": "17:00:00",
      "work_hour": "08:00:00"
    },
    "switch_to": {
      "work_cycle_code": "SHIFT_B",
      "work_start_time": "13:00:00",
      "work_end_time": "22:00:00",
      "work_hour": "08:00:00"
    },
    "employee_title_name": "นาย"
  }
}

work_cycle_change.approved

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

ตัวอย่าง Payload:


{
  "request_id": "req_wc12345682",
  "event": "work_cycle_change.approved",
  "event_occurred_at": "2025-01-25 13:00:00",
  "body": {
    "work_cycle_change_id": "WC2501003",
    "employee_id": "20250103IJKL9012",
    "work_cycle_mode_lv": "switch",
    "work_cycle_id": "",
    "switch_work_cycle_id_from": "CYC001",
    "switch_work_cycle_id_to": "CYC002",
    "work_cycle_change_dt": "2025-01-26",
    "work_cycle_change_desc": "สลับกะกับพนักงานท่านอื่น",
    "work_cycle_change_path": null,
    "approve_flag": "02",
    "document_approve_flag": "02",
    "approve_id": "MGR002",
    "approve_upd": "2025-01-25 13:00:00",
    "approve_remark": "อนุมัติ",
    "approve_method": "01",
    "document_created_by": "EMP001",
    "document_last_upd_by": "MGR002",
    "employee_code": "EMP001",
    "employee_title_lv": "03",
    "company_id": "C001",
    "branch_id": "B001",
    "department_id": "D002",
    "position_id": "P003",
    "full_name": "มานะ ขยัน",
    "approval_status": "Approved",
    "source": "hms_admin",
    "resource_type": "work_cycle_change",
    "actor_id": "MGR002",
    "work_cycle_mode_name": "สลับกะ",
    "work_cycle_mode_name_en": "Switch Shift",
    "switch_from": {
      "work_cycle_code": "SHIFT_A",
      "work_start_time": "08:00:00",
      "work_end_time": "17:00:00",
      "work_hour": "08:00:00"
    },
    "switch_to": {
      "work_cycle_code": "SHIFT_B",
      "work_start_time": "13:00:00",
      "work_end_time": "22:00:00",
      "work_hour": "08:00:00"
    },
    "employee_title_name": "นาย"
  }
}

work_cycle_change.rejected

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

ตัวอย่าง Payload:


{
  "request_id": "req_wc12345683",
  "event": "work_cycle_change.rejected",
  "event_occurred_at": "2025-01-25 13:05:00",
  "body": {
    "work_cycle_change_id": "WC2501003",
    "employee_id": "20250103IJKL9012",
    "work_cycle_mode_lv": "switch",
    "work_cycle_id": "",
    "switch_work_cycle_id_from": "CYC001",
    "switch_work_cycle_id_to": "CYC002",
    "work_cycle_change_dt": "2025-01-26",
    "work_cycle_change_desc": "สลับกะกับพนักงานท่านอื่น",
    "work_cycle_change_path": null,
    "approve_flag": "03",
    "document_approve_flag": "03",
    "approve_id": "MGR002",
    "approve_upd": "2025-01-25 13:05:00",
    "approve_remark": "ไม่อนุมัติ",
    "approve_method": "01",
    "document_created_by": "EMP001",
    "document_last_upd_by": "MGR002",
    "employee_code": "EMP001",
    "employee_title_lv": "03",
    "company_id": "C001",
    "branch_id": "B001",
    "department_id": "D002",
    "position_id": "P003",
    "full_name": "มานะ ขยัน",
    "approval_status": "Rejected",
    "source": "hms_admin",
    "resource_type": "work_cycle_change",
    "actor_id": "MGR002",
    "work_cycle_mode_name": "สลับกะ",
    "work_cycle_mode_name_en": "Switch Shift",
    "switch_from": {
      "work_cycle_code": "SHIFT_A",
      "work_start_time": "08:00:00",
      "work_end_time": "17:00:00",
      "work_hour": "08:00:00"
    },
    "switch_to": {
      "work_cycle_code": "SHIFT_B",
      "work_start_time": "13:00:00",
      "work_end_time": "22:00:00",
      "work_hour": "08:00:00"
    },
    "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 นี้ (เช่น ผู้ขอ, ผู้อนุมัติตามสายงาน)

Work Cycle Change Fields

Field	Type	Description
`work_cycle_change_id`	string	รหัสเอกสารเปลี่ยนกะ
`work_cycle_change_dt`	string	วันที่เปลี่ยนกะ (YYYY-MM-DD)
`work_cycle_switch_dt`	string	วันที่สลับกะ (YYYY-MM-DD)
`work_cycle_mode_lv`	string	โหมดการทำงาน (`change` = เปลี่ยนกะ, `switch` = สลับกะ)
`work_cycle_id`	string	รหัสกะการทำงาน (กรณีโหมด `change`)
`switch_work_cycle_id_from`	string	รหัสกะเดิมที่ต้องการสลับ (กรณีโหมด `switch`)
`switch_work_cycle_id_to`	string	รหัสกะเป้าหมายที่ต้องการสลับ (กรณีโหมด `switch`)
`work_cycle_change_desc`	string	เหตุผลการเปลี่ยน/สลับกะ
`work_cycle_change_path`	string	พาธไฟล์แนบ (ถ้ามี)
`work_cycle_mode_name`	string	ชื่อโหมดการทำงาน (ภาษาไทย เช่น “เปลี่ยนกะ”, “สลับกะ”)
`work_cycle_mode_name_en`	string	ชื่อโหมดการทำงาน (English)
`switch_from`	object	ข้อมูลรายละเอียดกะเดิม (`work_cycle_code`, `work_start_time`, `work_end_time`, `work_hour`)
`switch_to`	object	ข้อมูลรายละเอียดกะใหม่ (`work_cycle_code`, `work_start_time`, `work_end_time`, `work_hour`)
`work_cycle_code`	string	รหัสกะ (กรณีโหมด `change`)
`work_cycle_type_lv`	string	ประเภทรหัสกะ (กรณีโหมด `change`)
`work_start_time`	string	เวลาเข้างาน (กรณีโหมด `change`)
`work_end_time`	string	เวลาออกงาน (กรณีโหมด `change`)
`work_hour`	string	จำนวนชั่วโมงทำงาน (กรณีโหมด `change`)

สรุป Work Cycle Change Events

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