Salary Certificate API Module

ภาพรวม (Overview)

โมดูล Salary Certificate เป็น API สำหรับจัดการหนังสือรับรองเงินเดือนของพนักงาน รวมถึงการสร้างคำขอ การอนุมัติ การส่งออก PDF และการนำเข้าข้อมูลจำนวนมาก

Salary Certificate คืออะไร?

Salary Certificate (หนังสือรับรองเงินเดือน) คือเอกสารรับรองจากบริษัทว่าพนักงานทำงานอยู่จริง พร้อมระบุเงินเดือนและระยะเวลาการทำงาน ใช้ประกอบการยื่นเรื่องต่าง ๆ เช่น:

• ยื่นกู้สินเชื่อธนาคาร - ใช้เป็นหลักฐานรายได้
• สมัครบัตรเครดิต - ใช้ยืนยันรายได้
• ยื่นวีซ่า - ใช้ประกอบการขอวีซ่า (รองรับภาษาอังกฤษ)
• เอกสารทางราชการ - ใช้ยื่นต่อหน่วยงานต่าง ๆ

API Endpoints (8 endpoints)

Operations (จัดการเอกสาร)

Submit

สร้างคำขอหนังสือรับรองเงินเดือนใหม่

Use Cases:

• พนักงานสร้างคำขอเอกสาร
• HR สร้างคำขอแทนพนักงาน

Approve

อนุมัติหรือปฏิเสธคำขอหนังสือรับรองเงินเดือน รองรับ Multi-Level Approval สูงสุด 5 ขั้น

Use Cases:

• หัวหน้าอนุมัติคำขอ
• HR อนุมัติขั้นสุดท้าย
• ส่งกลับให้แก้ไข (Recheck)

Delete

ลบคำขอหนังสือรับรองเงินเดือนที่ยังไม่ได้อนุมัติ

Use Cases:

• ยกเลิกคำขอที่ไม่ต้องการ
• ลบคำขอที่สร้างผิดพลาด

Export PDF

สร้างไฟล์ PDF ของหนังสือรับรองเงินเดือน

Use Cases:

• ดาวน์โหลด PDF เพื่อพิมพ์เอกสาร
• แสดง PDF ในเบราว์เซอร์ (Inline)
• สร้าง PDF สำหรับ Mobile App

Import (Bulk)

นำเข้าคำขอหนังสือรับรองเงินเดือนหลายรายการพร้อมกัน

Use Cases:

• สร้างคำขอจำนวนมากพร้อมกัน
• นำเข้าข้อมูลจากระบบภายนอก

Query (ดึงข้อมูล)

Get Detail

ดึงรายละเอียดเอกสารหนังสือรับรองเงินเดือนตาม ID

Use Cases:

• แสดงหน้ารายละเอียดเอกสาร
• ตรวจสอบสถานะเอกสาร
• ดูข้อมูลผู้อนุมัติ

Get List

ดึงรายการเอกสารหนังสือรับรองเงินเดือนทั้งหมด พร้อมตัวกรองและการแบ่งหน้า

Use Cases:

• แสดงรายการเอกสารบน Dashboard
• กรองเอกสารตามสถานะ/ช่วงเวลา
• ติดตามสถานะการอนุมัติ

Get Signatures

ดึงรายการลายเซ็นที่ใช้ในเอกสารหนังสือรับรองเงินเดือน

Use Cases:

• แสดง dropdown เลือกลายเซ็น
• ตรวจสอบลายเซ็นที่พร้อมใช้งาน

Document Flow (สถานะเอกสาร)

Document Language (ภาษาเอกสาร)

Standard Response Format

Success Response

{
  "code": 200,
  "message": "สำเร็จ",
  "payload": { ... }
}

Error Response

{
  "code": 400,
  "message": "ไม่สำเร็จ",
  "error": "Error message"
}

Validation Error Response

{
  "code": 422,
  "message": "Validation failed",
  "errors": [
    "Missing required parameter: 'employee_code'"
  ]
}

หมายเหตุสำคัญ

1. ID Encoding - ฟิลด์ที่ลงท้ายด้วย _id ใน request ต้องเข้ารหัส Base64 ส่วนใน response จะเป็น plain text 20 ตัวอักษร

2. Bilingual Support - รองรับเอกสารทั้งภาษาไทยและอังกฤษ ข้อมูลพนักงาน ตำแหน่ง และองค์กรจะเปลี่ยนตามภาษาที่เลือก

3. Multi-Level Approval - รองรับการอนุมัติสูงสุด 5 ขั้น ตามสายการอนุมัติที่กำหนด

4. Quota System - อาจมีการจำกัดจำนวนครั้งที่สามารถขอเอกสารในแต่ละรอบเงินเดือน

5. Salary Calculation - ระบบจะคำนวณเงินเดือนรวมอัตโนมัติจากเงินเดือนพื้นฐานและค่าตอบแทนคงที่ที่เกี่ยวข้อง