Overtime API Module

ภาพรวม (Overview)

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

Overtime คืออะไร?

Overtime (การทำงานล่วงเวลา) คือการทำงานนอกเหนือจากเวลาทำงานปกติ โดยมีการคำนวณค่าตอบแทนตามอัตราที่กำหนด:

• OT 1.0x = อัตราปกติ (ไม่มีค่าล่วงเวลาเพิ่ม)
• OT 1.5x = 1.5 เท่าของค่าแรงปกติ
• OT 2.0x = 2 เท่าของค่าแรงปกติ
• OT 3.0x = 3 เท่าของค่าแรงปกติ

ประเภท OT (OT Types)

API Endpoints (6 endpoints)

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

Get OT Types

ดึงรายการประเภท OT ทั้งหมดที่เปิดใช้งาน

Use Cases:

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

ดึงข้อมูล

Get OT List

ดึงรายการคำขอ OT ตามเงื่อนไข

Use Cases:

• แสดงรายการคำขอ OT
• ติดตามสถานะการอนุมัติ
• รายงานสรุปการทำ OT

จัดการคำขอ

Submit OT

ยื่นคำขอ OT ใหม่

Use Cases:

• พนักงานยื่นคำขอ OT
• HR สร้างคำขอแทนพนักงาน

Update OT

แก้ไขคำขอ OT ที่ยังไม่อนุมัติ

Use Cases:

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

Delete OT

ลบคำขอ OT

Use Cases:

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

นำเข้าข้อมูล

Import OT

นำเข้าเอกสาร OT แบบกลุ่ม (Batch Import)

Use Cases:

• ย้ายข้อมูล OT จากระบบเดิม
• อัปเดตข้อมูล OT จำนวนมาก
• รับข้อมูลจากระบบภายนอก

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'",
    "'ot_work_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. OT Limit - อาจมีการจำกัดชั่วโมง OT ต่อวัน/เดือน ขึ้นอยู่กับการตั้งค่าระบบ

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

Related APIs

• Get Holiday Types - ดึงรายการประเภทวันหยุด
• Get Holiday Change List - ดึงรายการคำขอเปลี่ยนวันหยุด