Skip to Content
🚀 Welcome to Humansoft Open API Documentation

Search Time Attendance

ค้นหาประวัติการลงเวลาทำงานของพนักงานตามช่วงวันที่ ใช้สำหรับดูประวัติการเข้า-ออกงานและตรวจสอบข้อมูลการลงเวลา

Endpoint

GET /api/v1/open-apis/salary/get-data-filter?path_action=search_time_attendance

Request Parameters

ParameterTypeRequiredDescriptionExample
employee_codestringYesรหัสพนักงาน"EMP001"
date_fromstringYesวันที่เริ่มต้น (YYYY-MM-DD)"2026-01-01"
date_tostringYesวันที่สิ้นสุด (YYYY-MM-DD)"2026-01-31"
time_attendance_type_lvstringNoกรองตามประเภทการบันทึก"Manual"
location_namestringNoกรองตามชื่อสถานที่ (partial match)"สำนักงานใหญ่"
searchstringNoค้นหาจากชื่อ, รหัสพนักงาน, สถานที่"EMP001"
language_codestringNoภาษา: TH หรือ EN"TH"

Attendance Types

ValueDescription
Checkinเช็คอินผ่านระบบ
Fingerprintสแกนลายนิ้วมือ
Facialสแกนใบหน้า
Manualบันทึกด้วยมือโดย HR/Admin
TimeAppบันทึกผ่านแอปพลิเคชัน
QRเช็คอินผ่าน QR Code
LINE-Checkinเช็คอินผ่าน LINE
LINE-QRเช็คอินผ่าน QR Code บน LINE
Wifiเช็คอินผ่านเครือข่าย Wi-Fi
Beaconเช็คอินผ่านอุปกรณ์ Beacon
Importนำเข้าข้อมูลจากไฟล์
Managerผู้จัดการบันทึกเวลาให้
Offlineบันทึกขณะออฟไลน์
Time Adjustปรับแก้เวลา

ช่วงวันที่สูงสุด 92 วัน (ประมาณ 3 เดือน) ต่อ 1 request


Response Format

Success Response

{ "code": 200, "message": "Search Time Attendance (1) Accept", "payload": [ { "time_attendance_transac_id": "20260128DE896A821F70", "time_attendance_type_lv": "Manual", "employee_id": "202503219741427917A0", "employee_code": "EMP001", "attendance_date": "2026-02-18", "attendance_datetime": "2026-02-18 09:00:00", "work_type_lv": null, "latitude": null, "longitude": null, "attendance_inout": null, "attendance_remark": null, "employee_name": "สมชาย", "employee_last_name": "ใจดี", "location_name": null, "device_name": "" } ] }

Key Response Fields

FieldTypeDescription
time_attendance_transac_idstringรหัสรายการลงเวลา — ใช้สำหรับ Edit Time API
time_attendance_type_lvstringประเภทการลงเวลา
attendance_datestringวันที่ลงเวลา (YYYY-MM-DD)
attendance_datetimestringวันเวลาที่ลงเวลา (YYYY-MM-DD HH:mm:ss)
work_type_lvstringรอบการทำงาน: "1" (เช้า), "2" (บ่าย), null (ไม่ระบุ)
attendance_inoutstringทิศทาง: "IN" (เข้างาน), "OUT" (ออกงาน), null
latitude / longitudestringพิกัด GPS (มีค่าเมื่อเช็คอินผ่าน GPS)
location_namestringชื่อสถานที่

Error Response

{ "code": 404, "message": "Employee not found with code: 9999", "payload": [] }

Code Examples

curl -X GET "https://openapi.humansoft.co.th/api/v1/open-apis/salary/get-data-filter?path_action=search_time_attendance&employee_code=EMP001&date_from=2026-01-01&date_to=2026-01-31&language_code=TH" \ -H "Ocp-Apim-Subscription-Key: YOUR_API_KEY"

Notes

  • API นี้ใช้ employee_code แทน employee_id เพื่อความสะดวก
  • ระบบจะซ่อนรายการที่ถูกลบโดยอัตโนมัติ
  • การค้นหาด้วย search หรือ location_name จะ match แบบ partial

  • Get Detail - ดูรายละเอียดรายการเดียว
  • Edit Time - แก้ไขรายการลงเวลา (ใช้ time_attendance_transac_id)
  • Add Time Attendance - เพิ่มรายการลงเวลาใหม่
Last updated on