Daily Info

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

Endpoint


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

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

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"`

Validation Rules

Rule	Description
`employee_code`	ต้องมีอยู่ในระบบ ถ้าไม่พบจะ return error 404
`work_date`	ต้องเป็นรูปแบบ YYYY-MM-DD และต้องเป็นวันที่ถูกต้อง
`language_code`	รองรับเฉพาะ `TH` หรือ `EN` (case-insensitive)

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": "แก้เวลาเข้า-ออก" }
    ],
    "summary": {
      "morning": { "status": "ไม่มาเช้า", "sum_time": "00:00:00", "total": 0 },
      "late": { "status": "มาสาย", "sum_time": "00:15:00", "total": 50 },
      "lunch_over": { "status": "ไม่พักเกิน", "sum_time": "00:00:00", "total": 0 },
      "lunch_under": { "status": "ไม่พักไว", "sum_time": "00:00:00", "total": 0 },
      "early": { "status": "กลับก่อน", "sum_time": "00:30:00", "total": 100 },
      "after": { "status": "ไม่กลับช้า", "sum_time": "00:00:00", "total": 0 },
      "lost": { "status": "ขาดงาน", "day": 0, "sum_time": "00:00:00", "total": 0 },
      "ot_1_0": { "name": "OT 1.0", "rate": "1.0", "work_count": 0, "sum_time": "00:00:00", "total": 0 },
      "ot_1_5": { "name": "OT 1.5", "rate": "1.5", "work_count": 0, "sum_time": "00:00:00", "total": 0 },
      "work_total_in_cycle": "09:00:00",
      "work_sum_time": "09:00:00",
      "work_total_time": "09:00:00"
    }
  }
}

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	รหัสกะการทำงาน
`work_cycle_time`	string	เวลากะ (HH:mm - HH:mm - HH:mm - HH:mm)
`work_cycle_start_time`	string	เวลาเริ่มงาน (YYYY-MM-DD HH:mm:ss)
`work_cycle_end_time`	string	เวลาเลิกงาน (YYYY-MM-DD HH:mm:ss)
`break_cycle_start_time`	string	เวลาเริ่มพัก (YYYY-MM-DD HH:mm:ss)
`break_cycle_end_time`	string	เวลาสิ้นสุดพัก (YYYY-MM-DD HH:mm:ss)
`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	รายการประเภทการแก้เวลาทั้งหมด
`summary`	object	สรุปเวลาทำงานรายวัน (มาสาย, กลับก่อน, ขาดงาน, OT)

`time[]` Fields

Field	Type	Description
`time_attendance_transac_id`	string	รหัสรายการลงเวลา
`attendance_datetime`	string	วันเวลาที่ลงเวลา (YYYY-MM-DD HH:mm:ss)
`work_type_lv`	string	ประเภทการลงเวลา: `"01"` (เข้างาน), `"02"` (ออกงาน)
`time_attendance_type_lv`	string	วิธีการลงเวลา: `"Manual"`, `"Fingerprint"`, `"Face"`, `"Card"`, `"GPS"`

`docs` Fields

แต่ละเอกสาร (Leave, Work_Cycle, Holiday, OT, Time_Adjust) มี structure ดังนี้:

Field	Type	Description
`doc_id`	string	รหัสเอกสาร
`flag_name`	string	ชื่อประเภท เช่น `"ลาป่วย"`, `"OT 1.5 เท่า"`
`flag_value`	string	สถานะอนุมัติ: `"รออนุมัติ"`, `"อนุมัติ"`, `"ไม่อนุมัติ"`

`summary` Fields

สรุปเวลาทำงานรายวัน — ชื่อ labels (status, name) สามารถปรับแต่งได้จากการตั้งค่าเวลาการทำงานของบริษัท

Work Summary (morning, late, lunch_over, lunch_under, early, after)

Field	Type	Description
`status`	string	สถานะ ถ้าไม่เข้าเงื่อนไขจะขึ้นต้นด้วย “ไม่” (TH) หรือ “Not ” (EN)
`sum_time`	string	รวมเวลา (HH:mm:ss)
`total`	number	ยอดรวมเงิน (บาท)

Lost Summary (ขาดงาน)

Field	Type	Description
`status`	string	สถานะขาดงาน
`day`	number	จำนวนวันขาด
`sum_time`	string	รวมเวลาขาด (HH:mm:ss)
`total`	number	ยอดรวมเงินหัก (บาท)

OT Summary (`ot_1_0` ~ `ot_7_0`)

Field	Type	Description
`name`	string	ชื่อ OT เช่น `"OT 1.0"`, `"OT 1.5"`
`rate`	string	อัตรา OT: `"1.0"` ~ `"7.0"`
`work_count`	integer	จำนวนครั้งที่ทำ OT
`sum_time`	string	รวมเวลา OT (HH:mm:ss)
`total`	number	ยอดรวมเงิน OT (บาท)

Work Total

Field	Type	Description
`work_total_in_cycle`	string	เวลาทำงานรวมในรอบกะ (HH:mm:ss)
`work_sum_time`	string	เวลาทำงานรวมที่คำนวณได้ (HH:mm:ss)
`work_total_time`	string	เวลาทำงานรวมทั้งหมด (HH:mm:ss)

Option Values

day_status

Value	Description
`"วันทำงาน"`	วันทำงานปกติ
`"วันหยุดพนักงาน"`	วันหยุดของพนักงานคนนี้
`"วันหยุดนักขัตฤกษ์"`	วันหยุดนักขัตฤกษ์
`"ยังไม่ได้เริ่มงาน/ลาออกไปแล้ว"`	พนักงานยังไม่เริ่มงานหรือลาออกไปแล้ว

holiday_flag_lv

Code	Name
`"00"`	ไม่หยุด (วันทำงาน)
`"01"`	วันหยุดนักขัตฤกษ์
`"03"`	วันหยุดพนักงาน
`"04"`	วันหยุดพิเศษ

work_type_lv

Code	Description
`"01"`	เข้างาน (IN)
`"02"`	ออกงาน (OUT)

time_attendance_type_lv

Value	Description
`"Manual"`	ลงเวลาด้วยตนเอง
`"Fingerprint"`	ลงเวลาด้วยลายนิ้วมือ
`"Face"`	ลงเวลาด้วยใบหน้า
`"Card"`	ลงเวลาด้วยบัตร
`"GPS"`	ลงเวลาด้วย GPS

read_only_flag

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

OT Flag Codes

Code	Name	Multiplier
`"01"`	OT 1.0 เท่า	1.0x
`"02"`	OT 1.5 เท่า	1.5x
`"03"`	OT 2.0 เท่า	2.0x
`"04"`	OT 3.0 เท่า	3.0x
`"05"`	OT 4.0 เท่า	4.0x
`"06"`	OT 5.0 เท่า	5.0x
`"07"`	OT 6.0 เท่า	6.0x
`"08"`	OT 7.0 เท่า	7.0x

Time Adjust Flag Codes

Code	Name
`"01"`	แก้เวลาเข้า
`"02"`	แก้เวลาออก
`"03"`	แก้เวลาเข้า-ออก

leave_flag[].flag Values

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

Approve Flag (ใน docs)

Value	Description
`"รออนุมัติ"`	เอกสารรออนุมัติ
`"อนุมัติ"`	เอกสารอนุมัติแล้ว
`"ไม่อนุมัติ"`	เอกสารไม่อนุมัติ

Error Responses

Employee Not Found (HTTP 404)


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

Invalid Work Date Format (HTTP 400)


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

Missing Required Parameters (HTTP 400)


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

Invalid Language Code (HTTP 400)


{
  "code": 400,
  "message": "ไม่สำเร็จ",
  "errors": {
    "language_code": "Invalid language code. Supported: TH, EN"
  }
}

HTTP Status	Description
`400`	พารามิเตอร์ไม่ถูกต้อง เช่น `work_date` ผิดรูปแบบ, ขาด required parameters, หรือ `language_code` ไม่รองรับ
`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.summary.late.sum_time} (${p.summary.late.total} บาท)`)
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'])} รายการ")
print(f"มาสาย: {p['summary']['late']['sum_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";
echo "มาสาย: {$p['summary']['late']['sum_time']}\n";
?>

Notes

ระบบจะกรอง OT flags ตามสิทธิ์ของพนักงาน แสดงเฉพาะ OT ที่พนักงานใช้ได้
ระบบจะกรอง Leave flags ตามเพศของพนักงาน
ถ้าไม่มีข้อมูลกะ จะใช้ค่าเริ่มต้น: 08:00-17:00 พัก 12:00-13:00
ถ้าไม่มีรายการลงเวลา time จะเป็น array ว่าง []
ถ้าไม่มีเอกสาร docs จะเป็น object ที่มี array ว่างทุก key
กรณีกะข้ามวัน (เช่น กะดึก 22:00-06:00) ระบบจะคำนวณเอกสารลาที่เกี่ยวข้องให้ครอบคลุมทั้งช่วงกะ
ชื่อ labels ใน summary (เช่น “มาสาย”, “กลับก่อน”) สามารถปรับแต่งได้จากการตั้งค่าบริษัท

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

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