Get Work Cycle Plan Detail

ดูรายละเอียดแผนกะ แสดงข้อมูล Header และรายการพนักงานทั้งหมดในแผนพร้อมรายละเอียดกะงานรายวัน

Endpoint


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

Request Parameters

Parameter	Type	Required	Description	Example
`work_cycle_plan_id`	string	Yes	รหัสแผนกะ (Base64 encoded)	`"MjAyNjAxMTZDNzU4RDI2RjcyRkU"`
`language_code`	string	No	ภาษา: `TH` หรือ `EN` (ค่าเริ่มต้น: `TH`)	`"TH"`

Response Format

Success Response


{
  "code": 200,
  "message": "สำเร็จ",
  "payload": {
    "work_cycle_plan_id": "20260116C758D26F72FE",
    "master_salary_month": "2026-02",
    "work_date_from": "2026-02-01",
    "work_date_to": "2026-02-28",
    "read_only_flag": "N",
    "employee_lists": {
      "202503219741427917A0": {
        "2026-02-01": {
          "work_cycle_id": "WC001",
          "work_cycle_code": "DAY",
          "holiday_flag_lv": "01",
          "holiday_name": "วันทำงาน",
          "employee_code": "EMP001",
          "employee_name": "สมชาย",
          "employee_last_name": "ใจดี",
          "employee_nickname": "ชาย",
          "department_name": "IT",
          "position_name": "Developer"
        }
      }
    }
  }
}

Plan Header Fields

Field	Type	Description
`work_cycle_plan_id`	string	รหัสแผนกะ (plain text 20 ตัวอักษร)
`master_salary_month`	string	งวดเดือน (YYYY-MM)
`work_date_from`	string	วันที่เริ่มต้น (YYYY-MM-DD)
`work_date_to`	string	วันที่สิ้นสุด (YYYY-MM-DD)
`read_only_flag`	string	สถานะปิดแผน: `Y` = ปิดแล้ว, `N` = ยังเปิดอยู่

Employee List Fields (`employee_lists`)

Field	Type	Description
`employee_code`	string	รหัสพนักงาน
`employee_name`	string	ชื่อจริง
`employee_last_name`	string	นามสกุล
`employee_nickname`	string	ชื่อเล่น
`department_name`	string	แผนกสังกัด
`position_name`	string	ตำแหน่ง
`work_cycle_code`	string	รหัสกะงานในวันนั้น
`holiday_flag_lv`	string	รหัสประเภทวัน
`holiday_name`	string	ชื่อประเภทวัน

ข้อมูล employee_lists เป็น Nested Object โดย Key ชั้นแรกเป็น Employee ID และ Key ชั้นที่สองเป็นวันที่ (YYYY-MM-DD) เหมาะสำหรับนำไปแสดงผลในตาราง Grid view

Error Response


{
  "code": 404,
  "message": "Plan not found",
  "payload": []
}

Code Examples

cURL


curl -X GET "https://openapi.humansoft.co.th/api/v1/open-apis/salary/get-data-filter?path_action=get_work_cycle_plan_detail&work_cycle_plan_id=MjAyNjAxMTZDNzU4RDI2RjcyRkU&language_code=TH" \
  -H "Ocp-Apim-Subscription-Key: YOUR_API_KEY"

JavaScript


const params = new URLSearchParams({
  path_action: 'get_work_cycle_plan_detail',
  work_cycle_plan_id: 'MjAyNjAxMTZDNzU4RDI2RjcyRkU',
  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 plan = data.payload
console.log(`Plan: ${plan.work_cycle_plan_id} (${plan.work_date_from} - ${plan.work_date_to})`)
for (const [empId, dates] of Object.entries(plan.employee_lists)) {
  for (const [date, info] of Object.entries(dates)) {
    console.log(`${info.employee_code} - ${date}: ${info.work_cycle_code}`)
  }
}

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_work_cycle_plan_detail",
    "work_cycle_plan_id": "MjAyNjAxMTZDNzU4RDI2RjcyRkU",
    "language_code": "TH"
}
 
response = requests.get(url, headers=headers, params=params)
data = response.json()
plan = data["payload"]
print(f"Plan: {plan['work_cycle_plan_id']} ({plan['work_date_from']} - {plan['work_date_to']})")
for emp_id, dates in plan["employee_lists"].items():
    for date, info in dates.items():
        print(f"{info['employee_code']} - {date}: {info['work_cycle_code']}")

PHP


<?php
$params = http_build_query([
    "path_action" => "get_work_cycle_plan_detail",
    "work_cycle_plan_id" => "MjAyNjAxMTZDNzU4RDI2RjcyRkU",
    "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);
$plan = $data["payload"];
echo "Plan: {$plan['work_cycle_plan_id']} ({$plan['work_date_from']} - {$plan['work_date_to']})\n";
foreach ($plan["employee_lists"] as $empId => $dates) {
    foreach ($dates as $date => $info) {
        echo "{$info['employee_code']} - {$date}: {$info['work_cycle_code']}\n";
    }
}
?>

Notes

ข้อมูล employee_lists จัดกลุ่มตามพนักงานและวันที่ เหมาะสำหรับนำไปแสดงผลในตาราง Time Plan
ใช้ work_cycle_plan_id จาก Get Work Cycle Plans เป็น Base64 encoded ในการเรียกใช้

Get Work Cycle Plans - ดูรายการแผนทั้งหมดในเดือน
Set Work Cycle Plan - แก้ไขข้อมูล Header หรือเพิ่ม/ลบคนในแผน
Save Employee Plan - แก้ไขรายละเอียดกะงานรายวัน