Get Month Plans
ดึงรายการเดือนที่พนักงานมีแผนกะอยู่ในระบบ ใช้สำหรับสร้างรายการเดือนให้เลือกก่อนเข้าไปดูรายละเอียดแผนกะรายเดือน
Endpoint
GET /api/v1/open-apis/salary/get-data-filter?path_action=get_month_plansRequest Parameters
| Parameter | Type | Required | Description | Example |
|---|---|---|---|---|
employee_code | string | Yes | รหัสพนักงาน | "EMP001" |
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",
"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": 404,
"message": "Employee 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_month_plans&employee_code=EMP001&language_code=TH" \
-H "Ocp-Apim-Subscription-Key: YOUR_API_KEY"Notes
- ใช้สำหรับสร้าง Dropdown เลือกเดือนในหน้าจอดูตารางเวลาทำงานของพนักงาน
- หลังจากเลือกเดือนแล้ว ให้เรียก Get Employee Plans by Month เพื่อดูรายละเอียดแผนในเดือนนั้น
Related APIs
- Get Employee Plans by Month - ดูรายละเอียดแผนในเดือนที่เลือก
- Get Employee Plan Detail - ดูรายละเอียดแผนกะรายวันของพนักงาน
Last updated on