Holiday Change API Module

ภาพรวม (Overview)

โมดูล Holiday Change เป็น API สำหรับจัดการการเปลี่ยนวันหยุด/วันทำงานของพนักงาน รวมถึงการยื่นคำขอ การอนุมัติ และการติดตามสถานะ

Holiday Change คืออะไร?

Holiday Change (การเปลี่ยนวันหยุด) คือกระบวนการที่พนักงานขอเปลี่ยนประเภทของวันใดวันหนึ่ง:

• Change Mode = เปลี่ยนประเภทวัน เช่น วันทำงาน → วันหยุด
• Switch Mode = สลับวัน เช่น ทำงานวันเสาร์แทนวันจันทร์

ประเภทวัน (Holiday Flag)

API Endpoints (5 endpoints)

ข้อมูลพื้นฐาน

Get Holiday Types

ดึงรายการประเภทวันหยุดทั้งหมด

Use Cases:

• แสดง dropdown เลือกประเภทวันหยุด
• ใช้อ้างอิง code กับชื่อประเภท

ดึงข้อมูล

Get Holiday Change List

ดึงรายการคำขอเปลี่ยนวันหยุดตามเงื่อนไข

Use Cases:

• แสดงรายการคำขอเปลี่ยนวันหยุด
• ติดตามสถานะการอนุมัติ
• รายงานสรุปการเปลี่ยนวันหยุด

จัดการคำขอ

Submit Holiday Change

ยื่นคำขอเปลี่ยนวันหยุดใหม่

Use Cases:

• พนักงานยื่นคำขอเปลี่ยนวันหยุด
• HR สร้างคำขอแทนพนักงาน

Update Holiday Change

แก้ไขคำขอเปลี่ยนวันหยุดที่ยังไม่อนุมัติ

Use Cases:

• แก้ไขรายละเอียดคำขอ
• เปลี่ยนประเภทวันหยุด

Delete Holiday Change

ลบคำขอเปลี่ยนวันหยุด

Use Cases:

• ยกเลิกคำขอที่ยื่นผิดพลาด
• ลบคำขอที่ไม่ต้องการ

Approve Status (สถานะการอนุมัติ)

Standard Response Format

Success Response

{
  "code": 200,
  "message": "สำเร็จ",
  "payload": { ... }
}

Error Response

{
  "code": 400,
  "message": "ไม่สำเร็จ",
  "error": "Error message"
}

Validation Error Response

{
  "code": 400,
  "message": "Validation failed",
  "errors": [
    "Missing required parameter: 'employee_code'",
    "'holiday_change_dt' must be in Y-m-d format"
  ]
}

หมายเหตุสำคัญ

1. Authentication Required - API เหล่านี้ต้องการ Ocp-Apim-Subscription-Key header

2. Finish Month Check - ไม่สามารถสร้าง/แก้ไข/ลบคำขอในงวดเงินเดือนที่ปิดแล้ว

3. Cut-off Date - อาจมีการจำกัดวันที่สามารถยื่นคำขอได้ ขึ้นอยู่กับการตั้งค่าระบบ

4. Quota Limit - อาจมีการจำกัดจำนวนคำขอต่องวด ขึ้นอยู่กับการตั้งค่าระบบ

5. Approval Workflow - คำขอจะต้องผ่านการอนุมัติตามลำดับขั้นที่กำหนด

Related APIs

• Get Employee Workday - ดึงรูปแบบวันทำงาน
• Update Employee Workday - แก้ไขรูปแบบวันทำงาน