Get Employee Plan Detail

ดึงรายละเอียดแผนกะของพนักงานรายบุคคล พร้อมรายการกะงานและวันหยุดประจำวัน รวมถึงเวลาเริ่ม-สิ้นสุดงานและชั่วโมงทำงาน

Endpoint


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

Request Parameters

Parameter	Type	Required	Description	Example
`employee_code`	string	Yes	รหัสพนักงาน	`"EMP001"`
`work_cycle_plan_id`	string	Yes	รหัสแผนกะ (Base64 encoded)	`"MjAyNjAxMTZDNzU4RDI2RjcyRkU"`

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",
    "sum_holiday_work_total_cycle": 16.5,
    "employee_lists": {
      "202503219741427917A0": {
        "2026-02-01": {
          "work_cycle_id": "WC001",
          "work_cycle_code": "DAY",
          "work_start_time": "08:00:00",
          "work_end_time": "17:00:00",
          "break1_start_time": "12:00:00",
          "break1_end_time": "13:00:00",
          "work_hour": "8.00",
          "holiday_flag_lv": "01",
          "holiday_name": "วันทำงาน",
          "work_total_cycle_limit": "8.00"
        }
      }
    }
  }
}

Plan Info 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)
`sum_holiday_work_total_cycle`	number	รวมชั่วโมงทำงานในวันหยุด

Employee Daily Plan Fields (`employee_lists`)

Field	Type	Description
`work_cycle_id`	string	รหัสกะงาน
`work_cycle_code`	string	ชื่อเรียกกะงาน
`work_start_time`	string	เวลาเริ่มงาน (HH:mm:ss)
`work_end_time`	string	เวลาเลิกงาน (HH:mm:ss)
`break1_start_time`	string	เวลาเริ่มพัก (HH:mm:ss)
`break1_end_time`	string	เวลาสิ้นสุดพัก (HH:mm:ss)
`work_hour`	string	ชั่วโมงทำงาน
`holiday_flag_lv`	string	รหัสประเภทวัน
`holiday_name`	string	ชื่อประเภทวัน
`work_total_cycle_limit`	string	ชั่วโมงทำงานสูงสุดของกะ

โครงสร้าง employee_lists เป็น Nested Object โดย Key ชั้นแรกเป็น Employee ID และ Key ชั้นที่สองเป็นวันที่ (YYYY-MM-DD)

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_employee_plan_detail&employee_code=EMP001&work_cycle_plan_id=MjAyNjAxMTZDNzU4RDI2RjcyRkU" \
  -H "Ocp-Apim-Subscription-Key: YOUR_API_KEY"

JavaScript


const params = new URLSearchParams({
  path_action: 'get_employee_plan_detail',
  employee_code: 'EMP001',
  work_cycle_plan_id: 'MjAyNjAxMTZDNzU4RDI2RjcyRkU'
})
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(`${date}: ${info.work_cycle_code} (${info.work_start_time} - ${info.work_end_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": "get_employee_plan_detail",
    "employee_code": "EMP001",
    "work_cycle_plan_id": "MjAyNjAxMTZDNzU4RDI2RjcyRkU"
}
 
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"{date}: {info['work_cycle_code']} ({info['work_start_time']} - {info['work_end_time']})")

PHP


<?php
$params = http_build_query([
    "path_action" => "get_employee_plan_detail",
    "employee_code" => "EMP001",
    "work_cycle_plan_id" => "MjAyNjAxMTZDNzU4RDI2RjcyRkU"
]);
$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 "{$date}: {$info['work_cycle_code']} ({$info['work_start_time']} - {$info['work_end_time']})\n";
    }
}
?>

Notes

ใช้สำหรับดูรายละเอียดกะงานรายวันของพนักงานก่อนทำการแก้ไขด้วย Save Employee Plan
ข้อมูลเวลาเริ่ม-สิ้นสุดงานจะแสดงตามกะงานที่กำหนดไว้

Save Employee Plan - แก้ไขข้อมูลกะงานรายวัน
Get Employee Plans by Month - ดูว่าพนักงานมีแผนอะไรบ้างในเดือนนี้
Submit Employee Plan - ส่งแผนกะเพื่ออนุมัติ