Get Detail Split Withdraw

ดึงรายละเอียดวงเงินเบิกล่วงหน้าแบบแบ่งตามงวดการจ่ายเงิน (Split Round) สำหรับบริษัทที่มีการจ่ายเงินเดือนหลายรอบต่อเดือน

API นี้ใช้สำหรับบริษัทที่ตั้งค่าการจ่ายเงินเดือนแบบ Split Round เท่านั้น (เช่น จ่ายทุกวันที่ 15 และสิ้นเดือน) หากบริษัทจ่ายเงินเดือนแบบ Full Month ให้ใช้ Get Detail แทน

Endpoint


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

Request Parameters

Parameter	Type	Required	Description	Example
`employee_code`	string	Yes	รหัสพนักงาน	`"EMP001"`
`year_month`	string	Yes	เดือนของรอบเงินเดือน (YYYY-MM)	`"2026-03"`
`master_salary_split_seq`	int	Yes	ลำดับงวดการจ่ายเงินในเดือนนั้น (เช่น 1, 2)	`1`

Request Body Example


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

Response Format

Success Response (HTTP 200)


{
  "code": 200,
  "message": "สำเร็จ",
  "payload": {
    "master_salary_split_month": "202603S01",
    "month_name": "มี.ค. 2026 (งวด 1)",
    "employee_name": "Tawan",
    "employee_last_name": "Raiduen",
    "department_name": "IT",
    "position_name": "Software Developer",
    "salary_per_week": 7500.00,
    "limit": 5000.00,
    "withdraw": 1000.00,
    "wait": 1500.00,
    "available": 2500.00,
    "balance": 5000.00,
    "date_disable": null,
    "finish_split_round": "N",
    "detail_per_week": "คำนวณจากงวดวันที่ 01 - 15",
    "history": [
      {
        "employee_withdraw_doc_id": "20260309S1FEF65EFCA",
        "withdraw_amt": "1000.00",
        "withdraw_dt": "2026-03-05",
        "approve_flag": "Y"
      }
    ],
    "docs": [
      {
        "employee_withdraw_doc_id": "20260309S2FEF65EFCA",
        "withdraw_amt": "1500.00",
        "approve_flag": "N",
        "withdraw_dt": "2026-03-10"
      }
    ]
  }
}

Response Fields

Field	Type	Description
`master_salary_split_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	ยอดเงินที่รออนุมัติในงวดนี้
`available`	float	ยอดเงินคงเหลือจริงที่สามารถเบิกเพิ่มในงวดนี้
`balance`	float	ยอดคงเหลือ
`date_disable`	string\|null	วันที่ปิดการเบิก (null หากยังเปิดอยู่)
`finish_split_round`	string	สถานะการปิดงวด (`Y` = ล็อกแล้ว, `N` = ยังเปิดเบิกได้)
`detail_per_week`	string	รายละเอียดช่วงวันที่ของงวด
`history`	array	รายการที่เบิกสำเร็จแล้วในงวดนี้
`docs`	array	รายการที่กำลังรออนุมัติหรือดำเนินการในงวดนี้

Finish Split Round Values

ค่า	ความหมาย
`N`	งวดยังไม่ถูกปิด สามารถเบิกได้ตามโควตา
`Y`	งวดถูกประมวลผลหรือจ่ายไปแล้ว ไม่สามารถเบิกเพิ่มได้

Error Response - Invalid Split Sequence (HTTP 422)


{
  "code": 422,
  "message": "Validation failed",
  "errors": ["'master_salary_split_seq' is invalid"]
}

Code Examples

cURL


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

JavaScript


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

Python


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

PHP


<?php
$params = http_build_query([
    "employee_code" => "EMP001",
    "year_month" => "2026-03",
    "master_salary_split_seq" => 1
]);
 
$url = "https://openapi.humansoft.co.th/api/v1/open-apis/withdraw/get-detail-split?" . $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

ข้อควรทราบ:

หากพนักงานเบิกเงินเกินโควตาของงวดที่ 1 ระบบจะนำยอดที่เกินไปหักออกจากวงเงินของงวดที่ 2 อัตโนมัติ
การเบิกงวด Split Round อาจมีค่าธรรมเนียมที่แตกต่างจากรอบ Full Month ขึ้นอยู่กับการตั้งค่าขององค์กร
master_salary_split_seq ต้องเป็นตัวเลขที่มีอยู่จริงในผังการแบ่งจ่ายเงินเดือน

Submit - ส่งคำขอเบิกโดยต้องส่ง master_salary_split_seq ไปด้วย
Get Detail - ดูภาพรวมวงเงินรายเดือนทั้งหมด