List Extra Rounds

ดึงรายการงวดพิเศษทั้งหมดที่มีอยู่ในเดือนที่ระบุ เพื่อนำไปแสดงผลหรือใช้เป็นตัวเลือกสำหรับดึงรายละเอียดงวดพิเศษต่อไป

Endpoint


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

Request Parameters

Parameter	Type	Required	Description	Example
`year_month`	string	Yes	เดือนและปีที่ต้องการดึงงวดพิเศษ (YYYY-MM)	`"2026-03"`

year_month ต้องเป็นรูปแบบ YYYY-MM เท่านั้น

Response Format

Success Response


{
  "code": 200,
  "message": "Extra Rounds Retrieved Successfully",
  "payload": [
    {
      "master_salary_xtra_report_id": "20241225ABCD1234",
      "master_salary_report_id": "RPT202603",
      "master_salary_month": "2026-03",
      "master_salary_xtra_seq": 1,
      "master_salary_xtra_name": "โบนัสไตรมาส1",
      "salary_paid_dt": "2026-03-31",
      "read_only_flag": "Y"
    },
    {
      "master_salary_xtra_report_id": "20250323974142",
      "master_salary_report_id": "RPT202603",
      "master_salary_month": "2026-03",
      "master_salary_xtra_seq": 2,
      "master_salary_xtra_name": "ค่าคอมมิชชัน",
      "salary_paid_dt": "2026-03-25",
      "read_only_flag": "N"
    }
  ]
}

Response Fields

Field	Type	Description
`master_salary_xtra_report_id`	string	รหัสงวดพิเศษ (plain text สำหรับนำไปใช้กับ API อื่น)
`master_salary_report_id`	string	รหัสรอบเงินเดือนหลักที่ผูกกับงวดพิเศษ
`master_salary_month`	string	เดือนที่มีงวดพิเศษ (YYYY-MM)
`master_salary_xtra_seq`	number	ลำดับงวดพิเศษในเดือนนั้น
`master_salary_xtra_name`	string	ชื่องวดพิเศษ
`salary_paid_dt`	string	วันที่จ่ายเงิน (YYYY-MM-DD)
`read_only_flag`	string	สถานะงวด: `Y` = ปิดแล้ว (Finished), `N` = ยังเปิดอยู่

Error Response


{
  "code": 400,
  "message": "ValidationException: year_month ไม่ถูกต้อง ต้องเป็นรูปแบบ YYYY-MM",
  "payload": []
}

Code Examples

cURL


curl -X GET "https://openapi.humansoft.co.th/api/v1/open-apis/salary/get-data-filter?path_action=list_extra_rounds&year_month=2026-03" \
  -H "Ocp-Apim-Subscription-Key: YOUR_API_KEY"

JavaScript


const response = await fetch(
  'https://openapi.humansoft.co.th/api/v1/open-apis/salary/get-data-filter?path_action=list_extra_rounds&year_month=2026-03',
  {
    headers: {
      'Ocp-Apim-Subscription-Key': 'YOUR_API_KEY'
    }
  }
)
const data = await response.json()
console.log(`Found ${data.payload.length} extra round(s)`)

Python


import requests
 
url = "https://openapi.humansoft.co.th/api/v1/open-apis/salary/get-data-filter"
headers = {"Ocp-Apim-Subscription-Key": "YOUR_API_KEY"}
params = {
    "path_action": "list_extra_rounds",
    "year_month": "2026-03"
}
 
response = requests.get(url, headers=headers, params=params)
data = response.json()
print(f"Found {len(data['payload'])} extra round(s)")

PHP


<?php
$url = "https://openapi.humansoft.co.th/api/v1/open-apis/salary/get-data-filter?path_action=list_extra_rounds&year_month=2026-03";
 
$ch = curl_init($url);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    "Ocp-Apim-Subscription-Key: YOUR_API_KEY"
]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
 
$response = curl_exec($ch);
curl_close($ch);
 
$data = json_decode($response, true);
echo "Found " . count($data["payload"]) . " extra round(s)\n";
?>

Notes

ถ้าไม่มีงวดพิเศษในเดือนนั้น จะคืน payload เป็น Array ว่าง []
ค่า master_salary_xtra_report_id ที่ได้รับเป็น plain text สามารถนำไปใช้กับ API อื่นได้โดยต้อง encode เป็น Base64 ก่อน

Get Extra Round Detail - นำ master_salary_xtra_report_id ไปดูรายละเอียดงวดพิเศษ
Create Extra Round - สร้างงวดพิเศษใหม่สำหรับเดือนที่ต้องการ

List Extra Rounds

Endpoint

Request Parameters

Response Format

Success Response

Response Fields

Error Response

Code Examples

cURL

JavaScript

Python

PHP

Notes

Related APIs