Finish Month

ปิดงวดการคำนวณเงินเดือน เพื่อล็อคข้อมูลไม่ให้แก้ไขได้ และเตรียมความพร้อมสำหรับเดือนถัดไป

Endpoint


POST /api/v1/open-apis/salary/update-data-filter?path_action=finish_month

Request Body

Required Parameters

Parameter	Type	Required	Description	Example
`year_month`	string	Yes	งวดเดือนที่ต้องการปิด (YYYY-MM)	`"2026-02"`

Optional Parameters

Parameter	Type	Required	Description	Example
`master_salary_split_seq`	integer	No	ลำดับงวดแบ่งจ่าย (กรณีปิดเฉพาะงวดแบ่งจ่าย)	`1`

Validation Rules

Rule	Description
`year_month`	ต้องเป็นรูปแบบ YYYY-MM และมีอยู่ในระบบ
งวดแบ่งจ่าย	ห้ามปิดข้ามงวด — ต้องปิดงวดแรกก่อนจึงจะปิดงวดถัดไปได้

API นี้มีผลกระทบสูง — เมื่อปิดงวดแล้วจะไม่สามารถแก้ไขข้อมูลเวลาทำงานหรือยอดเงินภายในงวดนั้นได้อีก ควรเรียกใช้เมื่อมั่นใจว่าข้อมูลในงวดนั้นถูกต้องครบถ้วนแล้ว

System Auto Actions

เมื่อปิดงวดสำเร็จ ระบบจะดำเนินการต่อไปนี้โดยอัตโนมัติ:

สร้างงวดเดือนถัดไป — สร้างรอบการจ่ายเงินเดือนใหม่พร้อมตั้งค่าเริ่มต้น
จัดการพนักงานลาออก — พนักงานที่ถึงวันลาออกจะถูกนำออกจากระบบการคำนวณ
ประมวลผลเงินกู้ — ปรับสถานะงวดเงินกู้เป็น “ชำระแล้ว”
บันทึกข้อมูลกองทุน — สรุปยอดเงินกองทุนสำรองเลี้ยงชีพ
คำนวณโควตาวันลา — ส่งคิวเพื่อคำนวณโควตาวันลาใหม่สำหรับพนักงานทุกคน

หากระบุ master_salary_split_seq จะเป็นการปิดเฉพาะงวดจ่ายย่อย — การจัดการพนักงานลาออกและเงินกู้จะยังไม่ถูกประมวลผลจนกว่าจะปิดงวดเต็ม (Full Month)

Response Format

Success Response


{
  "code": 200,
  "message": "Finish Month (2026-02) Accept Return Next month",
  "payload": {
    "master_salary_report_id": "124",
    "master_salary_month": "2026-03"
  }
}

Response Fields

Field	Type	Description
`master_salary_report_id`	string	ID ของรอบการจ่ายเงินเดือนใหม่ (เดือนถัดไป)
`master_salary_month`	string	เดือนของงวดถัดไปที่ถูกสร้าง (YYYY-MM)

Error Responses


{
  "code": 500,
  "message": "ไม่พบรอบการจ่ายเงินเดือนสำหรับเดือน 2026-02",
  "payload": []
}


{
  "code": 500,
  "message": "ไม่สามารถปิดงวดที่ 2 ได้ เนื่องจากงวดที่ 1 ยังไม่ปิด กรุณาปิดงวดที่ 1 ก่อนทำการปิดงวดบัญชีนี้",
  "payload": []
}

HTTP Status	Description
`200`	ปิดงวดสำเร็จ
`401`	API Key ไม่ถูกต้องหรือไม่ได้ส่ง
`500`	ไม่พบงวดเดือน หรือ ปิดข้ามงวดแบ่งจ่าย

Code Examples

cURL


# Finish full month
curl -X POST "https://openapi.humansoft.co.th/api/v1/open-apis/salary/update-data-filter?path_action=finish_month" \
  -H "Ocp-Apim-Subscription-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "year_month": "2026-02"
  }'
 
# Finish split month
curl -X POST "https://openapi.humansoft.co.th/api/v1/open-apis/salary/update-data-filter?path_action=finish_month" \
  -H "Ocp-Apim-Subscription-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "year_month": "2026-02",
    "master_salary_split_seq": 1
  }'

JavaScript


const response = await fetch(
  'https://openapi.humansoft.co.th/api/v1/open-apis/salary/update-data-filter?path_action=finish_month',
  {
    method: 'POST',
    headers: {
      'Ocp-Apim-Subscription-Key': 'YOUR_API_KEY',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      year_month: '2026-02'
    })
  }
)
const data = await response.json()
console.log(`Next month: ${data.payload.master_salary_month}`)

Python


import requests
 
url = "https://openapi.humansoft.co.th/api/v1/open-apis/salary/update-data-filter"
headers = {"Ocp-Apim-Subscription-Key": "YOUR_API_KEY"}
params = {"path_action": "finish_month"}
payload = {
    "year_month": "2026-02"
}
 
response = requests.post(url, headers=headers, params=params, json=payload)
data = response.json()
print(f"Next month: {data['payload']['master_salary_month']}")

PHP


<?php
$url = "https://openapi.humansoft.co.th/api/v1/open-apis/salary/update-data-filter?path_action=finish_month";
$data = json_encode([
    "year_month" => "2026-02"
]);
 
$ch = curl_init($url);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    "Ocp-Apim-Subscription-Key: YOUR_API_KEY",
    "Content-Type: application/json"
]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
 
$response = curl_exec($ch);
curl_close($ch);
 
$result = json_decode($response, true);
echo "Next month: {$result['payload']['master_salary_month']}\n";
?>

Unfinish Month - ยกเลิกปิดงวด (ปลดล็อค)
Calculate Month - คำนวณสรุปรายเดือน
Calculate Month Queue - คำนวณสรุปรายเดือนแบบ Batch
Salary Summary - ดูผลลัพธ์การคำนวณ