A Daily In Month

ดึงข้อมูลตารางเวลาทำงานของวันที่ระบุในรอบเดือน แสดงรายละเอียดวันทำงาน พร้อมเวลาเข้า-ออก, เอกสารต่างๆ, และผลการคำนวณ

Endpoint


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

สิทธิ์ที่ต้องการ: 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"`
`year_month`	string	Yes	รอบเงินเดือน (YYYY-MM)	`"2026-02"`
`language_code`	string	No	ภาษา: `TH` หรือ `EN` (ค่าเริ่มต้น: `TH`)	`"TH"`

API นี้ดึงข้อมูลวันทำงานเพียงวันเดียวในรอบเดือน ต่างจาก daily_in_month ที่ดึงทั้งเดือน

Response Format

Success Response


{
  "code": 200,
  "message": "Success",
  "payload": {
    "profile": {
      "employee_id": "20260121FC89F3BB9120",
      "employee_code": "EMP001",
      "employee_name": "สมชาย",
      "employee_last_name": "ใจดี",
      "employee_nickname": "ชาย",
      "employee_title_lv": "01",
      "employee_gender": "M",
      "salary": "35000.00",
      "calculate_ot": true,
      "round_ot_config": "Y",
      "round_worktime_config": "N"
    },
    "daily": [
      {
        "time_attendance_group_transac_id": "20260218ABC123456789",
        "work_date": "2026-02-18",
        "day_status": "วันทำงาน",
        "work_cycle_code": "WC002",
        "work_cycle_type_lv": "00",
        "work_cycle_start_time": "2026-02-18 09:00:00",
        "work_cycle_end_time": "2026-02-18 18:00:00",
        "work_cycle_hour": "09:00:00",
        "break_cycle_start_time": "2026-02-18 12:00:00",
        "break_cycle_end_time": "2026-02-18 13:00:00",
        "break_cycle_hour": "01:00:00",
        "holiday_flag_lv": "00",
        "work_time_count": "2",
        "work_sum_time": "08:05:00",
        "work_total_time": "08:05:00",
        "work_total_in_cycle": "08:00:00",
        "late_sum_time": "00:05:00",
        "late_total": "0.00",
        "early_sum_time": "00:00:00",
        "early_total": "0.00",
        "absence_day": "0.0000",
        "absence_total": "0.00",
        "time": [
          {
            "time_attendance_transac_id": "20260218IN123456789",
            "attendance_datetime": "2026-02-18 09:05:00",
            "work_type_lv": "01",
            "time_attendance_type_lv": "Manual"
          },
          {
            "time_attendance_transac_id": "20260218OUT987654321",
            "attendance_datetime": "2026-02-18 18:10:00",
            "work_type_lv": "02",
            "time_attendance_type_lv": "Manual"
          }
        ],
        "time_leave": [],
        "work_cycle_change": [],
        "holiday_change": [],
        "time_adjust": [],
        "ot_work": [],
        "custom_attendance": {
          "is_absent_full_day": false,
          "is_absent_half_day": false,
          "is_morning": false,
          "is_late": true,
          "is_lunch_over": false,
          "is_lunch_under": false,
          "is_early_out": false,
          "is_after_work": false,
          "is_work_error": false
        },
        "custom_day_type": "work_day",
        "custom_leave": {
          "has_leave": false,
          "doc_status": null,
          "show_absent_until_approved": false
        },
        "custom_ot": {
          "has_ot": false,
          "doc_status": null,
          "requested_hours": 0.0,
          "actual_ot_hours": 0.0,
          "approved_hours": 0.0
        },
        "custom_color": "green",
        "custom_status": "วันทำงาน",
        "custom_display_statuses": ["วันทำงาน", "มาสาย"]
      }
    ]
  }
}

Key Response Fields - profile

Field	Type	Description
`employee_code`	string	รหัสพนักงาน
`employee_name`	string	ชื่อพนักงาน
`salary`	string	เงินเดือน (decimal string)
`calculate_ot`	boolean	คำนวณ OT หรือไม่
`round_ot_config`	string	Config รอบ OT: `"Y"` หรือ `"N"`
`round_worktime_config`	string	Config รอบเวลาทำงาน: `"Y"` หรือ `"N"`

Key Response Fields - daily[]

