Time Attendance API Module

ภาพรวม (Overview)

โมดูล Time Attendance เป็น API สำหรับจัดการข้อมูลบันทึกเวลาเข้า-ออกงานของพนักงาน รองรับการบันทึกเวลา 2 รูปแบบ (Checkin ด้วย GPS และ Device ผ่านอุปกรณ์) และการนำเข้าข้อมูลแบบกลุ่ม (Batch Import)

Time Attendance คืออะไร?

Time Attendance (บันทึกเวลา) คือข้อมูลการเข้า-ออกงานของพนักงาน โดยมีประเภทการบันทึก:

API Endpoints (2 endpoints)

บันทึกเวลา

Submit Time Attendance

บันทึกเวลาเข้า-ออกของพนักงาน รองรับ 2 ประเภทการบันทึก: Checkin และ Device

Use Cases:

• พนักงาน Checkin/Checkout ผ่านแอปพลิเคชัน (GPS)
• บันทึกเวลาผ่านอุปกรณ์ที่ลงทะเบียนในระบบ

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

Import Time Attendance

นำเข้าข้อมูลบันทึกเวลาแบบกลุ่ม (Batch Import) รองรับทั้งการเพิ่ม (ADD) และการลบ (DEL)

Use Cases:

• ย้ายข้อมูลบันทึกเวลาจากระบบเดิม
• รับข้อมูลจากเครื่องสแกนลายนิ้วมือ
• แก้ไขข้อมูลบันทึกเวลาจำนวนมาก

Standard Response Format

Success Response

{
  "code": 200,
  "message": "successfully en-queued",
  "payload": { ... }
}

Error Response

{
  "code": 400,
  "message": "Validation failed",
  "errors": ["Missing 'import_data' field"]
}

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

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

2. Asynchronous Processing - ข้อมูลจะถูกส่งเข้า Queue เพื่อประมวลผล API จะตอบกลับทันทีหลัง validate สำเร็จ

3. Partial Success - ระบบจะประมวลผลเฉพาะรายการที่ถูกต้อง และแจ้งรายการที่ไม่ถูกต้องกลับมาใน response

Related APIs

• Devices - ดึงรายการอุปกรณ์สำหรับอ้างอิง device_sn, device_name
• Locations - ดึงรายการสถานที่สำหรับอ้างอิง location_id
• Overtime - จัดการคำขอทำงานล่วงเวลา
• Time Leave - จัดการการลางาน