Save Withdraw (HR Override)
อนุมัติเอกสารเบิกเงินล่วงหน้าโดย HR แบบ Manual Override พร้อมสามารถปรับปรุงยอดเงินจริงที่จะจ่ายให้พนักงานได้ ระบบจะบังคับเปลี่ยนสถานะเอกสารเป็น Y (Approved) ทันทีหลังบันทึกสำเร็จ
Endpoint
POST /api/v1/open-apis/withdraw/saveRequest Parameters
Required Parameters
| Parameter | Type | Required | Description | Example |
|---|---|---|---|---|
employee_withdraw_doc_id | string (base64) | Yes | รหัสเอกสาร (ต้องเข้ารหัส Base64) | "MjAyNjAzMTJXREQwMDAwMDAwMQ==" |
approve_amt | float | Yes | จำนวนเงินที่ HR อนุมัติให้เบิกจริง (ต้อง >= 0) | 1800.00 |
Optional Parameters
| Parameter | Type | Default | Description | Example |
|---|---|---|---|---|
approve_dt | string | (วันนี้) | วันที่ทำการอนุมัติ (YYYY-MM-DD) | "2026-03-24" |
approve_remark | string | "" | เหตุผลหรือหมายเหตุประกอบการแก้ไขยอด | "ปรับลดยอดเบิกให้ตามวงเงินคงเหลือจริง" |
Validation Rules
| กฎ | รายละเอียด |
|---|---|
| ID Encoding | employee_withdraw_doc_id ต้องเข้ารหัส Base64 |
| Amount Logic | approve_amt ต้องเป็นตัวเลขบวกหรือศูนย์เท่านั้น |
| Month Lock | หากเดือนที่อ้างอิงปิดงวดไปแล้ว ระบบจะไม่อนุญาตให้แก้ไขข้อมูล |
Request Body Example
{
"employee_withdraw_doc_id": "MjAyNjAzMTJXREQwMDAwMDAwMQ==",
"approve_amt": 1800.00,
"approve_remark": "หักค่าธรรมเนียมบริษัทเรียบร้อย",
"approve_dt": "2026-03-24"
}Response Format
Success Response (HTTP 200)
{
"code": 200,
"message": "บันทึกและอนุมัติสำเร็จ",
"payload": {
"employee_withdraw_doc_id": "20260312WDD00000001",
"employee_id": "20260309462FEF65EFCA",
"withdraw_amt": "1800.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 | สถานะหลังการอัปเดต (Y) |
approve_remark | string | หมายเหตุการอนุมัติ |
approve_dt | string | วันที่อนุมัติ |
Error Response - Validation Failed (HTTP 422)
{
"code": 422,
"message": "Validation failed",
"errors": ["'approve_amt' is required and must be numeric"]
}Error Response - Document Locked (HTTP 400)
{
"code": 400,
"message": "ไม่สามารถจัดการเอกสารในรอบที่ปิดแล้ว"
}Code Examples
cURL
curl -X POST "https://openapi.humansoft.co.th/api/v1/open-apis/withdraw/save" \
-H "Ocp-Apim-Subscription-Key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"employee_withdraw_doc_id": "MjAyNjAzMTJXREQwMDAwMDAwMQ==",
"approve_amt": 1800.00,
"approve_remark": "หักค่าธรรมเนียมบริษัทเรียบร้อย",
"approve_dt": "2026-03-24"
}'Notes
ข้อควรทราบ:
- ใช้ API นี้เฉพาะเมื่อต้องการ Override กระบวนการอนุมัติปกติ หรือต้องการแก้ไขยอดเงินเบิกจริงที่ไม่ตรงกับยอดที่พนักงานร้องขอมา
- ยอด
approve_amtจะเป็นยอดสุทธิที่จะไปแสดงในสลิปเงินเดือนของพนักงาน employee_withdraw_doc_idต้องเข้ารหัส Base64
Related APIs
- Approve - อนุมัติตามขั้นตอนปกติ
- Get Detail - ตรวจสอบยอดที่พนักงานขอมาก่อนทำการปรับปรุง
Last updated on