Skip to Content
🚀 Welcome to Humansoft Open API Documentation

Get List By Month

ดึงรายการเอกสารเบิกเงินล่วงหน้าประจำเดือน สำหรับเจ้าหน้าที่ HR ใช้ตรวจสอบภาพรวมการเบิกเงินของพนักงานทุกคนในเดือนที่กำหนด

Endpoint

GET /api/v1/open-apis/withdraw/get-list-by-month POST /api/v1/open-apis/withdraw/get-list-by-month

Request Parameters

Required Parameters

ParameterTypeRequiredDescriptionExample
year_monthstringYesเดือนของรอบเงินเดือนที่ต้องการดู (YYYY-MM)"2026-03"

Optional Parameters

ParameterTypeDefaultDescriptionExample
master_salary_split_seqintnullลำดับงวด (หากต้องการดูแยกตาม Split Round)1

Request Body Example

{ "year_month": "2026-03" }

Response Format

Success Response (HTTP 200)

{ "code": 200, "message": "สำเร็จ", "payload": [ { "employee_withdraw_doc_id": "20260312WDD00000001", "employee_id": "20260309462FEF65EFCA", "employee_code": "EMP001", "withdraw_amt": "2000.00", "approve_flag": "Y", "user_given_name": "Somchai", "user_surname": "HR_Admin", "round_month_config": "Full", "created": "2026-03-09 10:00:00" } ], "end_dt": "2026-03-31 00:00:00", "finish_month": "N" }

Response Fields

FieldTypeDescription
payloadarrayรายการเอกสารเบิกทั้งหมดในเดือนนั้น
employee_withdraw_doc_idstringรหัสเอกสาร
employee_idstringรหัสพนักงาน
employee_codestringรหัสพนักงาน (employee code)
withdraw_amtstringจำนวนเงินที่ขอเบิก
approve_flagstringสถานะเอกสาร (Y, N, R, C)
user_given_namestringชื่อจริงของผู้ที่แก้ไขล่าสุด
user_surnamestringนามสกุลของผู้ที่แก้ไขล่าสุด
round_month_configstringรูปแบบรอบเงินเดือน (Full หรือ Split)
createdstringวันเวลาที่สร้างเอกสาร
end_dtstringวันที่สิ้นสุดของรอบค่าจ้าง
finish_monthstringสถานะการล็อกงวด (Y = ล็อกแล้ว, N = ยังเปิดอยู่)

Finish Month Values

ค่าความหมาย
Nเดือนยังไม่ถูกประมวลผล พนักงานยังสามารถเบิกได้
Yเดือนนี้ถูกสรุปยอดและล็อกข้อมูลแล้ว ไม่สามารถเบิกเพิ่มได้

Error Response - Validation Failed (HTTP 422)

{ "code": 422, "message": "Validation failed", "errors": ["'year_month' is required"] }

Code Examples

curl -X GET "https://openapi.humansoft.co.th/api/v1/open-apis/withdraw/get-list-by-month?year_month=2026-03" \ -H "Ocp-Apim-Subscription-Key: YOUR_API_KEY"

Notes

ข้อควรทราบ:

  • API นี้ไม่มีการคำนวณวงเงินคงเหลือรายคน ทำให้ประมวลผลข้อมูลจำนวนมากได้รวดเร็ว
  • หากต้องการดูข้อมูลที่มีการกรองพนักงานหรือแผนกที่ละเอียดขึ้น ให้ใช้ Get List แทน
  • Save - อนุมัติแบบ HR Override จากหน้ารวมนี้
  • Get List - ดูรายการเอกสารแบบกรองละเอียด
Last updated on