Skip to Content
🚀 Welcome to Humansoft Open API Documentation

Save Withdraw (HR Override)

อนุมัติเอกสารเบิกเงินล่วงหน้าโดย HR แบบ Manual Override พร้อมสามารถปรับปรุงยอดเงินจริงที่จะจ่ายให้พนักงานได้ ระบบจะบังคับเปลี่ยนสถานะเอกสารเป็น Y (Approved) ทันทีหลังบันทึกสำเร็จ

Endpoint

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

Request Parameters

Required Parameters

ParameterTypeRequiredDescriptionExample
employee_withdraw_doc_idstring (base64)Yesรหัสเอกสาร (ต้องเข้ารหัส Base64)"MjAyNjAzMTJXREQwMDAwMDAwMQ=="
approve_amtfloatYesจำนวนเงินที่ HR อนุมัติให้เบิกจริง (ต้อง >= 0)1800.00

Optional Parameters

ParameterTypeDefaultDescriptionExample
approve_dtstring(วันนี้)วันที่ทำการอนุมัติ (YYYY-MM-DD)"2026-03-24"
approve_remarkstring""เหตุผลหรือหมายเหตุประกอบการแก้ไขยอด"ปรับลดยอดเบิกให้ตามวงเงินคงเหลือจริง"

Validation Rules

กฎรายละเอียด
ID Encodingemployee_withdraw_doc_id ต้องเข้ารหัส Base64
Amount Logicapprove_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

FieldTypeDescription
employee_withdraw_doc_idstringรหัสเอกสาร
employee_idstringรหัสพนักงาน
withdraw_amtstringยอดเงินที่ได้รับอนุมัติจริง
approve_flagstringสถานะหลังการอัปเดต (Y)
approve_remarkstringหมายเหตุการอนุมัติ
approve_dtstringวันที่อนุมัติ

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 -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
  • Approve - อนุมัติตามขั้นตอนปกติ
  • Get Detail - ตรวจสอบยอดที่พนักงานขอมาก่อนทำการปรับปรุง
Last updated on