Document API Module
ภาพรวม (Overview)
โมดูล Document เป็น API สำหรับจัดการเอกสารต่างๆ ของพนักงานในองค์กร ครอบคลุมระบบร้องเรียน การเบิกเงินสดย่อย การลาออก หนังสือรับรอง สวัสดิการ และการเบิกเงินล่วงหน้า ทุกเอกสารรองรับระบบ Approval Workflow สำหรับการอนุมัติหลายระดับ
โครงสร้าง API
โมดูล Document แบ่งออกเป็น 8 กลุ่ม API ตามประเภทเอกสาร:
Complaint (ร้องเรียน)
ระบบจัดการเรื่องร้องเรียนของพนักงาน รองรับการยื่น ตรวจสอบ อนุมัติ และติดตามสถานะเรื่องร้องเรียน
API Endpoints:
| Endpoint | รายละเอียด |
|---|---|
| Submit | ยื่นเรื่องร้องเรียนใหม่ |
| Get List | ดูรายการเรื่องร้องเรียน |
| Get Detail | ดูรายละเอียดเรื่องร้องเรียน |
| Approve | อนุมัติเรื่องร้องเรียน |
| Update Status | อัปเดตสถานะเรื่องร้องเรียน |
| Delete | ลบเรื่องร้องเรียน |
Petty Cash (เบิกเงินสดย่อย)
ระบบจัดการการเบิกเงินสดย่อย รองรับการสร้างเอกสาร เพิ่มรายการค่าใช้จ่าย อนุมัติ และจัดการประเภทค่าใช้จ่าย
API Endpoints:
| หมวด | Endpoints | รายละเอียด |
|---|---|---|
| Core Operations | 9 endpoints | สร้าง, เพิ่มรายการ, ดูข้อมูล, อนุมัติ, อัปเดต, ลบ |
| Expense Type | 4 endpoints | จัดการประเภทค่าใช้จ่าย (ดู, สร้าง, แก้ไข, ลบ) |
Resign (ลาออก)
ระบบจัดการเอกสารลาออกของพนักงาน รองรับการยื่น อนุมัติจากหัวหน้า อนุมัติจาก HR และดูข้อมูลก่อนออกจากงาน
API Endpoints:
| Endpoint | รายละเอียด |
|---|---|
| Submit | ยื่นเอกสารลาออก |
| Approve | อนุมัติเอกสารลาออก |
| HR Approve | HR ยืนยันการลาออก |
| Update | แก้ไขเอกสารลาออก |
| Delete | ลบเอกสารลาออก |
| Get Detail | ดูรายละเอียดเอกสาร |
| Get List | ดูรายการเอกสารลาออก |
| Get List Filter | ค้นหาเอกสารลาออก |
| Get Before Sign Out | ดูข้อมูลพนักงานก่อนออกจากงาน |
Salary Certificate (หนังสือรับรองเงินเดือน)
ระบบจัดการหนังสือรับรองเงินเดือน รองรับการขอ อนุมัติหลายระดับ (สูงสุด 5 ขั้น) ส่งออก PDF นำเข้าแบบ Bulk และจัดการลายเซ็น
API Endpoints:
| Endpoint | รายละเอียด |
|---|---|
| Submit | ขอหนังสือรับรองเงินเดือน |
| Approve | อนุมัติหนังสือรับรอง |
| Delete | ลบหนังสือรับรอง |
| Export PDF | ส่งออกเป็นไฟล์ PDF |
| Get Detail | ดูรายละเอียดเอกสาร |
| Get List | ดูรายการเอกสาร |
| Get Signatures | ดูรายการลายเซ็น |
| Import | นำเข้าเอกสารหลายรายการ |
Visa Certificate (หนังสือรับรองวีซ่า)
ระบบจัดการหนังสือรับรองวีซ่า รองรับการขอ แก้ไข อนุมัติ ส่งออก PDF และนำเข้าแบบ Bulk
API Endpoints:
| Endpoint | รายละเอียด |
|---|---|
| Submit | ขอหนังสือรับรองวีซ่า |
| Approve | อนุมัติหนังสือรับรอง |
| Update | แก้ไขเอกสาร |
| Delete | ลบเอกสาร |
| Export PDF | ส่งออกเป็นไฟล์ PDF |
| Get Detail | ดูรายละเอียดเอกสาร |
| Get List | ดูรายการเอกสาร |
| Get Signatures | ดูรายการลายเซ็น |
| Import | นำเข้าเอกสารหลายรายการ |
Work Certificate (หนังสือรับรองการทำงาน)
ระบบจัดการหนังสือรับรองการทำงาน รองรับการขอ แก้ไข อนุมัติ ส่งออก PDF และนำเข้าแบบ Bulk
API Endpoints:
| Endpoint | รายละเอียด |
|---|---|
| Submit | ขอหนังสือรับรองการทำงาน |
| Approve | อนุมัติหนังสือรับรอง |
| Update | แก้ไขเอกสาร |
| Delete | ลบเอกสาร |
| Export PDF | ส่งออกเป็นไฟล์ PDF |
| Get Detail | ดูรายละเอียดเอกสาร |
| Get List | ดูรายการเอกสาร |
| Get Signatures | ดูรายการลายเซ็น |
| Import | นำเข้าเอกสารหลายรายการ |
Welfare (สวัสดิการ)
ระบบจัดการสวัสดิการพนักงาน ครอบคลุมการเบิกสวัสดิการ กำหนดโควตา ติดตามยอดคงเหลือ นำเข้า Excel และจัดการวันจ่ายเงิน
API Endpoints:
| หมวด | Endpoints | รายละเอียด |
|---|---|---|
| Document | 8 endpoints | ยื่น, แก้ไข, ลบ, อนุมัติ, ตรวจสอบซ้ำ, ดูรายการ |
| Employee Config | 6 endpoints | กำหนดโควตาสวัสดิการต่อพนักงาน |
| Log | 3 endpoints | บันทึกการใช้สวัสดิการ |
| Balance | 3 endpoints | ตรวจสอบยอดคงเหลือ |
| Group View | 2 endpoints | ดูข้อมูลแบบกลุ่มตามพนักงาน |
| Import | 4 endpoints | นำเข้า Excel |
| Payout | 1 endpoint | จัดการวันจ่ายเงิน |
Withdraw (เบิกเงินล่วงหน้า)
ระบบจัดการการเบิกเงินล่วงหน้า รองรับการยื่นคำขอ อนุมัติ ปฏิเสธ ตรวจสอบโควตา และดูรายการเบิกตามรอบเงินเดือน
API Endpoints:
| Endpoint | รายละเอียด |
|---|---|
| Submit | ยื่นคำขอเบิกเงินล่วงหน้า |
| Approve | อนุมัติการเบิกเงิน |
| Reject | ปฏิเสธการเบิกเงิน |
| Save | HR อนุมัติพร้อมกำหนดยอด |
| Update | แก้ไขคำขอเบิกเงิน |
| Delete | ลบคำขอเบิกเงิน |
| Reactive | สร้างรายการใหม่สำหรับเอกสารที่อนุมัติแล้ว |
| Get Detail | ดูโควตาและประวัติการเบิก |
| Get Detail Split | ดูโควตาแยกตามรอบจ่าย |
| Get List | ดูรายการเบิกเงิน |
| Get List By Month | ดูรายการเบิกรายเดือน |
| Get Month | ดูเดือนที่เปิดให้เบิกเงิน |
Standard Response Format
Success Response
{
"code": 200,
"message": "สำเร็จ",
"payload": { ... }
}Error Response
{
"code": 400,
"message": "ไม่สำเร็จ",
"errors": ["รายละเอียดข้อผิดพลาด"]
}Common Parameters
Pagination Parameters
บาง API รองรับการแบ่งหน้า:
| Parameter | Type | Default | Description |
|---|---|---|---|
_PAGE | number | 1 | หน้าที่ต้องการดึงข้อมูล |
_NUMBER_PER_PAGE | number | 20 | จำนวนรายการต่อหน้า |
Organization Filter Parameters
API หลายตัวรองรับการกรองตามโครงสร้างองค์กร:
| Parameter | Type | Description |
|---|---|---|
company_lists | array | กรองตามบริษัท |
branch_lists | array | กรองตามสาขา |
department_lists | array | กรองตามแผนก |
division_lists | array | กรองตามฝ่าย |
section_lists | array | กรองตามหน่วยงาน |
position_lists | array | กรองตามตำแหน่ง |
employee_lists | array | กรองตามพนักงาน |
Document Status
เอกสารส่วนใหญ่มีระบบสถานะการอนุมัติ:
| Status | Description |
|---|---|
01 | รออนุมัติ (Pending) |
02 | อนุมัติแล้ว (Approved) |
03 | ไม่อนุมัติ (Rejected) |
04 | ส่งเอกสารแล้ว (Sent) |
05 | รับเอกสารแล้ว (Received) |
06 | ตรวจสอบอีกครั้ง (Recheck) |
07-11 | หัวหน้าขั้นที่ 1-5 (Manager Level 1-5) |
สถานะเอกสารอาจแตกต่างกันในแต่ละโมดูล ดูรายละเอียดในหน้า Overview ของแต่ละ Sub-module
Related APIs
- Employee - จัดการข้อมูลพนักงาน
- Salary - จัดการเงินเดือนและเวลาทำงาน
- Organization - จัดการโครงสร้างองค์กร