Skip to Content
🚀 Welcome to Humansoft Open API Documentation

Unfinish Month

ยกเลิกการปิดงวดเงินเดือน (ปลดล็อค) เพื่อให้สามารถแก้ไขข้อมูลย้อนหลังได้

Endpoint

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

Request Body

Required Parameters

ParameterTypeRequiredDescriptionExample
year_monthstringYesงวดเดือนที่ต้องการยกเลิกการปิด (YYYY-MM)"2026-02"
user_namestringYesชื่อผู้ใช้งานสำหรับยืนยันการทำรายการ"admin"
user_pswstringYesรหัสผ่านผู้ใช้งานสำหรับยืนยันการทำรายการ"password123"

Optional Parameters

ParameterTypeRequiredDescriptionExample
master_salary_split_seqintegerNoลำดับงวดแบ่งจ่าย (กรณีใช้งาน Split Payroll)1

Validation Rules

RuleDescription
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

FieldTypeDescription
master_salary_report_idstringID ของรอบการจ่ายเงินเดือนที่ถูกปลดล็อค
read_only_flagstringสถานะการล็อค (N = ปลดล็อคแล้ว)

Error Responses

{ "code": 500, "message": "ไม่พบรอบการจ่ายเงินเดือนสำหรับเดือน 2026-02", "payload": [] }
{ "code": 500, "message": "กรุณาปลดล็อกงวดเต็ม ก่อนทำการทำการปลดล็อกงวดนี้", "payload": [] }
{ "code": 500, "message": "ไม่สามารถเปิดงวดบัญชีที่ 1 ได้ เนื่องจากงวดบัญชีที่ 2 ยังปิดอยู่ กรุณาเปิดบัญชีงวดที่ 2 ก่อนทำการเปิดงวดบัญชีนี้", "payload": [] }
HTTP StatusDescription
200ปลดล็อคงวดสำเร็จ
401API Key ไม่ถูกต้องหรือไม่ได้ส่ง
500ไม่พบงวดเดือน หรือ ปลดล็อคผิดลำดับ

Code Examples

# 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" }'

  • Finish Month - ปิดงวดเงินเดือน (ล็อค)
  • Calculate Month - คำนวณสรุปรายเดือน
  • Salary Summary - ดูผลลัพธ์การคำนวณ
Last updated on