Reference Data (ข้อมูลอ้างอิง)

API สำหรับดึงข้อมูลอ้างอิงที่ใช้ร่วมกับ API อื่นๆ ในโมดูล Salary เช่น กะการทำงาน ประเภทวันหยุด วันหยุดบริษัท และโควตาวันหยุดพิเศษ

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

Endpoints

Method	Endpoint	Description
GET	Get Work Shifts	ดึงรายการกะการทำงานทั้งหมด
GET	Get Holiday Types	ดึงรายการประเภทวันหยุดทั้งหมด
GET	Get Company Holidays	ดึงรายการวันหยุดบริษัทตามปีที่ระบุ
GET	Get Extra Holiday Quota	ดึงโควตาวันหยุดพิเศษของพนักงาน

การใช้งาน

ข้อมูลอ้างอิงเหล่านี้ใช้ประกอบกับ API หลักต่างๆ ในระบบ:

Reference Data	ใช้งานร่วมกับ
Work Shifts	Calendar, Time Table, Work Cycle Plan
Holiday Types	Calendar, Daily Info
Company Holidays	Calendar, Daily Info
Extra Holiday Quota	Calendar (holiday_flag_lv = ‘04’)

ข้อมูลอ้างอิงเป็นข้อมูลประเภท Master Data ที่ไม่เปลี่ยนแปลงบ่อย แนะนำให้ทำ cache เพื่อลดจำนวนการเรียก API
ทุก API ในส่วนนี้ใช้ HTTP method GET และรองรับ parameter language_code สำหรับเลือกภาษา (TH หรือ EN)