Time Adjust Events

Events ที่เกี่ยวข้องกับเอกสารคำร้องขอปรับปรุง/เพิ่มเวลาการทำงาน (เช่น ลืมสแกนนิ้ว, ขอเพิ่มเวลาเข้า/ออก)

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

time_adjust.created

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

ตัวอย่าง Payload:


{
  "request_id": "req_ta12345678",
  "event": "time_adjust.created",
  "event_occurred_at": "2025-01-22 09:45:00",
  "body": {
    "time_adjust_id": "TA2501005",
    "employee_id": "20250105QRST7890",
    "time_adjust_flag_lv": "IN",
    "time_adjust_dt": "2025-01-21",
    "time_adjust_time": "08:25",
    "time_adjust_desc": "ลืมสแกนนิ้วเข้างานตอนเช้า",
    "time_adjust_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": "05",
    "company_id": "C001",
    "branch_id": "B001",
    "department_id": "D001",
    "position_id": "P005",
    "full_name": "ชูใจ น่ารัก",
    "approval_status": "Pending",
    "source": "hms_admin",
    "resource_type": "time_adjust",
    "actor_id": "EMP001",
    "time_adjust_flag_name": "เพิ่มเวลาเข้างาน",
    "time_adjust_flag_name_en": "Add Check-In Time",
    "time_adjust_direction": "IN",
    "employee_title_name": "นาง"
  }
}

time_adjust.updated

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

ตัวอย่าง Payload:


{
  "request_id": "req_ta12345679",
  "event": "time_adjust.updated",
  "event_occurred_at": "2025-01-22 09:50:00",
  "body": {
    "time_adjust_id": "TA2501005",
    "employee_id": "20250105QRST7890",
    "time_adjust_flag_lv": "IN",
    "time_adjust_dt": "2025-01-21",
    "time_adjust_time": "08:30",
    "time_adjust_desc": "ลืมสแกนนิ้วเข้างานตอนเช้า (แก้เวลา)",
    "time_adjust_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": "05",
    "company_id": "C001",
    "branch_id": "B001",
    "department_id": "D001",
    "position_id": "P005",
    "full_name": "ชูใจ น่ารัก",
    "approval_status": "Pending",
    "source": "hms_admin",
    "resource_type": "time_adjust",
    "actor_id": "EMP001",
    "time_adjust_flag_name": "เพิ่มเวลาเข้างาน",
    "time_adjust_flag_name_en": "Add Check-In Time",
    "time_adjust_direction": "IN",
    "employee_title_name": "นาง"
  }
}

time_adjust.deleted

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

ตัวอย่าง Payload:


{
  "request_id": "req_ta12345680",
  "event": "time_adjust.deleted",
  "event_occurred_at": "2025-01-22 09:55:00",
  "body": {
    "time_adjust_id": "TA2501005",
    "employee_id": "20250105QRST7890",
    "time_adjust_flag_lv": "IN",
    "time_adjust_dt": "2025-01-21",
    "time_adjust_time": "08:30",
    "time_adjust_desc": "ลืมสแกนนิ้วเข้างานตอนเช้า (แก้เวลา)",
    "time_adjust_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": "05",
    "company_id": "C001",
    "branch_id": "B001",
    "department_id": "D001",
    "position_id": "P005",
    "full_name": "ชูใจ น่ารัก",
    "approval_status": "Pending",
    "source": "hms_admin",
    "resource_type": "time_adjust",
    "actor_id": "EMP001",
    "time_adjust_flag_name": "เพิ่มเวลาเข้างาน",
    "time_adjust_flag_name_en": "Add Check-In Time",
    "time_adjust_direction": "IN",
    "employee_title_name": "นาง"
  }
}

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

time_adjust.approval_progressed

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

ตัวอย่าง Payload:


