Petty Cash API Module

ภาพรวม (Overview)

โมดูล Petty Cash เป็น API สำหรับจัดการระบบเบิกเงินสดย่อย (Petty Cash) ครอบคลุมตั้งแต่การสร้างเอกสารคำขอเบิก เพิ่มรายการค่าใช้จ่าย การอนุมัติหลายระดับ การติดตามสถานะเอกสาร ไปจนถึงการจัดการประเภทค่าใช้จ่าย

สิทธิ์ที่ต้องการ: API Key ต้องมีสิทธิ์ ข้อมูลการยื่นเอกสาร (document:manage) จึงจะเรียกใช้ API ในโมดูลนี้ได้

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

สร้างเอกสาร - พนักงานยื่นคำขอเบิกเงินสดย่อยผ่าน Submit
เพิ่มรายการค่าใช้จ่าย - เพิ่มรายละเอียดค่าใช้จ่ายผ่าน Add Item
อนุมัติ - หัวหน้างานหรือ HR พิจารณาอนุมัติผ่าน Approve
ตั้งเบิกและรับเงิน - เอกสารที่อนุมัติแล้ว (02) เปลี่ยนเป็นตั้งเบิกแล้ว (04) โดยเรียก Approve ด้วย 02 อีกครั้งโดยผู้ที่ผลการอนุมัติเป็น 02 (เช่น ฝ่ายบุคคล) ส่วนเอกสารที่บันทึกเข้างวดเงินเดือน (12) เปลี่ยนเป็น 04 หรือ 05 ผ่าน Update Status — การเปลี่ยนเป็น 04 ผู้ทำรายการต้องมีสิทธิ์ตั้งเบิก (ตรวจได้จาก field send_doc)

API Endpoints

Core Operations

Endpoint	Method	รายละเอียด
Submit	POST	สร้างเอกสารคำขอเบิกเงินสดย่อย
Add Item	POST	เพิ่มรายการค่าใช้จ่ายในเอกสาร
Get Detail	GET	ดูรายละเอียดเอกสาร
Get List	GET	ดูรายการเอกสารของพนักงาน
Search List	POST	ค้นหาเอกสารสำหรับ HR/ผู้อนุมัติ
Approve	POST	อนุมัติ/ไม่อนุมัติเอกสาร
Update Status	POST	อัปเดตสถานะเอกสาร
Delete	POST	ลบเอกสาร
Delete Item	POST	ลบรายการค่าใช้จ่ายในเอกสาร

Expense Type Management

Endpoint	Method	รายละเอียด
List Types	GET	ดูรายการประเภทค่าใช้จ่าย
Create Type	POST	สร้างประเภทค่าใช้จ่ายใหม่
Update Type	POST	แก้ไขประเภทค่าใช้จ่าย
Delete Type	POST	ลบประเภทค่าใช้จ่าย

Document Status Values (`petty_cash_type_lv`)

ค่า	ความหมาย (EN)	ความหมาย (TH)
`01`	Pending	รออนุมัติ
`02`	Withdrawing	กำลังตั้งเบิก (อนุมัติขั้นสุดท้ายแล้ว)
`03`	Not Approved	ไม่อนุมัติ
`04`	Withdrew	ตั้งเบิกแล้ว
`05`	Received	ได้รับเงินแล้ว
`06`	Recheck	ตรวจสอบอีกครั้ง
`07`	Manager Approved	หัวหน้าอนุมัติ (ขั้นที่ 1)
`08`	Manager Approved	หัวหน้าอนุมัติ (ขั้นที่ 2)
`09`	Manager Approved	หัวหน้าอนุมัติ (ขั้นที่ 3)
`10`	Manager Approved	หัวหน้าอนุมัติ (ขั้นที่ 4)
`11`	Manager Approved	หัวหน้าอนุมัติ (หัวหน้าลำดับสุดท้ายในสายอนุมัติ รอฝ่ายบุคคลอนุมัติ)
`12`	Approved	อนุมัติ (บันทึกเข้างวดเงินเดือน)

สถานะเอกสาร Petty Cash มีความซับซ้อนกว่าเอกสารทั่วไป เนื่องจากรองรับการอนุมัติหลายระดับ (สูงสุด 5 ขั้น) และมีขั้นตอนการส่งเอกสาร/รับเงินเพิ่มเติม

พารามิเตอร์ที่ลงท้ายด้วย _id ต้องส่งเป็น Base64-encoded

Response จะ return raw string ID (เช่น 20251127D4573C421639)
เมื่อนำ ID จาก response ไปใช้ใน request ถัดไป ต้อง encode เป็น Base64 ก่อน

Document Overview - ภาพรวมโมดูลเอกสาร
Employee - จัดการข้อมูลพนักงาน
Organization - จัดการโครงสร้างองค์กร