Approve Withdraw

อนุมัติเอกสารการเบิกเงินล่วงหน้า โดยระบบจะดำเนินการตัดยอดเงินเดือนและบันทึกรายการหักเงินอัตโนมัติ

Endpoint


POST /api/v1/open-apis/withdraw/approve

Request Parameters

Required Parameters

Parameter	Type	Required	Description	Example
`employee_withdraw_doc_id`	string (base64)	Yes	รหัสเอกสาร (ต้องเข้ารหัส Base64)	`"MjAyNjAzMTJXREQwMDAwMDAwMQ=="`
`approve_flag`	string	Yes	สถานะการอนุมัติ (`Y` = อนุมัติ, `N` = รอพิจารณา, `R` = ปฏิเสธ)	`"Y"`

Optional Parameters

Parameter	Type	Default	Description	Example
`approve_dt`	string	`(วันนี้)`	วันที่บันทึกการอนุมัติ (YYYY-MM-DD)	`"2026-03-24"`
`approve_remark`	string	`""`	หมายเหตุประกอบการตัดสินใจ	`"อนุมัติตามระเบียบใหม่"`
`charge_employee_amt`	float	`0.00`	ยอดค่าธรรมเนียมที่เรียกเก็บจากพนักงาน	`15.00`
`charge_company_amt`	float	`0.00`	ยอดค่าธรรมเนียมที่บริษัทรับภาระแทน	`0.00`

Approve Flag Values

ค่า	ความหมาย	รายละเอียด
`Y`	อนุมัติ (Approved)	ระบบจะทำการตัดยอดและบันทึกรายการหักเงินเดือน
`N`	รอพิจารณา (Pending)	เอกสารจะยังค้างอยู่ในระบบเพื่อรอการตัดสินใจภายหลัง
`R`	ปฏิเสธ (Rejected)	เอกสารจะไม่ถูกนำไปคิดเงินเดือน และแจ้งกลับไปยังพนักงาน

Request Body Example


{
  "employee_withdraw_doc_id": "MjAyNjAzMTJXREQwMDAwMDAwMQ==",
  "approve_flag": "Y",
  "approve_remark": "ผ่านการตรวจสอบแล้ว",
  "charge_employee_amt": 15.00
}

Response Format

Success Response (HTTP 200)


{
  "code": 200,
  "message": "อนุมัติเรียบร้อยแล้ว",
  "payload": {
    "employee_withdraw_doc_id": "20260312WDD00000001",
    "employee_id": "20260309462FEF65EFCA",
    "withdraw_amt": "2000.00",
    "approve_flag": "Y",
    "approve_remark": "ผ่านการตรวจสอบแล้ว",
    "approve_dt": "2026-03-24"
  }
}

Response Fields

Field	Type	Description
`employee_withdraw_doc_id`	string	รหัสเอกสาร
`employee_id`	string	รหัสพนักงาน
`withdraw_amt`	string	จำนวนเงินที่เบิก
`approve_flag`	string	สถานะสุดท้ายหลังจากอัปเดต
`approve_remark`	string	หมายเหตุการอนุมัติ
`approve_dt`	string	วันที่การอนุมัติมีผล

Error Response - Document Not Found (HTTP 404)


{
  "code": 404,
  "message": "ไม่พบข้อมูลเอกสาร"
}

Error Response - Double Approve (HTTP 400)


{
  "code": 400,
  "message": "ไม่สามารถอนุมัติเอกสารที่อนุมัติไปแล้วได้"
}

Code Examples

cURL


curl -X POST "https://openapi.humansoft.co.th/api/v1/open-apis/withdraw/approve" \
  -H "Ocp-Apim-Subscription-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "employee_withdraw_doc_id": "MjAyNjAzMTJXREQwMDAwMDAwMQ==",
    "approve_flag": "Y",
    "approve_remark": "ผ่านการตรวจสอบแล้ว",
    "charge_employee_amt": 15.00
  }'

JavaScript


const response = await fetch(
  'https://openapi.humansoft.co.th/api/v1/open-apis/withdraw/approve',
  {
    method: 'POST',
    headers: {
      'Ocp-Apim-Subscription-Key': 'YOUR_API_KEY',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      employee_withdraw_doc_id: 'MjAyNjAzMTJXREQwMDAwMDAwMQ==',
      approve_flag: 'Y',
      approve_remark: 'ผ่านการตรวจสอบแล้ว',
      charge_employee_amt: 15.00
    })
  }
)
 
const data = await response.json()
 
if (data.code === 200) {
  console.log('อนุมัติสำเร็จ:', data.payload.employee_withdraw_doc_id)
} else {
  console.error('Error:', data.message)
}

Python


import requests
 
url = "https://openapi.humansoft.co.th/api/v1/open-apis/withdraw/approve"
headers = {
    "Ocp-Apim-Subscription-Key": "YOUR_API_KEY",
    "Content-Type": "application/json"
}
payload = {
    "employee_withdraw_doc_id": "MjAyNjAzMTJXREQwMDAwMDAwMQ==",
    "approve_flag": "Y",
    "approve_remark": "ผ่านการตรวจสอบแล้ว",
    "charge_employee_amt": 15.00
}
 
response = requests.post(url, headers=headers, json=payload)
data = response.json()
 
if data['code'] == 200:
    print('อนุมัติสำเร็จ:', data['payload']['employee_withdraw_doc_id'])
else:
    print('Error:', data.get('message'))

PHP


<?php
$url = "https://openapi.humansoft.co.th/api/v1/open-apis/withdraw/approve";
 
$headers = [
    "Ocp-Apim-Subscription-Key: YOUR_API_KEY",
    "Content-Type: application/json"
];
 
$payload = [
    "employee_withdraw_doc_id" => "MjAyNjAzMTJXREQwMDAwMDAwMQ==",
    "approve_flag" => "Y",
    "approve_remark" => "ผ่านการตรวจสอบแล้ว",
    "charge_employee_amt" => 15.00
];
 
$ch = curl_init($url);
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($payload));
 
$response = curl_exec($ch);
$data = json_decode($response, true);
 
if ($data['code'] === 200) {
    echo "อนุมัติสำเร็จ: " . $data['payload']['employee_withdraw_doc_id'] . "\n";
} else {
    echo "Error: " . $data['message'];
}
 
curl_close($ch);
?>

Notes

ข้อควรทราบ:

employee_withdraw_doc_id ต้องเข้ารหัส Base64 มิเช่นนั้นระบบจะไม่สามารถค้นหาเอกสารพบ
ไม่อนุญาตให้อนุมัติซ้ำสำหรับเอกสารที่มีสถานะเป็น Y (อนุมัติแล้ว)
การอนุมัติผ่าน API นี้จะเป็นการจำลองพฤติกรรมเหมือนหัวหน้าหรือ HR กดอนุมัติผ่านหน้าเว็บ

Reject - ปฏิเสธคำขอเบิกเงิน
Save - อนุมัติแบบ HR Override พร้อมปรับยอดเงิน

Approve Withdraw

Endpoint

Request Parameters

Required Parameters

Optional Parameters

Approve Flag Values

Request Body Example

Response Format

Success Response (HTTP 200)

Response Fields

Error Response - Document Not Found (HTTP 404)

Error Response - Double Approve (HTTP 400)

Code Examples

cURL

JavaScript

Python

PHP

Notes

Related APIs