{
  "request_id": "req_ta12345681",
  "event": "time_adjust.approval_progressed",
  "event_occurred_at": "2025-01-22 10:30:00",
  "body": {
    "time_adjust_id": "TA2501005",
    "employee_id": "20250105QRST7890",
    "time_adjust_flag_lv": "IN",
    "time_adjust_dt": "2025-01-21",
    "time_adjust_time": "08:25",
    "time_adjust_desc": "ลืมสแกนนิ้วเข้างานตอนเช้า",
    "time_adjust_path": null,
    "approve_flag": "04",
    "approve_id": "MGR001",
    "approve_upd": "2025-01-22 10:30:00",
    "approve_remark": "รับทราบ",
    "approve_method": "01",
    "document_approve_flag": "04",
    "document_created_by": "EMP001",
    "document_last_upd_by": "MGR001",
    "employee_code": "EMP001",
    "employee_title_lv": "05",
    "company_id": "C001",
    "branch_id": "B001",
    "department_id": "D001",
    "position_id": "P005",
    "full_name": "ชูใจ น่ารัก",
    "approval_status": "Approval Progressed Step 1",
    "source": "hms_admin",
    "resource_type": "time_adjust",
    "actor_id": "MGR001",
    "time_adjust_flag_name": "เพิ่มเวลาเข้างาน",
    "time_adjust_flag_name_en": "Add Check-In Time",
    "time_adjust_direction": "IN",
    "employee_title_name": "นาง"
  }
}

time_adjust.approved

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

ตัวอย่าง Payload:


{
  "request_id": "req_ta12345682",
  "event": "time_adjust.approved",
  "event_occurred_at": "2025-01-22 11:00:00",
  "body": {
    "time_adjust_id": "TA2501005",
    "employee_id": "20250105QRST7890",
    "time_adjust_flag_lv": "IN",
    "time_adjust_dt": "2025-01-21",
    "time_adjust_time": "08:25",
    "time_adjust_desc": "ลืมสแกนนิ้วเข้างานตอนเช้า",
    "time_adjust_path": null,
    "approve_flag": "02",
    "approve_id": "MGR002",
    "approve_upd": "2025-01-22 11: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": "05",
    "company_id": "C001",
    "branch_id": "B001",
    "department_id": "D001",
    "position_id": "P005",
    "full_name": "ชูใจ น่ารัก",
    "approval_status": "Approved",
    "source": "hms_admin",
    "resource_type": "time_adjust",
    "actor_id": "MGR002",
    "time_adjust_flag_name": "เพิ่มเวลาเข้างาน",
    "time_adjust_flag_name_en": "Add Check-In Time",
    "time_adjust_direction": "IN",
    "employee_title_name": "นาง"
  }
}

time_adjust.rejected

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

ตัวอย่าง Payload:


{
  "request_id": "req_ta12345683",
  "event": "time_adjust.rejected",
  "event_occurred_at": "2025-01-22 11:05:00",
  "body": {
    "time_adjust_id": "TA2501005",
    "employee_id": "20250105QRST7890",
    "time_adjust_flag_lv": "IN",
    "time_adjust_dt": "2025-01-21",
    "time_adjust_time": "08:25",
    "time_adjust_desc": "ลืมสแกนนิ้วเข้างานตอนเช้า",
    "time_adjust_path": null,
    "approve_flag": "03",
    "approve_id": "MGR002",
    "approve_upd": "2025-01-22 11: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": "05",
    "company_id": "C001",
    "branch_id": "B001",
    "department_id": "D001",
    "position_id": "P005",
    "full_name": "ชูใจ น่ารัก",
    "approval_status": "Rejected",
    "source": "hms_admin",
    "resource_type": "time_adjust",
    "actor_id": "MGR002",
    "time_adjust_flag_name": "เพิ่มเวลาเข้างาน",
    "time_adjust_flag_name_en": "Add Check-In Time",
    "time_adjust_direction": "IN",
    "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 นี้ (เช่น ผู้ขอ, ผู้อนุมัติตามสายงาน)

Time Adjust Fields

Field	Type	Description
`time_adjust_id`	string	รหัสเอกสารปรับปรุงเวลา
`time_adjust_flag_lv`	string	รหัสประเภทการปรับเวลา (เช่น `IN`, `OUT`)
`time_adjust_dt`	string	วันที่ขอปรับปรุงเวลา (YYYY-MM-DD)
`time_adjust_time`	string	เวลาที่ต้องการแก้ไข (HH:mm)
`time_adjust_desc`	string	เหตุผลในการขอปรับปรุงเวลา
`time_adjust_path`	string	พาธไฟล์แนบ (ถ้ามี)
`time_adjust_flag_name`	string	ชื่อประเภทการปรับเวลา (ภาษาไทย เช่น “เพิ่มเวลาเข้างาน”)
`time_adjust_flag_name_en`	string	ชื่อประเภทการปรับเวลา (ภาษาอังกฤษ)
`time_adjust_direction`	string	ทิศทางการลงเวลา (`IN`, `OUT`, `LUNCH_IN`, etc)

สรุป Time Adjust Events

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