Daily In Month Calendar

ดึงข้อมูลปฏิทินรายวันในช่วงวันที่ระบุ แสดงตารางเวลาทำงาน พร้อมกรองตามประเภท (วันทำงาน, วันหยุด, ลา, OT, แก้เวลา, ขาดงาน)

Endpoint


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

Request Parameters

Parameter	Type	Required	Description	Example
`employee_code`	string	Yes	รหัสพนักงาน	`"EMP001"`
`start_date`	string	Yes	วันที่เริ่มต้น (YYYY-MM-DD)	`"2026-02-01"`
`end_date`	string	Yes	วันที่สิ้นสุด (YYYY-MM-DD)	`"2026-02-28"`
`time_flag`	string	No	กรองตามประเภท (ดูตารางด้านล่าง)	`"00"`
`language_code`	string	No	ภาษา: `TH` หรือ `EN` (ค่าเริ่มต้น: `TH`)	`"TH"`

time_flag Values

Value	Description
`"00"`	กรองเฉพาะวันทำงาน
`"01"`	กรองเฉพาะวันหยุดนักขัตฤกษ์
`"03"`	กรองเฉพาะวันหยุดพนักงาน
`"99"`	กรองเฉพาะวันที่มีเอกสารลา
`"98"`	กรองเฉพาะวันที่มีเอกสารแก้เวลา
`"97"`	กรองเฉพาะวันที่มีเอกสาร OT
`"96"`	กรองเฉพาะวันที่ขาดงาน
ไม่ระบุ	แสดงทุกวัน (ไม่กรอง)

start_date ต้องไม่มากกว่า end_date แนะนำให้จำกัดช่วงวันที่ไม่เกิน 31 วัน

Response Format

Success Response


{
  "code": 200,
  "message": "Success",
  "payload": [
    {
      "time_attendance_group_transac_id": "20260201ABC123456789",
      "work_date": "2026-02-01",
      "day_status": "วันหยุดพนักงาน",
      "work_cycle_code": "WC002",
      "work_cycle_start_time": "2026-02-01 09:00:00",
      "work_cycle_end_time": "2026-02-01 18:00:00",
      "holiday_flag_lv": "03",
      "holiday_count": "1",
      "work_time_count": "0",
      "time": [],
      "time_lost": [],
      "time_leave": [],
      "work_cycle_change": [],
      "holiday_change": [],
      "time_adjust": [],
      "ot_work": []
    },
    {
      "time_attendance_group_transac_id": "20260218DEF987654321",
      "work_date": "2026-02-18",
      "day_status": "วันทำงาน",
      "work_cycle_code": "WC002",
      "work_cycle_start_time": "2026-02-18 09:00:00",
      "work_cycle_end_time": "2026-02-18 18:00:00",
      "holiday_flag_lv": "00",
      "holiday_count": "0",
      "work_time_count": "2",
      "late_sum_time": "00:05:00",
      "time": [
        {
          "time_attendance_transac_id": "20260218IN123",
          "attendance_datetime": "2026-02-18 09:05:00",
          "work_type_lv": "01",
          "time_attendance_type_lv": "Manual"
        },
        {
          "time_attendance_transac_id": "20260218OUT456",
          "attendance_datetime": "2026-02-18 18:10:00",
          "work_type_lv": "02",
          "time_attendance_type_lv": "Manual"
        }
      ],
      "time_lost": [],
      "time_leave": [],
      "work_cycle_change": [],
      "holiday_change": [],
      "time_adjust": [],
      "ot_work": []
    }
  ]
}

Key Response Fields

Response เป็น array ของวันทำงาน แต่ละ element มีฟิลด์ดังนี้:

Field	Type	Description
`time_attendance_group_transac_id`	string	รหัส record รายวัน
`work_date`	string	วันที่ (YYYY-MM-DD)
`day_status`	string	สถานะวัน
`work_cycle_code`	string	รหัสกะ
`holiday_flag_lv`	string	รหัสประเภทวันหยุด
`holiday_count`	string	จำนวนวันหยุด: `"0"` หรือ `"1"`
`work_time_count`	string	จำนวนรายการลงเวลา
`late_sum_time`	string	เวลาสาย (HH:mm:ss)
`time`	array	รายการลงเวลาเข้า-ออก
`time_lost`	array	รายการขาดงาน
`time_leave`	array	รายการเอกสารลา
`work_cycle_change`	array	รายการเอกสารเปลี่ยนกะ
`holiday_change`	array	รายการเอกสารเปลี่ยนวันหยุด
`time_adjust`	array	รายการเอกสารแก้เวลา
`ot_work`	array	รายการเอกสาร OT

Error Response


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

HTTP Status	Description
`400`	พารามิเตอร์ไม่ถูกต้อง เช่น วันที่ผิดรูปแบบ หรือ start_date > end_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_in_month_calendar&employee_code=EMP001&start_date=2026-02-01&end_date=2026-02-28&language_code=TH" \
  -H "Ocp-Apim-Subscription-Key: YOUR_API_KEY"

JavaScript


const params = new URLSearchParams({
  path_action: 'daily_in_month_calendar',
  employee_code: 'EMP001',
  start_date: '2026-02-01',
  end_date: '2026-02-28',
  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(d => {
  console.log(`${d.work_date} - ${d.day_status} - ลงเวลา: ${d.work_time_count} รายการ`)
})

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_in_month_calendar",
    "employee_code": "EMP001",
    "start_date": "2026-02-01",
    "end_date": "2026-02-28",
    "language_code": "TH"
}
 
response = requests.get(url, headers=headers, params=params)
data = response.json()
for d in data["payload"]:
    print(f"{d['work_date']} - {d['day_status']} - ลงเวลา: {d['work_time_count']} รายการ")

PHP


<?php
$params = http_build_query([
    "path_action" => "daily_in_month_calendar",
    "employee_code" => "EMP001",
    "start_date" => "2026-02-01",
    "end_date" => "2026-02-28",
    "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 $d) {
    echo "{$d['work_date']} - {$d['day_status']} - ลงเวลา: {$d['work_time_count']} รายการ\n";
}
?>

Notes

ใช้ time_flag เพื่อกรองข้อมูลและลดปริมาณ response
ถ้าเอกสารลาครอบคลุมหลายวัน ระบบจะแสดงในแต่ละวันที่เกี่ยวข้อง
ถ้ากะควบ (work_cycle_type_lv = '04') จะมีข้อมูล merge_cycle เพิ่มเติม
แนะนำให้จำกัดช่วงวันที่ไม่เกิน 31 วัน เพื่อประสิทธิภาพ

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