Time Table (ตารางเวลา)

จัดการและดูข้อมูลตารางเวลาทำงานของพนักงาน รวมถึงข้อมูลรายวัน, ปฏิทิน, สรุปเงินเดือน, สลิปเงินเดือน, การคำนวณ และการแจ้งเตือน

Endpoints

Method	Endpoint	Description
GET	Daily In Month	ดูตารางเวลาทำงานทั้งเดือน พร้อมเวลาเข้า-ออก, กะ, เอกสาร, สรุปเงินเดือน
GET	A Daily In Month	ดูข้อมูลวันทำงานวันเดียวในรอบเดือน พร้อมผลการคำนวณและเอกสาร
GET	Current Month	ดูรอบเดือนเงินเดือนปัจจุบัน
GET	Daily Info	ดูรายละเอียดวันทำงาน พร้อม options สำหรับจัดการเวลา
GET	Daily In Month Calendar	ดูปฏิทินรายวัน พร้อมกรองตามประเภท
GET	Salary Summary	ดูสรุปเงินเดือนของรอบเดือนที่ระบุ
GET	Slip Normal	ดูสลิปเงินเดือน (PDF)
POST	Calculate Month	คำนวณเวลาทำงานและเงินเดือนประจำเดือน
POST	Calculate Month Queue	คำนวณเวลาทำงานและเงินเดือนแบบ Batch Processing สำหรับพนักงานหลายคน
GET	List Calculate Month Queue	ตรวจสอบสถานะรายการคำนวณที่ส่งเข้าคิว
POST	Finish Month	ปิดงวดเงินเดือน เพื่อล็อคข้อมูลไม่ให้แก้ไข
POST	Unfinish Month	ยกเลิกการปิดงวดเงินเดือน เพื่อแก้ไขข้อมูลย้อนหลัง
GET	Get Employee Tooltip	ดูรายการแจ้งเตือน/คำแนะนำของพนักงาน
POST	Close Tooltip	ปิดข้อความแจ้งเตือนของพนักงาน

การใช้งานทั่วไป

การทำงานกับ Time Table APIs โดยทั่วไปจะมีลำดับดังนี้:

เรียก Current Month เพื่อดูรอบเดือนปัจจุบัน
เรียก Daily In Month หรือ Daily In Month Calendar เพื่อดูตารางเวลาทำงาน
เรียก Daily Info หรือ A Daily In Month เพื่อดูรายละเอียดรายวัน
เรียก Calculate Month หรือ Calculate Month Queue เพื่อคำนวณเวลาทำงานและเงินเดือน
เรียก List Calculate Month Queue เพื่อตรวจสอบสถานะการคำนวณ (กรณีใช้ Queue)
เรียก Salary Summary เพื่อดูสรุปเงินเดือน
เรียก Slip Normal เพื่อดูสลิปเงินเดือน
เรียก Finish Month เพื่อปิดงวดเงินเดือน (หรือ Unfinish Month เพื่อยกเลิกการปิดงวด)
เรียก Get Employee Tooltip เพื่อดูการแจ้งเตือน (หรือ Close Tooltip เพื่อปิดการแจ้งเตือน)

API ในกลุ่มนี้ใช้ employee_code แทน employee_id เพื่อความสะดวก
ID ที่ใช้ใน request ต้องเป็น Base64 encoded
ID ที่ได้จาก response เป็น plain text 20 ตัวอักษร
รอบเดือนอาจไม่ตรงกับเดือนปฏิทิน เช่น รอบ 2026-02 อาจเริ่ม 26 ม.ค. ถึง 25 ก.พ.