Skip to Content
🚀 Welcome to Humansoft Open API Documentation
DocumentationAPI ReferenceSalary (เงินเดือน)Attendance (บันทึกเวลา)Overview

Attendance (บันทึกเวลา)

จัดการข้อมูลการบันทึกเวลาทำงานของพนักงาน รองรับหลายประเภทการลงเวลา เช่น สแกนลายนิ้วมือ, เช็คอินผ่าน GPS, บันทึกด้วยมือ และอื่นๆ

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

Endpoints

MethodEndpointDescription
GETSearch Time Attendanceค้นหาประวัติการลงเวลาของพนักงานคนเดียว (ใช้ employee_code)
POSTSearch Time Attendance Fullค้นหาแบบ HRS full search รองรับหลายพนักงานและ filter lists
GETGet Detailดูรายละเอียดรายการลงเวลาเดียว
POSTAdd Time Attendanceเพิ่มรายการบันทึกเวลาใหม่
POSTEdit Timeเพิ่ม/แก้ไข/ลบเวลาทำงาน

Attendance Types

ระบบรองรับหลายประเภทการบันทึกเวลา:

TypeDescription
Checkinเช็คอินผ่านระบบ
Fingerprintสแกนลายนิ้วมือ
Facialสแกนใบหน้า
Manualบันทึกด้วยมือโดย HR/Admin
TimeAppบันทึกผ่านแอปพลิเคชัน
QRเช็คอินผ่าน QR Code
LINE-Checkinเช็คอินผ่าน LINE
Wifiเช็คอินผ่านเครือข่าย Wi-Fi
Beaconเช็คอินผ่านอุปกรณ์ Beacon
  • API ในกลุ่มนี้ใช้ employee_code แทน employee_id เพื่อความสะดวก
  • time_attendance_transac_id ที่ใช้ใน request ต้องเป็น Base64 encoded
  • ระบบจะซ่อนรายการที่ถูกลบโดยอัตโนมัติ
Last updated on