Get Calendar Month

ดึงปฏิทินการทำงานทั้งเดือนตามรอบเงินเดือน แสดงรายการพนักงานที่ทำงาน/ลา/หยุดในแต่ละวัน

Endpoint


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

Request Parameters

Parameter	Type	Required	Description	Example
`year_month`	string	Yes	รอบเงินเดือน (YYYY-MM)	`"2026-02"`
`type`	string	No	ประเภทการกรอง (ดูตารางด้านล่าง)	`"leave"`
`time_leave_flag`	string	No	รหัสประเภทการลา (ใช้เมื่อ type=leave)	`"01"`
`work_cycle_id`	string	No	รหัสกะการทำงาน (Base64, ใช้เมื่อ type=work_cycle)	-
`holiday_flag_lv`	string	No	รหัสประเภทวันหยุด (ใช้เมื่อ type=holiday)	`"01"`
`language_code`	string	No	ภาษา: `TH` หรือ `EN`	`"TH"`

Filter Types

Type	Description
`null`	ทั้งหมด — แสดงพนักงานทุกคนทุกวัน (default)
`"leave"`	ลางาน — แสดงเฉพาะพนักงานที่ลางาน
`"work_cycle"`	กะการทำงาน — แสดงพนักงานตามกะที่ระบุ
`"holiday"`	วันหยุด — แสดงเฉพาะพนักงานที่มีวันหยุด

Response Format

Success Response


{
  "code": 200,
  "message": "Get Calendar Month (2026-02) Accept",
  "month": {
    "master_salary_month": "2026-02",
    "salary_report_start_dt": "2026-01-26 00:00:00",
    "salary_report_end_dt": "2026-02-25 23:59:59",
    "day_in_month": "31",
    "read_only_flag": "N"
  },
  "payload": {
    "2026-02-01": [
      {
        "employee_code": "EMP001",
        "employee_name": "สมชาย",
        "employee_last_name": "ใจดี",
        "position_name": "โปรแกรมเมอร์",
        "department_name": "ฝ่ายพัฒนา",
        "organization": {
          "company": { "label": "บริษัท", "value": "บริษัท ตัวอย่าง จำกัด" },
          "branch": { "label": "สาขา", "value": "สำนักงานใหญ่" },
          "department": { "label": "แผนก", "value": "ฝ่ายพัฒนา" }
        },
        "work_date": "2026-02-01",
        "work_cycle_code": "SHIFT_A",
        "work_cycle_start_time": "08:00:00",
        "work_cycle_end_time": "17:00:00",
        "absence_flag_lv": "00",
        "absence_flag_name": "",
        "day_status": "วันทำงาน"
      }
    ]
  }
}

month Fields

Field	Type	Description
`master_salary_month`	string	รอบเดือน (YYYY-MM)
`salary_report_start_dt`	string	วันที่เริ่มต้นรอบ
`salary_report_end_dt`	string	วันที่สิ้นสุดรอบ
`day_in_month`	string	จำนวนวันในรอบ
`read_only_flag`	string	สถานะปิดรอบ: `"Y"` (ปิดแล้ว), `"N"` (เปิดอยู่)

payload Fields (per employee per day)

Field	Type	Description
`employee_code`	string	รหัสพนักงาน
`employee_name` / `employee_last_name`	string	ชื่อ-นามสกุล (ตามภาษาที่เลือก)
`position_name` / `department_name`	string	ตำแหน่ง / แผนก
`organization`	object	ข้อมูลองค์กร (company, branch, department)
`work_date`	string	วันที่ทำงาน (YYYY-MM-DD)
`work_cycle_code`	string	รหัสกะการทำงาน
`work_cycle_start_time` / `work_cycle_end_time`	string	เวลาเริ่ม-สิ้นสุดกะ (HH:mm:ss)
`absence_flag_lv`	string	รหัสประเภทการลา (`"00"` = ไม่ลา)
`absence_flag_name`	string	ชื่อประเภทการลา
`day_status`	string	สถานะวัน

Error Response


{
  "code": 404,
  "message": "Exception Invalid Request No Month Valid"
}

Code Examples

cURL


# ดูปฏิทินทั้งเดือน
curl -X GET "https://openapi.humansoft.co.th/api/v1/open-apis/salary/get-data-filter?path_action=get_calendar_month&year_month=2026-02&language_code=TH" \
  -H "Ocp-Apim-Subscription-Key: YOUR_API_KEY"
 
# ดูเฉพาะพนักงานที่ลางาน
curl -X GET "https://openapi.humansoft.co.th/api/v1/open-apis/salary/get-data-filter?path_action=get_calendar_month&year_month=2026-02&type=leave&language_code=TH" \
  -H "Ocp-Apim-Subscription-Key: YOUR_API_KEY"

JavaScript


const params = new URLSearchParams({
  path_action: 'get_calendar_month',
  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()
Object.entries(data.payload).forEach(([date, employees]) => {
  console.log(`${date}: ${employees.length} employees`)
})

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": "get_calendar_month", "year_month": "2026-02", "language_code": "TH"}
 
response = requests.get(url, headers=headers, params=params)
data = response.json()
for date, employees in data["payload"].items():
    print(f"{date}: {len(employees)} employees")

PHP


<?php
$params = http_build_query([
    "path_action" => "get_calendar_month",
    "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);
foreach ($data["payload"] as $date => $employees) {
    echo "{$date}: " . count($employees) . " employees\n";
}
?>

Notes

payload เป็น Object ที่มี key เป็นวันที่ (YYYY-MM-DD) และ value เป็น array ของพนักงาน
ใช้ type parameter เพื่อกรองข้อมูลและเพิ่มประสิทธิภาพ
แนะนำให้ cache ข้อมูลที่ได้เพราะการดึงข้อมูลอาจใช้เวลานาน

Get Calendar Month Filter - ดูปฏิทินตามช่วงวันที่ (ไม่จำกัดรอบเงินเดือน)

Get Calendar Month

Endpoint

Request Parameters

Filter Types

Response Format

Success Response

month Fields

payload Fields (per employee per day)

Error Response

Code Examples

cURL

JavaScript

Python

PHP

Notes

Related APIs