Get Work Cycle Plans
ดูรายการแผนกะทั้งหมดที่มีอยู่ในระบบประจำเดือนที่ระบุ ใช้สำหรับดูภาพรวมว่ามีแผนกะอะไรบ้างในเดือนนั้น
Endpoint
GET /api/v1/open-apis/salary/get-data-filter?path_action=get_work_cycle_plansRequest Parameters
| Parameter | Type | Required | Description | Example |
|---|---|---|---|---|
master_salary_month | string | Yes | งวดเดือน (YYYY-MM) | "2026-02" |
language_code | string | No | ภาษา: TH หรือ EN (ค่าเริ่มต้น: TH) | "TH" |
master_salary_month ต้องเป็นรูปแบบ YYYY-MM เท่านั้น
Response Format
Success Response
{
"code": 200,
"message": "สำเร็จ",
"payload": [
{
"work_cycle_plan_id": "20260116C758D26F72FE",
"master_salary_month": "2026-02",
"month_name": "กุมภาพันธ์ 2569",
"work_date_from": "2026-02-01",
"work_date_to": "2026-02-28",
"read_only_flag": "N"
}
]
}Response Fields
| Field | Type | Description |
|---|---|---|
work_cycle_plan_id | string | รหัสแผนกะ (plain text 20 ตัวอักษร) |
master_salary_month | string | งวดเดือน (YYYY-MM) |
month_name | string | ชื่อเดือน (ตามภาษาที่เลือก) |
work_date_from | string | วันที่เริ่มต้นของแผน (YYYY-MM-DD) |
work_date_to | string | วันที่สิ้นสุดของแผน (YYYY-MM-DD) |
read_only_flag | string | สถานะปิดแผน: Y = ปิดแล้ว, N = ยังเปิดอยู่ |
Error Response
{
"code": 400,
"message": "Invalid month format",
"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_plans&master_salary_month=2026-02&language_code=TH" \
-H "Ocp-Apim-Subscription-Key: YOUR_API_KEY"Notes
- ใช้สำหรับหน้าจอจัดการแผนกะหลักของ HR เพื่อดูภาพรวมแผนทั้งหมดในเดือน
read_only_flag=Yหมายถึงแผนถูกปิดแล้ว ไม่สามารถแก้ไขได้
Related APIs
- Get Plan Detail - ดูรายละเอียดพนักงานในแผน
- Set Work Cycle Plan - สร้างแผนใหม่ในเดือนนี้
- Delete Plan - ลบแผนกะ
Last updated on