Skip to Content
🚀 Welcome to Humansoft Open API Documentation

Get Work Cycle Plans

ดูรายการแผนกะทั้งหมดที่มีอยู่ในระบบประจำเดือนที่ระบุ ใช้สำหรับดูภาพรวมว่ามีแผนกะอะไรบ้างในเดือนนั้น

Endpoint

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

Request Parameters

ParameterTypeRequiredDescriptionExample
master_salary_monthstringYesงวดเดือน (YYYY-MM)"2026-02"
language_codestringNoภาษา: 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

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

Error Response

{ "code": 400, "message": "Invalid month format", "payload": [] }

Code Examples

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 หมายถึงแผนถูกปิดแล้ว ไม่สามารถแก้ไขได้

Last updated on