Holiday API Module

ภาพรวม (Overview)

โมดูล Holiday เป็น API สำหรับจัดการรูปแบบวันทำงาน (Workday Pattern) ของพนักงาน รวมถึงการตั้งค่ากะการทำงานในแต่ละวันของสัปดาห์

Workday Pattern คืออะไร?

รูปแบบวันทำงาน (Workday Pattern) คือการตั้งค่ากำหนดว่าพนักงานจะทำงานกะไหนในแต่ละวัน:

• วันทำงาน (Workday) = การตั้งค่ากะการทำงานรายวัน (Mon-Sun)
• รูปแบบวันทำงาน (Work Cycle Format) = Template หลักที่กำหนดโครงสร้างวันทำงาน

ตัวอย่างรูปแบบวันทำงาน

{
  "Mon": "WC001",  // วันจันทร์ - กะ A (08:00-17:00)
  "Tue": "WC001",  // วันอังคาร - กะ A (08:00-17:00)
  "Wed": "WC001",  // วันพุธ - กะ A (08:00-17:00)
  "Thu": "WC001",  // วันพฤหัสบดี - กะ A (08:00-17:00)
  "Fri": "WC001",  // วันศุกร์ - กะ A (08:00-17:00)
  "Sat": "OFF",    // วันเสาร์ - หยุด
  "Sun": "OFF"     // วันอาทิตย์ - หยุด
}

API Endpoints (2 endpoints)

วันทำงานพนักงาน

Get Employee Workday

ดึงข้อมูลรูปแบบวันทำงานของพนักงาน

Use Cases:

• แสดงการตั้งค่ากะการทำงานรายวันของพนักงาน
• ตรวจสอบวันทำงานและวันหยุดของพนักงาน
• เตรียมข้อมูลก่อนแก้ไข

Update Employee Workday

แก้ไขรูปแบบวันทำงานของพนักงาน

Use Cases:

• เปลี่ยนกะการทำงานในแต่ละวัน
• กำหนดวันหยุดใหม่
• เปลี่ยน Work Cycle Format

Day Keys

รหัสวันที่ใช้ใน API:

Standard Response Format

Success Response

{
  "code": 200,
  "message": "สำเร็จ",
  "payload": {
    "holiday_format": "WF001",
    "holiday_day_json": "{\"Mon\":\"WC001\",\"Tue\":\"WC001\",...}",
    "holiday_lists": {
      "Mon": "A : 08:00-17:00",
      "Tue": "A : 08:00-17:00"
    }
  }
}

Error Response

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

Response Fields

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

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

2. Time Attendance Impact - การเปลี่ยนแปลงรูปแบบวันทำงานจะมีผลกับการคำนวณเวลาทำงาน

3. Real-time Update - ข้อมูลจะอัพเดททันทีเมื่อมีการเปลี่ยนแปลง

Related APIs

• Get Organization Structure - ดึงโครงสร้างองค์กร
• Get Employee Constant List - ดึงรายรับ/รายจ่ายคงที่