Time Attendance API Module

ภาพรวม (Overview)

โมดูล Time Attendance เป็น API สำหรับจัดการข้อมูลบันทึกเวลาเข้า-ออกงานของพนักงาน รองรับการบันทึกเวลาหลายรูปแบบ (Checkin, Wifi, Beacon, QR, Facial, Manager, Offline) และการนำเข้าข้อมูลแบบกลุ่ม (Batch Import)

Time Attendance คืออะไร?

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

API Endpoints (2 endpoints)

บันทึกเวลา

Submit Time Attendance

บันทึกเวลาเข้า-ออกของพนักงาน รองรับ 7 ประเภทการบันทึก

Use Cases:

• พนักงาน Checkin/Checkout ผ่านแอปพลิเคชัน
• บันทึกเวลาผ่าน Wifi, Beacon หรือ QR Code
• ผู้จัดการบันทึกเวลาให้พนักงาน
• บันทึกเวลาด้วยการยืนยันใบหน้า

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

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

• Overtime - จัดการคำขอทำงานล่วงเวลา
• Time Leave - จัดการการลางาน