Search Time Attendance

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

Endpoint


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

สิทธิ์ที่ต้องการ: API Key ต้องมีสิทธิ์ ข้อมูลเงินเดือนของพนักงาน (payroll:read:self)

Request Parameters

Required Parameters

Parameter	Type	Required	Description	Example
`employee_code`	string	Yes	รหัสพนักงาน	`"EMP001"`
`date_from`	string	Yes	วันที่เริ่มต้น (YYYY-MM-DD)	`"2026-01-01"`
`date_to`	string	Yes	วันที่สิ้นสุด (YYYY-MM-DD)	`"2026-01-31"`

Optional Parameters

Parameter	Type	Default	Description	Example
`time_attendance_type_lv`	string	-	กรองตามประเภทการบันทึก	`"Manual"`
`location_name`	string	-	กรองตามชื่อสถานที่ (ตรงตัว)	`"สำนักงานใหญ่"`
`search`	string	-	ค้นหาจากชื่อ, รหัสพนักงาน, สถานที่ (partial match)	`"EMP001"`
`language_code`	string	`"TH"`	ภาษา: `TH` หรือ `EN`	`"TH"`
`_PAGE`	integer	`1`	หน้าที่ต้องการดึงข้อมูล (เริ่มที่ 1)	`1`
`_NUMBER_PER_PAGE`	integer	`10`	จำนวนรายการต่อหน้า (1-100)	`10`

Attendance Types

Value	Description
`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": ""
    }
  ],
  "_PAGINATION": {
    "_TOTAL_RECORDS": 24,
    "_PAGE": 1,
    "_NUMBER_PER_PAGE": 10
  }
}

Pagination Fields

Field	Type	Description
`_PAGINATION._TOTAL_RECORDS`	integer	จำนวนรายการทั้งหมดหลังกรอง (ก่อนแบ่งหน้า)
`_PAGINATION._PAGE`	integer	หน้าปัจจุบัน
`_PAGINATION._NUMBER_PER_PAGE`	integer	จำนวนรายการต่อหน้า

Key Response Fields

Field	Type	Description
`time_attendance_transac_id`	string	รหัสรายการลงเวลา — ใช้สำหรับ Edit Time API
`time_attendance_type_lv`	string	ประเภทการลงเวลา
`attendance_date`	string	วันที่ลงเวลา (YYYY-MM-DD)
`attendance_datetime`	string	วันเวลาที่ลงเวลา (YYYY-MM-DD HH:mm:ss)
`work_type_lv`	string	รอบการทำงาน: `"1"` (เช้า), `"2"` (บ่าย), `null` (ไม่ระบุ)
`attendance_inout`	string	ทิศทาง: `"IN"` (เข้างาน), `"OUT"` (ออกงาน), `null`
`latitude` / `longitude`	string	พิกัด GPS (มีค่าเมื่อเช็คอินผ่าน GPS)
`location_name`	string	ชื่อสถานที่

Error Response


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

Code Examples

cURL


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&_PAGE=1&_NUMBER_PER_PAGE=10" \
  -H "Ocp-Apim-Subscription-Key: YOUR_API_KEY"

JavaScript


const params = new URLSearchParams({
  path_action: 'search_time_attendance',
  employee_code: 'EMP001',
  date_from: '2026-01-01',
  date_to: '2026-01-31',
  language_code: 'TH',
  _PAGE: '1',
  _NUMBER_PER_PAGE: '10'
})
const response = await fetch(
  `https://openapi.humansoft.co.th/api/v1/open-apis/salary/get-data-filter?${params}`,
  {
    method: 'GET',
    headers: { 'Ocp-Apim-Subscription-Key': 'YOUR_API_KEY' }
  }
)
const data = await response.json()
data.payload.forEach(r => {
  console.log(`${r.attendance_datetime} - ${r.time_attendance_type_lv} (${r.attendance_inout || 'N/A'})`)
})

Python


import requests
 
url = "https://openapi.humansoft.co.th/api/v1/open-apis/salary/get-data-filter"
headers = {"Ocp-Apim-Subscription-Key": "YOUR_API_KEY"}
params = {
    "path_action": "search_time_attendance",
    "employee_code": "EMP001",
    "date_from": "2026-01-01",
    "date_to": "2026-01-31",
    "language_code": "TH",
    "_PAGE": 1,
    "_NUMBER_PER_PAGE": 10
}
 
response = requests.get(url, headers=headers, params=params)
data = response.json()
for r in data["payload"]:
    print(f"{r['attendance_datetime']} - {r['time_attendance_type_lv']}")

PHP


<?php
$params = http_build_query([
    "path_action" => "search_time_attendance",
    "employee_code" => "EMP001",
    "date_from" => "2026-01-01",
    "date_to" => "2026-01-31",
    "language_code" => "TH",
    "_PAGE" => 1,
    "_NUMBER_PER_PAGE" => 10
]);
$url = "https://openapi.humansoft.co.th/api/v1/open-apis/salary/get-data-filter?{$params}";
 
$ch = curl_init($url);
curl_setopt($ch, CURLOPT_HTTPHEADER, ["Ocp-Apim-Subscription-Key: YOUR_API_KEY"]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
 
$response = curl_exec($ch);
curl_close($ch);
 
$data = json_decode($response, true);
foreach ($data["payload"] as $r) {
    echo "{$r['attendance_datetime']} - {$r['time_attendance_type_lv']}\n";
}
?>

Notes

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

Search Time Attendance Full - ค้นหาแบบ HRS full search รองรับหลายพนักงานและ filter lists
Get Detail - ดูรายละเอียดรายการเดียว
Edit Time - แก้ไขรายการลงเวลา (ใช้ time_attendance_transac_id)
Add Time Attendance - เพิ่มรายการลงเวลาใหม่