Time Leave API Module

ภาพรวม (Overview)

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

Time Leave คืออะไร?

Time Leave (การลางาน) คือการขอหยุดงานของพนักงานด้วยเหตุผลต่างๆ โดยมีประเภทการลาหลากหลาย:

• ลาป่วย = หยุดงานเนื่องจากเจ็บป่วย
• ลากิจ = หยุดงานเพื่อธุระส่วนตัว
• ลาพักร้อน = หยุดงานตามสิทธิ์วันหยุดประจำปี
• อื่นๆ = ประเภทการลาตามที่บริษัทกำหนด

ประเภทการลา (Leave Types)

API Endpoints (6 endpoints)

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

Get Leave Types

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

Use Cases:

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

ดึงข้อมูล

Get Leave List

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

Use Cases:

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

จัดการคำขอ

Submit Leave

ยื่นคำขอลาใหม่

Use Cases:

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

Update Leave

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

Use Cases:

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

Delete Leave

ลบคำขอลา

Use Cases:

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

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

Import Leave

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

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'",
    "'effective_hour' must be in YYYY-MM-DD HH:MM:SS format"
  ]
}

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

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

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

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

4. Quota Limit - มีการจำกัดจำนวนวันลาตามโควตาของแต่ละประเภท

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

6. Document Limit - จำกัดการยื่นเอกสารไม่เกิน 2 ฉบับต่อวัน

Related APIs

• Get OT Types - ดึงรายการประเภท OT
• Get Holiday Types - ดึงรายการประเภทวันหยุด