Petty Cash API Module

ภาพรวม (Overview)

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

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

สร้างเอกสาร - พนักงานยื่นคำขอเบิกเงินสดย่อยผ่าน Submit
เพิ่มรายการค่าใช้จ่าย - เพิ่มรายละเอียดค่าใช้จ่ายผ่าน Add Item
อนุมัติ - หัวหน้างานหรือ HR พิจารณาอนุมัติผ่าน Approve
อัปเดตสถานะ - ติดตามการส่งเอกสารและรับเงินผ่าน Update Status

API Endpoints

Core Operations

Endpoint	Method	รายละเอียด
Submit	POST	สร้างเอกสารคำขอเบิกเงินสดย่อย
Add Item	POST	เพิ่มรายการค่าใช้จ่ายในเอกสาร
Get Detail	GET/POST	ดูรายละเอียดเอกสาร
Get List	GET/POST	ดูรายการเอกสารของพนักงาน
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 Level 1	หัวหน้าอนุมัติขั้นที่ 1
`08`	Manager Approved Level 2	หัวหน้าอนุมัติขั้นที่ 2
`09`	Manager Approved Level 3	หัวหน้าอนุมัติขั้นที่ 3
`10`	Manager Approved Level 4	หัวหน้าอนุมัติขั้นที่ 4
`11`	Manager Approved Level 5	หัวหน้าอนุมัติขั้นที่ 5
`12`	Approved	อนุมัติแล้ว

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

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

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

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