Get Detail Withdraw

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

Endpoint


GET /api/v1/open-apis/withdraw/get-detail
POST /api/v1/open-apis/withdraw/get-detail

Request Parameters

Parameter	Type	Required	Description	Example
`employee_code`	string	Yes	รหัสพนักงาน	`"EMP001"`
`year_month`	string	Yes	เดือนของรอบเงินเดือนที่ต้องการตรวจสอบ (YYYY-MM)	`"2026-03"`

Request Body Example


{
  "employee_code": "EMP001",
  "year_month": "2026-03"
}

Response Format

Success Response (HTTP 200)


{
  "code": 200,
  "message": "สำเร็จ",
  "payload": {
    "master_salary_month": "202603",
    "month_name": "มี.ค. 2026",
    "employee_name": "Tawan",
    "employee_last_name": "Raiduen",
    "department_name": "IT",
    "position_name": "Software Developer",
    "salary_per_week": 15000.00,
    "limit": 10000.00,
    "withdraw": 2000.00,
    "wait": 3000.00,
    "balance": 8000.00,
    "available": 5000.00,
    "round_month_config": "Full",
    "is_open_advance_payroll": true,
    "history": [
      {
        "employee_withdraw_doc_id": "20260309462FEF65EFCA",
        "withdraw_amt": "2000.00",
        "withdraw_dt": "2026-03-10",
        "approve_flag": "Y"
      }
    ],
    "docs": [
      {
        "employee_withdraw_doc_id": "20260309XCDFEF65EFCA",
        "withdraw_amt": "3000.00",
        "approve_flag": "N",
        "withdraw_dt": "2026-03-24"
      }
    ]
  }
}

Response Fields

Field	Type	Description
`master_salary_month`	string	รหัสรอบเดือนเงินเดือน
`month_name`	string	ชื่อเดือนที่แสดงผล
`employee_name`	string	ชื่อพนักงาน
`employee_last_name`	string	นามสกุลพนักงาน
`department_name`	string	ชื่อแผนก
`position_name`	string	ชื่อตำแหน่ง
`salary_per_week`	float	ฐานรายได้ที่นำมาคำนวณวงเงิน
`limit`	float	วงเงินโควตาสูงสุดที่สามารถเบิกได้ในงวดนี้
`withdraw`	float	ยอดเงินที่อนุมัติแล้วและหักออกจากลิมิต
`wait`	float	ยอดเงินที่รออนุมัติซึ่งกันวงเงินไว้แล้ว
`balance`	float	ยอดคงเหลือ
`available`	float	วงเงินคงเหลือสุทธิที่สามารถยื่นขอเพิ่มได้ (`limit - withdraw - wait`)
`round_month_config`	string	รูปแบบรอบเงินเดือน (`Full` = รายเดือนปกติ, `Split` = แบ่งจ่าย)
`is_open_advance_payroll`	boolean	สถานะว่าพนักงานเปิดให้เบิกล่วงหน้าได้หรือไม่
`history`	array	รายการเอกสารที่อนุมัติแล้ว
`docs`	array	รายการเอกสารที่ยังไม่ถูกลบ (ทั้งรออนุมัติหรือปฏิเสธ)

Approve Flag Values (ใน `docs` array)

ค่า	ความหมาย
`N`	รออนุมัติ (Pending)
`Y`	อนุมัติแล้ว (Approved)
`R`	ปฏิเสธ (Rejected)
`C`	ยกเลิก (Cancelled)

Error Response - Validation Failed (HTTP 422)


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

Error Response - Employee Not Found (HTTP 404)


{
  "code": 404,
  "message": "ไม่พบข้อมูลพนักงาน"
}

Code Examples

cURL


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

JavaScript


const params = new URLSearchParams({
  employee_code: 'EMP001',
  year_month: '2026-03'
})
 
const response = await fetch(
  `https://openapi.humansoft.co.th/api/v1/open-apis/withdraw/get-detail?${params}`,
  {
    headers: {
      'Ocp-Apim-Subscription-Key': 'YOUR_API_KEY'
    }
  }
)
 
const data = await response.json()
 
if (data.code === 200) {
  console.log('วงเงินคงเหลือ:', data.payload.available)
} else {
  console.error('Error:', data.message)
}

Python


import requests
 
url = "https://openapi.humansoft.co.th/api/v1/open-apis/withdraw/get-detail"
headers = {
    "Ocp-Apim-Subscription-Key": "YOUR_API_KEY"
}
params = {
    "employee_code": "EMP001",
    "year_month": "2026-03"
}
 
response = requests.get(url, headers=headers, params=params)
data = response.json()
 
if data['code'] == 200:
    print('วงเงินคงเหลือ:', data['payload']['available'])
else:
    print('Error:', data.get('message'))

PHP


<?php
$params = http_build_query([
    "employee_code" => "EMP001",
    "year_month" => "2026-03"
]);
 
$url = "https://openapi.humansoft.co.th/api/v1/open-apis/withdraw/get-detail?" . $params;
 
$headers = [
    "Ocp-Apim-Subscription-Key: YOUR_API_KEY"
];
 
$ch = curl_init($url);
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
 
$response = curl_exec($ch);
$data = json_decode($response, true);
 
if ($data['code'] === 200) {
    echo "วงเงินคงเหลือ: " . $data['payload']['available'] . "\n";
} else {
    echo "Error: " . $data['message'];
}
 
curl_close($ch);
?>

Notes

ข้อควรทราบ:

employee_withdraw_doc_id ใน response จะเป็น plain text สำหรับนำไปใช้ใน API อื่นๆ (ต้องเข้ารหัส Base64 ก่อนส่ง)
ยอด limit อาจเปลี่ยนระหว่างเดือนได้หากมีการปรับฐานเงินเดือนหรือแก้ไขการตั้งค่าโควตาโดย HR
หาก is_open_advance_payroll เป็น false พนักงานจะไม่สามารถส่งคำขอเบิกได้ แม้จะมี available เหลืออยู่

Submit - ส่งคำขอเบิกเงินหลังจากตรวจสอบวงเงิน
Get Month - ดูรายการเดือนที่เปิดให้เบิก

Get Detail Withdraw

Endpoint

Request Parameters

Request Body Example

Response Format

Success Response (HTTP 200)

Response Fields

Approve Flag Values (ใน docs array)

Error Response - Validation Failed (HTTP 422)

Error Response - Employee Not Found (HTTP 404)

Code Examples

cURL

JavaScript

Python

PHP

Notes

Related APIs

Approve Flag Values (ใน `docs` array)