Current Month

ดึงข้อมูลรอบเดือนเงินเดือนปัจจุบัน ใช้สำหรับตรวจสอบว่าขณะนี้อยู่ในรอบเดือนไหน และสถานะของรอบเดือนนั้น

Endpoint


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

Request Parameters

API นี้ไม่ต้องส่ง parameters ใดๆ ระบบจะส่งคืนรอบเดือนปัจจุบันโดยอัตโนมัติ

API นี้ไม่ต้องใช้ employee_code เป็น API ระดับบริษัท/สาขา

Response Format

Success Response


{
  "code": 200,
  "message": "Current Month (2026-02) Accept",
  "payload": {
    "master_salary_report_id": "20260201ABC123456789",
    "master_salary_month": "2026-02",
    "master_salary_year": "2026",
    "master_salary_start_date": "2026-01-26",
    "master_salary_end_date": "2026-02-25",
    "read_only_flag": "N",
    "calculate_flag": "N",
    "company_id": "20241225C3024958C974",
    "branch_id": "202412254358646B34E4"
  }
}

Key Response Fields

Field	Type	Description
`master_salary_report_id`	string	รหัสรอบเงินเดือน
`master_salary_month`	string	รอบเดือน (YYYY-MM)
`master_salary_year`	string	ปี (YYYY)
`master_salary_start_date`	string	วันที่เริ่มต้นรอบเดือน (YYYY-MM-DD)
`master_salary_end_date`	string	วันที่สิ้นสุดรอบเดือน (YYYY-MM-DD)
`read_only_flag`	string	สถานะปิดเดือน: `"Y"` (ปิดแล้ว), `"N"` (ยังไม่ปิด)
`calculate_flag`	string	สถานะคำนวณ: `"Y"` (คำนวณแล้ว), `"N"` (ยังไม่คำนวณ)
`company_id`	string	รหัสบริษัท
`branch_id`	string	รหัสสาขา

Error Response


{
  "code": 401,
  "message": "Unauthorized",
  "payload": []
}

HTTP Status	Description
`401`	API Key ไม่ถูกต้องหรือไม่ได้ส่ง
`500`	ระบบขัดข้อง

Code Examples

cURL


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

JavaScript


const params = new URLSearchParams({
  path_action: 'current_month'
})
const response = await fetch(
  `https://openapi.humansoft.co.th/api/v1/open-apis/salary/get-data-filter?${params}`,
  {
    method: 'GET',
    headers: { 'Ocp-Apim-Subscription-Key': 'YOUR_API_KEY' }
  }
)
const data = await response.json()
console.log(`รอบเดือน: ${data.payload.master_salary_month}`)
console.log(`วันที่: ${data.payload.master_salary_start_date} - ${data.payload.master_salary_end_date}`)
console.log(`สถานะ: ${data.payload.read_only_flag === 'Y' ? 'ปิดแล้ว' : 'เปิดอยู่'}`)

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": "current_month"}
 
response = requests.get(url, headers=headers, params=params)
data = response.json()
p = data["payload"]
print(f"รอบเดือน: {p['master_salary_month']}")
print(f"วันที่: {p['master_salary_start_date']} - {p['master_salary_end_date']}")
print(f"สถานะ: {'ปิดแล้ว' if p['read_only_flag'] == 'Y' else 'เปิดอยู่'}")

PHP


<?php
$params = http_build_query(["path_action" => "current_month"]);
$url = "https://openapi.humansoft.co.th/api/v1/open-apis/salary/get-data-filter?{$params}";
 
$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);
$p = $data["payload"];
echo "รอบเดือน: {$p['master_salary_month']}\n";
echo "วันที่: {$p['master_salary_start_date']} - {$p['master_salary_end_date']}\n";
echo "สถานะ: " . ($p['read_only_flag'] === 'Y' ? 'ปิดแล้ว' : 'เปิดอยู่') . "\n";
?>

Notes

master_salary_month เป็นรูปแบบ YYYY-MM (เช่น "2026-02")
read_only_flag = "Y" หมายถึงเดือนปิดแล้ว ไม่สามารถแก้ไขข้อมูลได้
calculate_flag = "Y" หมายถึงคำนวณเงินเดือนแล้ว
รอบเดือนอาจไม่ตรงกับเดือนปฏิทิน (เช่น 26 ม.ค. - 25 ก.พ.)
ใช้ API นี้เพื่อหา master_salary_month สำหรับ APIs อื่นๆ

Daily In Month - ดูตารางเวลาทำงานของรอบเดือนนี้
Calculate Month - คำนวณเวลาทำงานของรอบเดือนนี้
Salary Summary - ดูสรุปเงินเดือนของรอบเดือนนี้