Skip to Content
🚀 Welcome to Humansoft Open API Documentation

Get Employee Plans by Month

ดึงรายการแผนกะทั้งหมดของพนักงานในเดือนที่ระบุ พร้อมแสดงสถานะการกรอกข้อมูลและสถานะการส่งแผน

Endpoint

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

Request Parameters

ParameterTypeRequiredDescriptionExample
employee_codestringYesรหัสพนักงาน"EMP001"
master_salary_monthstringYesงวดเดือน (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

FieldTypeDescription
work_cycle_plan_idstringรหัสแผนกะ (plain text 20 ตัวอักษร)
master_salary_monthstringงวดเดือน (YYYY-MM)
work_date_fromstringวันที่เริ่มต้น (YYYY-MM-DD)
work_date_tostringวันที่สิ้นสุด (YYYY-MM-DD)
read_only_flagstringสถานะปิดแผนของ Header: Y = ปิดแล้ว, N = ยังเปิดอยู่
finishstringสถานะการส่งแผนของพนักงาน: Y = ส่งแล้ว, N = ยังไม่ส่ง
all_fill_setstringสถานะการกรอกข้อมูลครบถ้วน: Y = ครบ, N = ยังไม่ครบ

Error Response

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

Code Examples

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 หมายถึงพนักงานส่งแผนแล้ว รอการอนุมัติ

  • Submit Employee Plan - ส่งแผนกะเพื่ออนุมัติ (เมื่อ all_fill_set = Y)
  • Get Employee Plan Detail - ดูหรือแก้ไขรายละเอียดแผน
  • Get Month Plans - ดูรายการเดือนที่พนักงานมีแผน
Last updated on