Submit Withdraw
ยื่นคำขอสร้างเอกสารเบิกเงินล่วงหน้าใหม่เข้าสู่ระบบ โดยระบบจะตรวจสอบวงเงินโควตาและเงื่อนไขต่างๆ ก่อนทำการบันทึก เอกสารที่สร้างขึ้นจะเริ่มต้นด้วยสถานะรออนุมัติ (N)
Endpoint
POST /api/v1/open-apis/withdraw/submitRequest Parameters
Required Parameters
| Parameter | Type | Required | Description | Example |
|---|---|---|---|---|
employee_code | string | Yes | รหัสพนักงานที่ต้องการสร้างเอกสาร | "EMP001" |
year_month | string | Yes | เดือนของรอบเงินเดือนที่ต้องการขอเบิก (YYYY-MM) | "2026-03" |
withdraw_amt | float | Yes | จำนวนเงินที่ต้องการขอเบิก (ต้องเป็นบวก) | 2000.00 |
Optional Parameters
| Parameter | Type | Default | Description | Example |
|---|---|---|---|---|
master_salary_split_seq | int | null | ลำดับงวด (เฉพาะกรณีบริษัทเปิดใช้ Split Round) | 1 |
Validation Rules
| กฎ | รายละเอียด |
|---|---|
| Quota limit | ยอดเบิก + ยอดรออนุมัติ + ยอดเบิกที่จ่ายไปแล้ว ต้องไม่เกินวงเงินสูงสุด |
| Minimum Amount | จำนวนเงินต้องมากกว่า 0 (หรือตามที่บริษัทกำหนดขั้นต่ำไว้) |
| Duplicate Request | ระบบป้องกันการยื่นคำขอซ้ำในขณะที่รายการเดิมยังอยู่ระหว่างดำเนินการ (ขึ้นอยู่กับการตั้งค่าองค์กร) |
Request Body Example
{
"employee_code": "EMP001",
"year_month": "2026-03",
"withdraw_amt": 2000.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": "N",
"withdraw_dt": "2026-03-24",
"is_auto_approve": false
}
}Response Fields
| Field | Type | Description |
|---|---|---|
employee_withdraw_doc_id | string | รหัสเอกสารที่ถูกสร้างขึ้นใหม่ |
employee_id | string | รหัสพนักงาน |
withdraw_amt | string | จำนวนเงินที่บันทึกลงในเอกสาร |
approve_flag | string | สถานะเริ่มต้น (N = รอการอนุมัติ) |
withdraw_dt | string | วันที่ยื่นคำขอ (YYYY-MM-DD) |
is_auto_approve | boolean | ระบุว่ามีการอนุมัติอัตโนมัติหรือไม่ |
Error Response - Over Limit (HTTP 400)
{
"code": 400,
"message": "จำนวนเงินเกินวงเงินที่สามารถเบิกได้"
}Error Response - No Consent (HTTP 400)
{
"code": 400,
"message": "กรุณาให้ความยินยอมการเบิกเงินล่วงหน้าก่อนทำรายการ"
}Code Examples
cURL
curl -X POST "https://openapi.humansoft.co.th/api/v1/open-apis/withdraw/submit" \
-H "Ocp-Apim-Subscription-Key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"employee_code": "EMP001",
"year_month": "2026-03",
"withdraw_amt": 2000.00
}'Notes
ข้อควรทราบ:
- หากบริษัทมีการตั้งค่า Auto Approve เอกสารจะถูกปรับสถานะเป็น
Yทันทีหลัง Submit - การส่งค่า
withdraw_amtควรเป็นตัวเลขที่มีทศนิยมไม่เกิน 2 ตำแหน่ง - กรณี Split Round หากไม่ส่ง
master_salary_split_seqระบบจะพยายามค้นหางวดปัจจุบันตามวันที่ทำรายการ - ใช้ API Get Detail เพื่อตรวจสอบวงเงินคงเหลือ (
available) ก่อนส่งคำขอ
Related APIs
- Get Detail - ตรวจสอบวงเงินคงเหลือก่อนส่งคำขอ
- Get Month - ดูรายการเดือนที่เปิดให้เบิกได้
Last updated on