Unfinish Month
ยกเลิกการปิดงวดเงินเดือน (ปลดล็อค) เพื่อให้สามารถแก้ไขข้อมูลย้อนหลังได้
Endpoint
POST /api/v1/open-apis/salary/update-data-filter?path_action=unfinish_monthRequest Body
Required Parameters
| Parameter | Type | Required | Description | Example |
|---|---|---|---|---|
year_month | string | Yes | งวดเดือนที่ต้องการยกเลิกการปิด (YYYY-MM) | "2026-02" |
user_name | string | Yes | ชื่อผู้ใช้งานสำหรับยืนยันการทำรายการ | "admin" |
user_psw | string | Yes | รหัสผ่านผู้ใช้งานสำหรับยืนยันการทำรายการ | "password123" |
Optional Parameters
| Parameter | Type | Required | Description | Example |
|---|---|---|---|---|
master_salary_split_seq | integer | No | ลำดับงวดแบ่งจ่าย (กรณีใช้งาน Split Payroll) | 1 |
Validation Rules
| Rule | Description |
|---|---|
year_month | ต้องเป็นรูปแบบ YYYY-MM และมีอยู่ในระบบ |
user_name / user_psw | ต้องระบุเพื่อยืนยันตัวตนในการยกเลิกการปิดงวด |
| งวดแบ่งจ่าย | ต้องปลดล็อคงวดเต็ม (Full Month) ก่อนจึงจะปลดล็อคงวดย่อยได้ |
| ลำดับงวดแบ่งจ่าย | ต้องปลดล็อคจากงวดหลังสุดไปงวดแรกสุด (เช่น ปลดงวด 2 ก่อน จึงปลดงวด 1 ได้) |
การยกเลิกปิดงวดจะทำให้สามารถแก้ไขเวลาทำงานหรือเพิ่มเอกสารในงวดนั้นได้อีกครั้ง ระบบจะบันทึกประวัติการยกเลิกปิดงวดไว้
Response Format
Success Response
{
"code": 200,
"message": "Unfinish Month (2026-02) Accept",
"payload": {
"master_salary_report_id": "123",
"read_only_flag": "N"
}
}Response Fields
| Field | Type | Description |
|---|---|---|
master_salary_report_id | string | ID ของรอบการจ่ายเงินเดือนที่ถูกปลดล็อค |
read_only_flag | string | สถานะการล็อค (N = ปลดล็อคแล้ว) |
Error Responses
{
"code": 500,
"message": "ไม่พบรอบการจ่ายเงินเดือนสำหรับเดือน 2026-02",
"payload": []
}{
"code": 500,
"message": "กรุณาปลดล็อกงวดเต็ม ก่อนทำการทำการปลดล็อกงวดนี้",
"payload": []
}{
"code": 500,
"message": "ไม่สามารถเปิดงวดบัญชีที่ 1 ได้ เนื่องจากงวดบัญชีที่ 2 ยังปิดอยู่ กรุณาเปิดบัญชีงวดที่ 2 ก่อนทำการเปิดงวดบัญชีนี้",
"payload": []
}| HTTP Status | Description |
|---|---|
200 | ปลดล็อคงวดสำเร็จ |
401 | API Key ไม่ถูกต้องหรือไม่ได้ส่ง |
500 | ไม่พบงวดเดือน หรือ ปลดล็อคผิดลำดับ |
Code Examples
cURL
# Unfinish full month
curl -X POST "https://openapi.humansoft.co.th/api/v1/open-apis/salary/update-data-filter?path_action=unfinish_month" \
-H "Ocp-Apim-Subscription-Key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"year_month": "2026-02",
"user_name": "admin",
"user_psw": "password123"
}'
# Unfinish split month
curl -X POST "https://openapi.humansoft.co.th/api/v1/open-apis/salary/update-data-filter?path_action=unfinish_month" \
-H "Ocp-Apim-Subscription-Key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"year_month": "2026-02",
"master_salary_split_seq": 1,
"user_name": "admin",
"user_psw": "password123"
}'Related APIs
- Finish Month - ปิดงวดเงินเดือน (ล็อค)
- Calculate Month - คำนวณสรุปรายเดือน
- Salary Summary - ดูผลลัพธ์การคำนวณ
Last updated on