Daily In Month Calendar

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

Endpoint


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

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

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": [],
      "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": ["วันทำงาน", "สาย"]
    },
    {
      "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": [],
      "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

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

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

custom_leave — สรุปเอกสารการลา:

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

Custom OT

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 ที่อนุมัติเข้ารอบคำนวณเงินเดือน

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