Skip to Content
🚀 Welcome to Humansoft Open API Documentation

Submit Withdraw

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

Endpoint

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

Request Parameters

Required Parameters

ParameterTypeRequiredDescriptionExample
employee_codestringYesรหัสพนักงานที่ต้องการสร้างเอกสาร"EMP001"
year_monthstringYesเดือนของรอบเงินเดือนที่ต้องการขอเบิก (YYYY-MM)"2026-03"
withdraw_amtfloatYesจำนวนเงินที่ต้องการขอเบิก (ต้องเป็นบวก)2000.00

Optional Parameters

ParameterTypeDefaultDescriptionExample
master_salary_split_seqintnullลำดับงวด (เฉพาะกรณีบริษัทเปิดใช้ 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

FieldTypeDescription
employee_withdraw_doc_idstringรหัสเอกสารที่ถูกสร้างขึ้นใหม่
employee_idstringรหัสพนักงาน
withdraw_amtstringจำนวนเงินที่บันทึกลงในเอกสาร
approve_flagstringสถานะเริ่มต้น (N = รอการอนุมัติ)
withdraw_dtstringวันที่ยื่นคำขอ (YYYY-MM-DD)
is_auto_approvebooleanระบุว่ามีการอนุมัติอัตโนมัติหรือไม่

Error Response - Over Limit (HTTP 400)

{ "code": 400, "message": "จำนวนเงินเกินวงเงินที่สามารถเบิกได้" }
{ "code": 400, "message": "กรุณาให้ความยินยอมการเบิกเงินล่วงหน้าก่อนทำรายการ" }

Code Examples

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) ก่อนส่งคำขอ
  • Get Detail - ตรวจสอบวงเงินคงเหลือก่อนส่งคำขอ
  • Get Month - ดูรายการเดือนที่เปิดให้เบิกได้
Last updated on