Get Time Attendance Detail

ดูรายละเอียดของรายการลงเวลาเดียว โดยใช้ time_attendance_transac_id เป็น key

Endpoint


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

Request Parameters

Parameter	Type	Required	Description	Example
`employee_code`	string	Yes	รหัสพนักงาน	`"EMP001"`
`time_attendance_transac_id`	string	Yes	รหัสรายการลงเวลา (Base64)	`"MjAyNjAxMjhERTg5NkE4MjFGNzA="`
`language_code`	string	No	ภาษา: `TH` หรือ `EN`	`"TH"`

ระบบจะตรวจสอบว่ารายการลงเวลานั้นเป็นของพนักงานที่ระบุจริง — ถ้าไม่ใช่จะ return error 404

Response Format

Success Response


{
  "code": 200,
  "message": "Get Time Attendance Detail Success",
  "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": "1",
    "latitude": "13.756331",
    "longitude": "100.501762",
    "temperature": "0.00",
    "attendance_inout": "IN",
    "attendance_remark": null,
    "employee_name": "สมชาย",
    "employee_last_name": "ใจดี",
    "location_name": "สำนักงานใหญ่",
    "device_name": "เครื่องสแกนลายนิ้วมือ 1"
  }
}

Response Fields

Field	Type	Description
`time_attendance_transac_id`	string	รหัสรายการลงเวลา (plain text)
`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`
`latitude` / `longitude`	string	พิกัด GPS
`temperature`	string	อุณหภูมิที่วัดได้ (default: `"0.00"`)
`attendance_inout`	string	ทิศทาง: `"IN"`, `"OUT"`, `null`
`location_name`	string	ชื่อสถานที่
`device_name`	string	ชื่ออุปกรณ์ที่ใช้ลงเวลา

Error Response


{
  "code": 404,
  "message": "Time attendance record not found",
  "payload": []
}

Code Examples

cURL


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

JavaScript


const params = new URLSearchParams({
  path_action: 'get_time_attendance_detail',
  employee_code: 'EMP001',
  time_attendance_transac_id: 'MjAyNjAxMjhERTg5NkE4MjFGNzA=',
  language_code: 'TH'
})
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()
const p = data.payload
console.log(`${p.attendance_datetime} - ${p.time_attendance_type_lv} at ${p.location_name}`)

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": "get_time_attendance_detail",
    "employee_code": "EMP001",
    "time_attendance_transac_id": "MjAyNjAxMjhERTg5NkE4MjFGNzA=",
    "language_code": "TH"
}
 
response = requests.get(url, headers=headers, params=params)
data = response.json()
p = data["payload"]
print(f"{p['attendance_datetime']} - {p['time_attendance_type_lv']} at {p['location_name']}")

PHP


<?php
$params = http_build_query([
    "path_action" => "get_time_attendance_detail",
    "employee_code" => "EMP001",
    "time_attendance_transac_id" => "MjAyNjAxMjhERTg5NkE4MjFGNzA=",
    "language_code" => "TH"
]);
$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);
$p = $data["payload"];
echo "{$p['attendance_datetime']} - {$p['time_attendance_type_lv']} at {$p['location_name']}\n";
?>

Notes

time_attendance_transac_id ใน request ต้องเป็น Base64 encoded
ใช้ Search Time Attendance เพื่อหา time_attendance_transac_id
ใช้ API นี้ก่อนเรียก Edit Time เพื่อดูข้อมูลเดิมก่อนแก้ไข

Search Time Attendance - ค้นหารายการเพื่อหา ID
Edit Time - แก้ไขรายการหลังจากดูรายละเอียด
Add Time Attendance - เพิ่มรายการใหม่

Get Time Attendance Detail

Endpoint

Request Parameters

Response Format

Success Response

Response Fields

Error Response

Code Examples

cURL

JavaScript

Python

PHP

Notes

Related APIs