Get Employee Plans by Month
ดึงรายการแผนกะทั้งหมดของพนักงานในเดือนที่ระบุ พร้อมแสดงสถานะการกรอกข้อมูลและสถานะการส่งแผน
Endpoint
GET /api/v1/open-apis/salary/get-data-filter?path_action=get_employee_plans_by_monthRequest Parameters
| Parameter | Type | Required | Description | Example |
|---|---|---|---|---|
employee_code | string | Yes | รหัสพนักงาน | "EMP001" |
master_salary_month | string | Yes | งวดเดือน (YYYY-MM) | "2026-02" |
master_salary_month ต้องเป็นรูปแบบ YYYY-MM เท่านั้น
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",
"finish": "N",
"all_fill_set": "Y"
}
]
}Response 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 | สถานะปิดแผนของ Header: Y = ปิดแล้ว, N = ยังเปิดอยู่ |
finish | string | สถานะการส่งแผนของพนักงาน: Y = ส่งแล้ว, N = ยังไม่ส่ง |
all_fill_set | 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_employee_plans_by_month&employee_code=EMP001&master_salary_month=2026-02" \
-H "Ocp-Apim-Subscription-Key: YOUR_API_KEY"Notes
- ใช้สำหรับหน้า Dashboard ของพนักงานเพื่อดูว่ามีแผนกะไหนต้องจัดการบ้าง
- เมื่อ
all_fill_set=Yหมายถึงกรอกข้อมูลครบทุกวันแล้ว สามารถส่งแผนด้วย Submit Employee Plan ได้ - เมื่อ
finish=Yหมายถึงพนักงานส่งแผนแล้ว รอการอนุมัติ
Related APIs
- Submit Employee Plan - ส่งแผนกะเพื่ออนุมัติ (เมื่อ all_fill_set = Y)
- Get Employee Plan Detail - ดูหรือแก้ไขรายละเอียดแผน
- Get Month Plans - ดูรายการเดือนที่พนักงานมีแผน
Last updated on