Field	Type	Description
`work_date`	string	วันที่ (YYYY-MM-DD)
`day_status`	string	สถานะวัน
`work_cycle_code`	string	รหัสกะ
`work_cycle_type_lv`	string	ประเภทกะ: `"00"` (ปกติ), `"01"` (กำหนดชั่วโมง), `"02"` (ข้ามวัน), `"04"` (กะควบ)
`work_sum_time`	string	เวลาทำงานรวม (HH:mm:ss)
`work_total_in_cycle`	string	ชั่วโมงที่คำนวณในรอบกะ
`late_sum_time`	string	เวลาสาย (HH:mm:ss)
`early_sum_time`	string	เวลากลับก่อน (HH:mm:ss)
`time`	array	รายการลงเวลาเข้า-ออก
`time_leave`	array	รายการเอกสารลา
`work_cycle_change`	array	รายการเอกสารเปลี่ยนกะ
`holiday_change`	array	รายการเอกสารเปลี่ยนวันหยุด
`time_adjust`	array	รายการเอกสารแก้เวลา
`ot_work`	array	รายการเอกสาร OT
`custom_attendance`	object	สรุปสถานะการเช็คอิน/เช็คเอาท์รายวัน — ดู Custom Attendance
`custom_day_type`	string	ประเภทวัน: `work_day`, `public_holiday`, `employee_holiday`, `special_holiday`
`custom_leave`	object	สรุปข้อมูลการลา — ดู Custom Leave
`custom_ot`	object	สรุปข้อมูลชั่วโมงและสถานะ OT — ดู Custom OT
`custom_color`	string	สีปฏิทินตามลำดับความสำคัญ: `red`, `yellow`, `blue`, `grey`, `green`
`custom_status`	string	ข้อความแสดงสถานะรายวันสำหรับ UI
`custom_display_statuses`	array	รายการข้อความสถานะและประเภทเอกสารของวันนั้น

Custom Attendance

daily[].custom_attendance — สรุปสถานะเวลาทำงาน:

Field	Type	Description
`is_absent_full_day`	boolean	ขาดงานเต็มวัน (รวมกรณีลาที่ยังไม่ได้รับอนุมัติ)
`is_absent_half_day`	boolean	ขาดงานครึ่งวัน
`is_morning`	boolean	มาเช้า
`is_late`	boolean	มาสาย
`is_lunch_over`	boolean	พักเกินเวลา
`is_lunch_under`	boolean	พักขาดเวลา
`is_early_out`	boolean	กลับก่อนเวลา
`is_after_work`	boolean	กลับหลังเวลา
`is_work_error`	boolean	บันทึกเวลาผิดพลาด

Custom Leave

daily[].custom_leave — สรุปเอกสารการลา:

Field	Type	Description
`has_leave`	boolean	มีเอกสารขอลาในวันนั้น
`doc_status`	string	สถานะใบลา: `approved`, `rejected`, `pending`, `recheck` หรือ `null`
`show_absent_until_approved`	boolean	แสดงเป็นสถานะขาดงานหากใบลายังไม่ผ่านการอนุมัติ

Custom OT

daily[].custom_ot — สรุปข้อมูล OT:

Field	Type	Description
`has_ot`	boolean	มีเอกสารขอทำ OT ในวันนั้น
`doc_status`	string	สถานะเอกสาร OT: `approved`, `rejected`, `pending`, `recheck` หรือ `null`
`requested_hours`	number	จำนวนชั่วโมงขอ OT จากใบคำขอ
`actual_ot_hours`	number	จำนวนชั่วโมงปฏิบัติงาน OT จริง
`approved_hours`	number	จำนวนชั่วโมง OT ที่อนุมัติเข้ารอบคำนวณเงินเดือน

day_status Values

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

Error Response


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

HTTP Status	Description
`400`	พารามิเตอร์ไม่ถูกต้อง เช่น `work_date` หรือ `year_month` ผิดรูปแบบ
`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=a_daily_in_month&employee_code=EMP001&work_date=2026-02-18&year_month=2026-02&language_code=TH" \
  -H "Ocp-Apim-Subscription-Key: YOUR_API_KEY"

JavaScript


const params = new URLSearchParams({
  path_action: 'a_daily_in_month',
  employee_code: 'EMP001',
  work_date: '2026-02-18',
  year_month: '2026-02',
  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 daily = data.payload.daily[0]
console.log(`${daily.work_date} - ${daily.day_status} - เวลาทำงาน: ${daily.work_sum_time}`)

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": "a_daily_in_month",
    "employee_code": "EMP001",
    "work_date": "2026-02-18",
    "year_month": "2026-02",
    "language_code": "TH"
}
 
response = requests.get(url, headers=headers, params=params)
data = response.json()
daily = data["payload"]["daily"][0]
print(f"{daily['work_date']} - {daily['day_status']} - เวลาทำงาน: {daily['work_sum_time']}")

PHP


<?php
$params = http_build_query([
    "path_action" => "a_daily_in_month",
    "employee_code" => "EMP001",
    "work_date" => "2026-02-18",
    "year_month" => "2026-02",
    "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);
$daily = $data["payload"]["daily"][0];
echo "{$daily['work_date']} - {$daily['day_status']} - เวลาทำงาน: {$daily['work_sum_time']}\n";
?>

Notes

Response จะมี daily เป็น array ที่มี 1 element เท่านั้น (ข้อมูลวันที่ระบุ)
ถ้ากะข้ามวัน (work_cycle_type_lv = '02' หรือ '03') ระบบจะจัดการเอกสารลาให้ถูกต้องโดยอัตโนมัติ
ถ้ากะควบ (work_cycle_type_lv = '04') จะมีข้อมูล merge_cycle เพิ่มเติม

Daily In Month - ดูตารางเวลาทั้งเดือน
Daily Info - ดูรายละเอียดวันทำงาน พร้อม options สำหรับแก้ไข
Current Month - ดูรอบเดือนปัจจุบัน เพื่อหา year_month
Calculate Month - คำนวณเวลาทำงาน เพื่อให้ได้ผลการคำนวณ