Skip to Content
🚀 Welcome to Humansoft Open API Documentation

Update Withdraw

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

Endpoint

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

Request Parameters

Required Parameters

ParameterTypeRequiredDescriptionExample
employee_withdraw_doc_idstring (base64)Yesรหัสเอกสารที่ต้องการแก้ไข (Base64)"MjAyNjAzMTJXREQwMDAwMDAwMQ=="
withdraw_amtfloatYesยอดเงินใหม่ที่ต้องการระบุลงในเอกสาร1500.00
withdraw_dtstringYesวันที่ทำรายการใหม่ (YYYY-MM-DD)"2026-03-24"

Optional Parameters

ParameterTypeDefaultDescriptionExample
charge_employee_amtfloat0.00แก้ไขค่าธรรมเนียมฝั่งพนักงาน10.00
charge_company_amtfloat0.00แก้ไขค่าธรรมเนียมฝั่งบริษัท0.00

Validation Rules

กฎรายละเอียด
Status Checkเอกสารต้องมีสถานะไม่ใช่ Y (Approved) หรือ C (Cancelled)
Amount Validationจำนวนเงินใหม่ต้องไม่เกินโควตาสูงสุดที่พนักงานมีสิทธิ์ในรอบเดือนนั้น
ID Decodingระบบจะถอดรหัส Base64 ก่อนนำรหัสไปค้นหา หากค้นหาไม่พบจะแจ้ง Error

Request Body Example

{ "employee_withdraw_doc_id": "MjAyNjAzMTJXREQwMDAwMDAwMQ==", "withdraw_amt": 1500.00, "withdraw_dt": "2026-03-24", "charge_employee_amt": 10.00 }

Response Format

Success Response (HTTP 200)

{ "code": 200, "message": "แก้ไขข้อมูลสำเร็จ", "payload": { "employee_withdraw_doc_id": "20260312WDD00000001", "employee_id": "20260309462FEF65EFCA", "withdraw_amt": "1500.00", "charge_employee_amt": "10.00", "charge_company_amt": "0.00", "withdraw_dt": "2026-03-24" } }

Response Fields

FieldTypeDescription
employee_withdraw_doc_idstringรหัสเอกสารที่ถูกแก้ไข
employee_idstringรหัสพนักงาน
withdraw_amtstringยอดเงินใหม่ที่ถูกอัปเดต
charge_employee_amtstringยอดค่าธรรมเนียมฝั่งพนักงานที่อัปเดต
charge_company_amtstringยอดค่าธรรมเนียมฝั่งบริษัทที่อัปเดต
withdraw_dtstringวันที่ทำรายการที่อัปเดต

Error Response - Cannot Edit Approved Document (HTTP 400)

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

Error Response - Over Limit (HTTP 400)

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

Code Examples

curl -X POST "https://openapi.humansoft.co.th/api/v1/open-apis/withdraw/update" \ -H "Ocp-Apim-Subscription-Key: YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "employee_withdraw_doc_id": "MjAyNjAzMTJXREQwMDAwMDAwMQ==", "withdraw_amt": 1500.00, "withdraw_dt": "2026-03-24", "charge_employee_amt": 10.00 }'

Notes

ข้อควรทราบ:

  • สามารถแก้ไขได้เฉพาะเอกสารที่ยังไม่ถูกอนุมัติหรือยกเลิก
  • เมื่อมีการแก้ไขจำนวนเงิน (withdraw_amt) ระบบจะตรวจสอบวงเงินโควตาใหม่ทั้งหมด
  • employee_withdraw_doc_id ต้องเข้ารหัส Base64
  • Approve - อนุมัติเอกสารหลังจากแก้ไขข้อมูลเสร็จสิ้น
  • Delete - ลบเอกสารแทนการแก้ไข
Last updated on