Quota API (โควตาการลา)

ภาพรวม (Overview)

Quota API ใช้สำหรับจัดการโควตาวันลาของพนักงาน รองรับการดูรายการโควตาทั้งหมด ดูโควตาแยกตามพนักงาน สร้าง/แก้ไข/ลบโควตา และดึงข้อมูลประเภทการลาที่เปิดใช้งาน

โควตาการลาคือจำนวนวันลาที่พนักงานมีสิทธิ์ใช้ในแต่ละปี แยกตามประเภทการลา เช่น ลาป่วย ลากิจ ลาพักร้อน เป็นต้น

สิทธิ์ที่ต้องการ: API ในกลุ่มนี้ต้องการสิทธิ์ ข้อมูลเงินเดือนของพนักงาน (payroll:read:self) สำหรับข้อมูลรายคน หรือ ข้อมูลเงินเดือนทั้งองค์กร (payroll:read:all) สำหรับปิดงวด/ประมวลผลทั้งงวด — ขึ้นกับแต่ละ endpoint

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

Code	ชื่อ (TH)	ชื่อ (EN)
`01`	ลากิจ	Leave with Paid
`02`	ลาไม่รับค่าจ้าง	Leave without Paid
`03`	ลาป่วย	Medical Leave
`04`	ลาคลอดรับค่าจ้าง	Maternity with Paid
`05`	ลาคลอดไม่รับค่าจ้าง	Maternity without Paid
`06`	ลาพักร้อน	Annual Leave
`07`	ลาฝึกอบรม	Training Leave
`08`	ลาทำหมัน	Sterilization Leave
`09`	ขาดงาน	Lost/Absence

API Endpoints

ดูข้อมูลโควตา

Endpoint	รายละเอียด
List Quotas	ดูรายการโควตาทั้งหมด พร้อม pagination และ filter
Get Quota by ID	ดูรายละเอียดโควตาตาม ID
Get Quota by Employee	ดูโควตาทั้งหมดของพนักงานคนเดียว
Get Default Quota	คำนวณโควตาเริ่มต้นจากกฎธุรกิจ
Get Leave Types	ดูประเภทการลาที่เปิดใช้งาน

จัดการโควตา

Endpoint	รายละเอียด
Save Quota	สร้าง/อัปเดตโควตา (Upsert) รองรับหลายพนักงาน
Update Quota	แก้ไขจำนวนโควตา
Delete Quota	ลบโควตา

Sub-modules

หมวด	รายละเอียด
Actual Leave	บันทึก/ดู/แก้ไข/ลบการลาจริง
Calculate	คำนวณและจัดการโควตาประจำปี
Import	นำเข้า/ส่งออกข้อมูลโควตาผ่าน Excel
Report	รายงานโควตาประจำปี

หมายเหตุ

Parameter ที่ลงท้ายด้วย _id ใน Request ต้องเข้ารหัส Base64 เสมอ
หน่วยของโควตา (unit) มีได้ 2 แบบ: "วัน" (days) หรือ "ชั่วโมง" (hours)
quota_year ใช้รูปแบบ YYYY เช่น "2026"