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-monthRequest Parameters
Required Parameters
| Parameter | Type | Required | Description | Example |
|---|---|---|---|---|
year_month | string | Yes | เดือนของรอบเงินเดือนที่ต้องการดู (YYYY-MM) | "2026-03" |
Optional Parameters
| Parameter | Type | Default | Description | Example |
|---|---|---|---|---|
master_salary_split_seq | int | null | ลำดับงวด (หากต้องการดูแยกตาม 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
| Field | Type | Description |
|---|---|---|
payload | array | รายการเอกสารเบิกทั้งหมดในเดือนนั้น |
employee_withdraw_doc_id | string | รหัสเอกสาร |
employee_id | string | รหัสพนักงาน |
employee_code | string | รหัสพนักงาน (employee code) |
withdraw_amt | string | จำนวนเงินที่ขอเบิก |
approve_flag | string | สถานะเอกสาร (Y, N, R, C) |
user_given_name | string | ชื่อจริงของผู้ที่แก้ไขล่าสุด |
user_surname | string | นามสกุลของผู้ที่แก้ไขล่าสุด |
round_month_config | string | รูปแบบรอบเงินเดือน (Full หรือ Split) |
created | string | วันเวลาที่สร้างเอกสาร |
end_dt | string | วันที่สิ้นสุดของรอบค่าจ้าง |
finish_month | string | สถานะการล็อกงวด (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
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 แทน
Related APIs
Last updated on