Resign API Module

ภาพรวม (Overview)

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

API Endpoints (9 endpoints)

Operations

Submit Resign

ยื่นคำขอสร้างเอกสารลาออกใหม่

Use Cases:

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

Approve

อนุมัติ ปฏิเสธ หรือส่งกลับเอกสารลาออก

Use Cases:

• หัวหน้าอนุมัติเอกสารลาออก
• ปฏิเสธหรือส่งกลับเพื่อตรวจสอบอีกครั้ง

HR Approve

HR ยืนยันหรือยกเลิกการลาออก

Use Cases:

• HR ยืนยันการลาออกและอัปเดตข้อมูลพนักงาน
• HR ยกเลิกการลาออก

Update

แก้ไขเอกสารลาออกที่ยังรออนุมัติ

Use Cases:

• แก้ไขวันที่มีผลลาออก
• เปลี่ยนสาเหตุหรือหมายเหตุ

Delete

ลบเอกสารลาออก

Use Cases:

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

Query

Get Detail

ดึงรายละเอียดเอกสารลาออก

Use Cases:

• ดูรายละเอียดเอกสารก่อนอนุมัติ
• ตรวจสอบสถานะเอกสาร

Get List

ดึงรายการเอกสารลาออกสำหรับ HR/Manager

Use Cases:

• แสดงรายการเอกสารที่รออนุมัติ
• ดูภาพรวมการลาออกตามแผนก

Get List Filter

ดึงรายการเอกสารลาออกแบบมีเงื่อนไขกรอง

Use Cases:

• กรองเอกสารตามโครงสร้างองค์กร
• ค้นหาเอกสารตามช่วงเวลา

Get Before Sign Out

ดึงข้อมูลพนักงานก่อนยืนยันการลาออก

Use Cases:

• ตรวจสอบข้อมูลเงินกู้ กองทุน วันหยุดคงเหลือก่อนยืนยัน
• ดูสรุปข้อมูลพนักงานสำหรับ HR

Approve Status (สถานะการอนุมัติ)

HR Approve Status (สถานะ HR)

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": [
    "'employee_code' is required",
    "'resign_doc_dt' must be YYYY-MM-DD"
  ]
}

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

1. Approval Workflow - เอกสารลาออกต้องผ่านการอนุมัติตามลำดับขั้นจนถึง HR ยืนยัน

2. Base64 Encoding - พารามิเตอร์ ID ทั้งหมด (resign_doc_id, authorize_id) ต้องเข้ารหัส Base64 ก่อนส่ง

3. Employee Code - ระบบรับ employee_code เท่านั้น และจะแปลงเป็น employee_id ภายในอัตโนมัติ

4. Payroll Period - การอนุมัติเอกสารจะตรวจสอบว่าวันที่ลาออกไม่อยู่ในงวดเงินเดือนที่ปิดแล้ว

Related APIs

• Time Leave - จัดการการลา
• Overtime - จัดการการทำงานล่วงเวลา