Work Certificate API Module
ภาพรวม (Overview)
โมดูล Work Certificate เป็น API สำหรับจัดการเอกสารหนังสือรับรองการทำงาน ครอบคลุมการยื่นคำขอ การอนุมัติแบบหลายขั้น (Multi-Level Approval สูงสุด 5 ขั้น) การแก้ไข การลบ การส่งออก PDF และการนำเข้าข้อมูลจำนวนมาก รองรับเอกสารทั้งภาษาไทยและภาษาอังกฤษ
หนังสือรับรองการทำงาน ไม่มีข้อมูลเงินเดือน หากต้องการหนังสือรับรองเงินเดือน ให้ใช้ Salary Certificate แทน
สถานะเอกสาร (Document Flow)
| Code | ความหมาย (TH) | ความหมาย (EN) |
|---|---|---|
01 | รออนุมัติ | Pending Approval |
02 | อนุมัติแล้ว | Approved |
03 | ไม่อนุมัติ | Not Approved |
04 | ส่งเอกสารแล้ว | Sent Document |
05 | ได้รับเอกสารแล้ว | Receive Document |
06 | ตรวจสอบอีกครั้ง | Recheck |
07-11 | หัวหน้าอนุมัติขั้นที่ 1-5 | Manager Approved Level 1-5 |
API Endpoints (9 endpoints)
ยื่นเอกสาร
Submit
สร้างเอกสารขอหนังสือรับรองการทำงานใหม่
Use Cases:
- พนักงานต้องการหนังสือรับรองการทำงานเพื่อใช้สมัครงาน
- พนักงานต้องการหนังสือรับรองเพื่อยื่นวีซ่า
- พนักงานต้องการหนังสือรับรองเพื่อเอกสารทางราชการ
Import (Bulk)
นำเข้าเอกสารหนังสือรับรองการทำงานหลายรายการพร้อมกัน
Use Cases:
- HR นำเข้าคำขอจำนวนมากพร้อมกัน
- สร้างเอกสารให้พนักงานหลายคนในครั้งเดียว
จัดการสถานะ
Approve
อนุมัติหรือปฏิเสธเอกสารหนังสือรับรองการทำงาน
Use Cases:
- หัวหน้างานอนุมัติคำขอของพนักงาน
- ปฏิเสธคำขอพร้อมระบุเหตุผล
- อนุมัติแบบหลายขั้น (Multi-Level Approval)
Update
แก้ไขเอกสารหนังสือรับรองการทำงาน
Use Cases:
- แก้ไขวัตถุประสงค์หรือที่อยู่จัดส่ง
- เปลี่ยนภาษาเอกสาร
- เปลี่ยนสถานะเอกสาร
Delete
ลบเอกสารหนังสือรับรองการทำงาน
Use Cases:
- ลบเอกสารที่สร้างผิดพลาด
- ลบเอกสารที่ยังไม่ได้อนุมัติ
การลบข้อมูลไม่สามารถกู้คืนได้ และไม่สามารถลบเอกสารที่อนุมัติแล้วได้
ส่งออกเอกสาร
Export PDF
สร้างไฟล์ PDF ของเอกสารหนังสือรับรองการทำงาน
Use Cases:
- สร้าง PDF เพื่อดาวน์โหลดหรือแสดงผลในเบราว์เซอร์
- สร้าง PDF สำหรับ Mobile App
ดึงข้อมูล
Get Detail
ดึงรายละเอียดเอกสารหนังสือรับรองการทำงานเดียว
Use Cases:
- แสดงหน้ารายละเอียดเอกสาร
- ตรวจสอบสถานะและสิทธิ์การอนุมัติ
Get List
ดึงรายการเอกสารหนังสือรับรองการทำงานทั้งหมด
Use Cases:
- แสดง Dashboard รายการเอกสาร
- กรองตามสถานะ โครงสร้างองค์กร หรือช่วงเวลา
Get Signatures
ดึงรายการลายเซ็นที่ใช้ในเอกสาร
Use Cases:
- แสดงรายการลายเซ็นที่สามารถเลือกใช้ได้
- ดูข้อมูลลายเซ็นก่อนอนุมัติ
Related APIs
- Document Overview - ภาพรวมโมดูลเอกสารทั้งหมด