List Employee In/Out Daily

ดึงรายการพนักงานพร้อมเวลาเข้า-ออกงานในวันที่ระบุ แสดงเฉพาะพนักงานที่ผู้เรียกมีสิทธิ์ดูได้ (ตัวเอง + ลูกน้อง) พร้อมสถานะวัน, กะการทำงาน, และรายการเวลาเข้า-ออก

Endpoint


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

Request Parameters

Required Parameters

Parameter	Type	Required	Description	Example
`work_date`	string	Yes	วันที่ต้องการดู (YYYY-MM-DD)	`"2026-02-18"`
`employee_code`	string	Yes	รหัสพนักงานผู้เรียก API	`"EMP001"`

Optional Parameters

Parameter	Type	Default	Description	Example
`employee_id`	string	`null`	กรองเฉพาะพนักงานคนนี้ (Base64 encoded)	`"MjAyNjAxMjFGQzg5RjNCQjkxMjA="`
`branch_id`	string	`null`	กรองตามสาขา (Base64 encoded)	`"MjAyNjAxMjFGQzg5RjNCQjkxMjA="`
`department_id`	string	`null`	กรองตามแผนก (Base64 encoded)	`"MjAyNjAxMjFGQzg5RjNCQjkxMjA="`
`keyword`	string	`null`	ค้นหาจากชื่อ นามสกุล ชื่อเล่น (partial match)	`"สมชาย"`
`language_code`	string	`"TH"`	ภาษา: `TH` หรือ `EN`	`"TH"`

work_date ต้องเป็นรูปแบบ YYYY-MM-DD เท่านั้น
ค่า employee_id, branch_id, department_id ต้องเป็น Base64 encoded (ความยาว 20 ตัวอักษรหลัง decode)
keyword ค้นหาได้ทั้งชื่อภาษาไทยและภาษาอังกฤษ

Response Format

Success Response


{
  "code": 200,
  "message": "Success",
  "payload": [
    {
      "employee_id": "20260121FC89F3BB9120",
      "employee_code": "EMP001",
      "employee_name": "สมชาย",
      "employee_last_name": "ใจดี",
      "employee_nickname": "ชาย",
      "employee_name_en": "Somchai",
      "employee_last_name_en": "Jaidee",
      "employee_nickname_en": "Chai",
      "photograph": "https://example.com/photo.jpg",
      "company_id": "20260121FC89F3BB9120",
      "branch_id": "20260121FC89F3BB9120",
      "department_id": "20260121FC89F3BB9120",
      "day_status": "วันทำงาน",
      "work_date": "2026-02-18",
      "work_cycle_start_time": "08:00:00",
      "work_cycle_end_time": "17:00:00",
      "work_cycle_code": "SHIFT_A",
      "time": [
        {
          "time_attendance_transac_id": "20260218TIME00100001",
          "employee_id": "20260121FC89F3BB9120",
          "work_date": "2026-02-18",
          "time_attendance_type_lv": "Checkin",
          "time_attendance_dt": "2026-02-18 08:05:00",
          "time_attendance_location": "สำนักงาน",
          "time_attendance_lat": "13.7563",
          "time_attendance_lng": "100.5018",
          "time_attendance_remark": "",
          "approve_flag": "02"
        },
        {
          "time_attendance_transac_id": "20260218TIME00100002",
          "employee_id": "20260121FC89F3BB9120",
          "work_date": "2026-02-18",
          "time_attendance_type_lv": "Checkin",
          "time_attendance_dt": "2026-02-18 17:10:00",
          "time_attendance_location": "สำนักงาน",
          "time_attendance_lat": "13.7563",
          "time_attendance_lng": "100.5018",
          "time_attendance_remark": "",
          "approve_flag": "02"
        }
      ]
    },
    {
      "employee_id": "20260121FC89F3BB9121",
      "employee_code": "EMP002",
      "employee_name": "สมหญิง",
      "employee_last_name": "รักดี",
      "employee_nickname": "หญิง",
      "employee_name_en": "Somying",
      "employee_last_name_en": "Rakdee",
      "employee_nickname_en": "Ying",
      "photograph": "images/userPlaceHolder.png",
      "company_id": "20260121FC89F3BB9120",
      "branch_id": "20260121FC89F3BB9120",
      "department_id": "20260121FC89F3BB9120",
      "day_status": "ยังไม่ได้เริ่มงาน/ลาออกไปแล้ว",
      "work_date": "2026-02-18",
      "work_cycle_start_time": null,
      "work_cycle_end_time": null,
      "work_cycle_code": null,
      "time": []
    }
  ]
}

Employee Fields (`payload[]`)

