Withdraw API Module

ภาพรวม (Overview)

โมดูล Withdraw เป็น API สำหรับจัดการระบบเบิกเงินล่วงหน้า (Advance Withdraw) ครอบคลุมตั้งแต่การสร้างคำขอเบิกเงิน การอนุมัติ/ปฏิเสธ การแก้ไขยอดเงิน การติดตามวงเงินโควตา ไปจนถึงการดูประวัติรายการเบิกย้อนหลัง รองรับทั้งการจ่ายเงินเดือนแบบเต็มเดือน (Full Month) และแบบแบ่งจ่ายรายงวด (Split Round)

ขั้นตอนการทำงาน (Workflow)

ตรวจสอบเดือนที่เปิดให้เบิก - ดึงรายการเดือนที่สามารถเบิกได้ผ่าน Get Month
ตรวจสอบวงเงิน - ดูวงเงินคงเหลือของพนักงานผ่าน Get Detail หรือ Get Detail Split
สร้างคำขอเบิก - พนักงานยื่นคำขอเบิกเงินล่วงหน้าผ่าน Submit
อนุมัติ/ปฏิเสธ - หัวหน้างานหรือ HR พิจารณาผ่าน Approve หรือ Reject
ติดตามรายการ - ดูรายการเบิกทั้งหมดผ่าน Get List หรือ Get List By Month

API Endpoints

Operations

Endpoint	Method	รายละเอียด
Submit	POST	สร้างคำขอเบิกเงินล่วงหน้า
Approve	POST	อนุมัติเอกสารเบิกเงิน
Reject	POST	ปฏิเสธเอกสารเบิกเงิน
Save	POST	อนุมัติแบบ HR Override พร้อมปรับยอดเงิน
Update	POST	แก้ไขข้อมูลเอกสารเบิกเงิน
Delete	POST	ลบเอกสารเบิกเงิน
Reactive	POST	สร้างรายการหักเงินเดือนใหม่สำหรับเอกสารที่อนุมัติแล้ว

Query

Endpoint	Method	รายละเอียด
Get Detail	GET/POST	ดูรายละเอียดวงเงินและประวัติการเบิก
Get Detail Split	GET/POST	ดูรายละเอียดวงเงินแบบแบ่งตามงวด (Split Round)
Get List	GET/POST	ดูรายการเอกสารเบิกเงินแบบมีตัวกรอง
Get List By Month	GET/POST	ดูรายการเบิกเงินประจำเดือนสำหรับ HR
Get Month	GET/POST	ดูรายการเดือนที่เปิดให้เบิกเงินล่วงหน้า

Document Status Values (`approve_flag`)

ค่า	ความหมาย (EN)	ความหมาย (TH)
`N`	Pending	รออนุมัติ
`Y`	Approved	อนุมัติแล้ว
`R`	Rejected	ปฏิเสธ
`C`	Cancelled	ยกเลิก

Split Round Support

สำหรับบริษัทที่มีการจ่ายเงินเดือนหลายรอบต่อเดือน (เช่น จ่ายทุกวันที่ 15 และสิ้นเดือน) สามารถใช้พารามิเตอร์ master_salary_split_seq ในการระบุงวดที่ต้องการตรวจสอบหรือเบิกเงินได้

ใช้ Get Detail Split เพื่อตรวจสอบวงเงินแต่ละงวด
ส่ง master_salary_split_seq ใน Submit เพื่อระบุงวดที่ต้องการเบิก