Daily Info

ดึงข้อมูลรายละเอียดวันทำงานของพนักงานในวันที่ระบุ แสดงกะ, เวลาเข้า-ออก, เอกสารลา/OT/แก้เวลา, และ options ต่างๆ สำหรับการจัดการเวลา

Endpoint


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

Request Parameters

Parameter	Type	Required	Description	Example
`employee_code`	string	Yes	รหัสพนักงาน	`"EMP001"`
`work_date`	string	Yes	วันที่ทำงาน (YYYY-MM-DD)	`"2026-02-18"`
`language_code`	string	No	ภาษา: `TH` หรือ `EN` (ค่าเริ่มต้น: `TH`)	`"TH"`

Response Format

Success Response


{
  "code": 200,
  "message": "Success",
  "payload": {
    "work_date": "2026-02-18",
    "work_date_format": "18/02/2026",
    "day_status": "วันทำงาน",
    "holiday_count": 0,
    "holiday_flag_lv": "00",
    "work_cycle": "WC002 09:00 - 12:00 - 13:00 - 18:00",
    "work_cycle_code": "WC002",
    "work_cycle_time": "09:00 - 12:00 - 13:00 - 18:00",
    "work_cycle_start_time": "2026-02-18 09:00:00",
    "work_cycle_end_time": "2026-02-18 18:00:00",
    "break_cycle_start_time": "2026-02-18 12:00:00",
    "break_cycle_end_time": "2026-02-18 13:00:00",
    "read_only_flag": "N",
    "time": [
      {
        "time_attendance_transac_id": "20260218ABC123456789",
        "attendance_datetime": "2026-02-18 09:05:00",
        "work_type_lv": "01",
        "time_attendance_type_lv": "Manual"
      },
      {
        "time_attendance_transac_id": "20260218DEF987654321",
        "attendance_datetime": "2026-02-18 18:10:00",
        "work_type_lv": "02",
        "time_attendance_type_lv": "Manual"
      }
    ],
    "docs": {
      "Leave": [],
      "Work_Cycle": [],
      "Holiday": [],
      "OT": [],
      "Time_Adjust": []
    },
    "ot_flag": [
      { "code": "01", "name": "OT 1.0 เท่า" },
      { "code": "02", "name": "OT 1.5 เท่า" },
      { "code": "03", "name": "OT 2.0 เท่า" },
      { "code": "04", "name": "OT 3.0 เท่า" }
    ],
    "leave_flag": [
      { "code": "01", "name": "ลาป่วย", "flag": "D" },
      { "code": "02", "name": "ลากิจ", "flag": "D" },
      { "code": "03", "name": "ลาพักร้อน", "flag": "D" }
    ],
    "holiday_flag": [
      { "code": "00", "name": "ไม่หยุด" },
      { "code": "01", "name": "วันหยุดนักขัตฤกษ์" },
      { "code": "03", "name": "วันหยุดพนักงาน" },
      { "code": "04", "name": "วันหยุดพิเศษ" }
    ],
    "work_cycle_flag": [
      { "code": "20250408ABC123456789", "name": "WC001 - กะเช้า" },
      { "code": "20250408DEF987654321", "name": "WC002 - กะปกติ" }
    ],
    "time_adjust_flag": [
      { "code": "01", "name": "แก้เวลาเข้า" },
      { "code": "02", "name": "แก้เวลาออก" },
      { "code": "03", "name": "แก้เวลาเข้า-ออก" }
    ]
  }
}

Key Response Fields

Field	Type	Description
`work_date`	string	วันที่ทำงาน (YYYY-MM-DD)
`work_date_format`	string	วันที่ทำงาน (DD/MM/YYYY)
`day_status`	string	สถานะวัน
`holiday_count`	integer	จำนวนวันหยุด: `0` หรือ `1`
`holiday_flag_lv`	string	รหัสประเภทวันหยุด
`work_cycle`	string	ข้อมูลกะการทำงาน (รหัส + เวลา)
`work_cycle_code`	string	รหัสกะการทำงาน
`read_only_flag`	string	สถานะ read-only: `"Y"` (แก้ไขไม่ได้), `"N"` (แก้ไขได้)
`time`	array	รายการลงเวลาเข้า-ออก
`docs`	object	เอกสารที่เกี่ยวข้อง (Leave, Work_Cycle, Holiday, OT, Time_Adjust)
`ot_flag`	array	รายการ OT flags ที่ใช้ได้
`leave_flag`	array	รายการ Leave flags ที่ใช้ได้
`holiday_flag`	array	รายการ Holiday flags ทั้งหมด
`work_cycle_flag`	array	รายการกะทำงานทั้งหมด
`time_adjust_flag`	array	รายการประเภทการแก้เวลาทั้งหมด

leave_flag[].flag Values

Value	Description
`"D"`	ลาเป็นวัน
`"H"`	ลาเป็นชั่วโมง

read_only_flag

Value	Description
`"Y"`	ปิดแล้ว ไม่สามารถแก้ไขข้อมูลได้ (รอบเดือน/รอบ OT/รอบเวลาทำงาน ปิดแล้ว)
`"N"`	เปิดอยู่ สามารถแก้ไขข้อมูลได้

Error Response


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

HTTP Status	Description
`400`	พารามิเตอร์ไม่ถูกต้อง เช่น `work_date` ผิดรูปแบบ
`401`	API Key ไม่ถูกต้องหรือไม่ได้ส่ง
`404`	ไม่พบพนักงาน

Code Examples

cURL


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

JavaScript


const params = new URLSearchParams({
  path_action: 'daily_info',
  employee_code: 'EMP001',
  work_date: '2026-02-18',
  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.work_date} - ${p.day_status}`)
console.log(`กะ: ${p.work_cycle}`)
console.log(`แก้ไขได้: ${p.read_only_flag === 'N' ? 'ใช่' : 'ไม่ได้'}`)

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": "daily_info",
    "employee_code": "EMP001",
    "work_date": "2026-02-18",
    "language_code": "TH"
}
 
response = requests.get(url, headers=headers, params=params)
data = response.json()
p = data["payload"]
print(f"วันที่: {p['work_date']} - {p['day_status']}")
print(f"กะ: {p['work_cycle']}")
print(f"จำนวนลงเวลา: {len(p['time'])} รายการ")

PHP


<?php
$params = http_build_query([
    "path_action" => "daily_info",
    "employee_code" => "EMP001",
    "work_date" => "2026-02-18",
    "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['work_date']} - {$p['day_status']}\n";
echo "กะ: {$p['work_cycle']}\n";
echo "จำนวนลงเวลา: " . count($p['time']) . " รายการ\n";
?>

Notes

ระบบจะกรอง OT flags ตามสิทธิ์ของพนักงาน แสดงเฉพาะ OT ที่พนักงานใช้ได้
ระบบจะกรอง Leave flags ตามเพศของพนักงาน
ถ้าไม่มีข้อมูลกะ จะใช้ค่าเริ่มต้น: 08:00-17:00 พัก 12:00-13:00
ถ้าไม่มีรายการลงเวลา time จะเป็น array ว่าง []

read_only_flag = "Y" หมายถึงไม่สามารถแก้ไขข้อมูลวันนี้ได้ เนื่องจากรอบเดือน, รอบ OT, หรือรอบเวลาทำงานปิดแล้ว

Daily In Month - ดูตารางเวลาทั้งเดือน
A Daily In Month - ดูข้อมูลวันทำงานพร้อมผลการคำนวณ
Current Month - ดูรอบเดือนปัจจุบัน เพื่อหา work_date ที่ถูกต้อง