Field	Type	Nullable	Description
`employee_id`	string	No	รหัสพนักงาน (plain text, 20 ตัวอักษร)
`employee_code`	string	No	รหัสพนักงาน
`employee_name`	string	No	ชื่อพนักงาน (ตามภาษาที่เลือก)
`employee_last_name`	string	No	นามสกุลพนักงาน (ตามภาษาที่เลือก)
`employee_nickname`	string	Yes	ชื่อเล่นพนักงาน (ตามภาษาที่เลือก)
`employee_name_en`	string	Yes	ชื่อพนักงาน (ภาษาอังกฤษ)
`employee_last_name_en`	string	Yes	นามสกุลพนักงาน (ภาษาอังกฤษ)
`employee_nickname_en`	string	Yes	ชื่อเล่นพนักงาน (ภาษาอังกฤษ)
`photograph`	string	No	URL รูปภาพพนักงาน
`company_id`	string	No	รหัสบริษัท (plain text, 20 ตัวอักษร)
`branch_id`	string	No	รหัสสาขา (plain text, 20 ตัวอักษร)
`department_id`	string	No	รหัสแผนก (plain text, 20 ตัวอักษร)
`day_status`	string	No	สถานะวัน (ดูตารางด้านล่าง)
`work_date`	string	No	วันที่ทำงาน (YYYY-MM-DD)
`work_cycle_start_time`	string	Yes	เวลาเริ่มกะ (HH:mm:ss)
`work_cycle_end_time`	string	Yes	เวลาสิ้นสุดกะ (HH:mm:ss)
`work_cycle_code`	string	Yes	รหัสกะการทำงาน
`time`	array	No	รายการเวลาเข้า-ออก

Time Fields (`time[]`)

Field	Type	Nullable	Description
`time_attendance_transac_id`	string	No	รหัส transaction (plain text, 20 ตัวอักษร)
`employee_id`	string	No	รหัสพนักงาน (plain text, 20 ตัวอักษร)
`work_date`	string	No	วันที่ทำงาน (YYYY-MM-DD)
`time_attendance_type_lv`	string	No	ประเภทการลงเวลา
`time_attendance_dt`	string	No	วันเวลาที่ลงเวลา (YYYY-MM-DD HH:mm:ss)
`time_attendance_location`	string	Yes	สถานที่ลงเวลา
`time_attendance_lat`	string	Yes	ละติจูด
`time_attendance_lng`	string	Yes	ลองจิจูด
`time_attendance_remark`	string	Yes	หมายเหตุ
`approve_flag`	string	No	สถานะอนุมัติ

Day Status

สถานะ	รายละเอียด
`วันทำงาน`	วันทำงานปกติ
`วันหยุดนักขัตฤกษ์`	วันหยุดประจำปี (แสดงพร้อมชื่อวันหยุด)
`ยังไม่ได้เริ่มงาน/ลาออกไปแล้ว`	พนักงานยังไม่เริ่มงานหรือลาออกแล้ว

Approve Flag

Value	รายละเอียด
`"01"`	รออนุมัติ
`"02"`	อนุมัติแล้ว
`"03"`	ปฏิเสธ

Attendance Types (`time_attendance_type_lv`)

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

Error Responses

Employee Not Found (HTTP 404)


{
  "code": 404,
  "message": "Employee not found with code: EMP001"
}

Missing Required Parameters (HTTP 400)


{
  "code": 400,
  "message": "ไม่สำเร็จ",
  "errors": {
    "work_date": "work_date is required",
    "employee_code": "employee_code is required"
  }
}

Invalid Date Format (HTTP 400)


{
  "code": 400,
  "message": "ไม่สำเร็จ",
  "errors": {
    "work_date": "Invalid format. Expected YYYY-MM-DD"
  }
}

Invalid ID Format (HTTP 400)


{
  "code": 400,
  "message": "ไม่สำเร็จ",
  "errors": {
    "employee_id": "Invalid base64 format or length",
    "branch_id": "Invalid base64 format or length"
  }
}

Code Examples

cURL


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

JavaScript


const params = new URLSearchParams({
  path_action: 'list_employee_inout_daily',
  work_date: '2026-02-18',
  employee_code: 'EMP001',
  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()
data.payload.forEach(emp => {
  console.log(`${emp.employee_code} - ${emp.employee_name} ${emp.employee_last_name}`)
  emp.time.forEach(t => {
    console.log(`  ${t.time_attendance_dt} - ${t.time_attendance_type_lv}`)
  })
})

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": "list_employee_inout_daily",
    "work_date": "2026-02-18",
    "employee_code": "EMP001",
    "language_code": "TH"
}
 
response = requests.get(url, headers=headers, params=params)
data = response.json()
for emp in data["payload"]:
    print(f"{emp['employee_code']} - {emp['employee_name']} {emp['employee_last_name']}")
    for t in emp["time"]:
        print(f"  {t['time_attendance_dt']} - {t['time_attendance_type_lv']}")

PHP


<?php
$params = http_build_query([
    "path_action" => "list_employee_inout_daily",
    "work_date" => "2026-02-18",
    "employee_code" => "EMP001",
    "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);
foreach ($data["payload"] as $emp) {
    echo "{$emp['employee_code']} - {$emp['employee_name']} {$emp['employee_last_name']}\n";
    foreach ($emp["time"] as $t) {
        echo "  {$t['time_attendance_dt']} - {$t['time_attendance_type_lv']}\n";
    }
}
?>

Notes

API นี้แสดงเฉพาะพนักงานที่ผู้เรียกมีสิทธิ์ดูได้ (ตัวเอง และลูกน้อง)
ถ้าพนักงานไม่มีข้อมูลกะในวันที่ระบุ time จะเป็น array ว่าง และ work_cycle fields จะเป็น null
รายการเวลาเข้า-ออกเรียงตาม time_attendance_dt
แนะนำให้ใช้ parameters กรองข้อมูล (branch_id, department_id, keyword) เพื่อลดปริมาณข้อมูลที่ดึง
ระบบจะซ่อนรายการพนักงานที่ถูกลบโดยอัตโนมัติ

Search Time Attendance - ค้นหาประวัติการลงเวลาตามช่วงวันที่ (หลายวัน)
Calendar - ดูข้อมูลปฏิทินการทำงาน