Visa Certificate API Module
ภาพรวม (Overview)
โมดูล Visa Certificate เป็น API สำหรับจัดการหนังสือรับรองการทำงานเพื่อยื่นขอวีซ่า ครอบคลุมการสร้างเอกสาร แก้ไข อนุมัติหลายระดับ (สูงสุด 5 ขั้น) ส่งออก PDF รองรับทั้งภาษาไทยและภาษาอังกฤษ รวมถึงการนำเข้าเอกสารแบบ Bulk
เอกสารหนังสือรับรองวีซ่าต้องระบุข้อมูลการเดินทางเพิ่มเติม เช่น หมายเลขพาสปอร์ต ประเทศที่จะเดินทาง และวันที่เดินทาง นอกจากนี้พนักงานต้องมีชื่อ-นามสกุลภาษาอังกฤษในระบบ
สถานะเอกสาร (Document Status)
| Code | ความหมาย (EN) | ความหมาย (TH) |
|---|---|---|
01 | Pending Approval | รออนุมัติ |
02 | Approved | อนุมัติแล้ว |
03 | Not Approved | ไม่อนุมัติ |
04 | Sent Document | ส่งเอกสารแล้ว |
05 | Receive Document | ได้รับเอกสารแล้ว |
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 |
API Endpoints (9 endpoints)
สร้างเอกสาร
Submit
สร้างเอกสารขอหนังสือรับรองเพื่อยื่นขอวีซ่าใหม่
Use Cases:
- พนักงานขอหนังสือรับรองเพื่อยื่นวีซ่าท่องเที่ยวหรือทำงาน
- ระบุข้อมูลการเดินทาง พาสปอร์ต และที่อยู่สถานทูต
Import (Bulk)
นำเข้าเอกสารขอหนังสือรับรองวีซ่าจำนวนมากพร้อมกัน
Use Cases:
- HR นำเข้าเอกสารหลายรายการพร้อมกันผ่าน JSON Array
- ระบบตรวจสอบความถูกต้องและรายงานรายการที่ผิดพลาด
จัดการเอกสาร
Approve
อนุมัติหรือปฏิเสธเอกสารขอหนังสือรับรองวีซ่า
Use Cases:
- หัวหน้างานอนุมัติเอกสารตามลำดับขั้น (สูงสุด 5 ระดับ)
- HR อนุมัติขั้นสุดท้ายพร้อมแนบลายเซ็น
Update
แก้ไขข้อมูลเอกสารหนังสือรับรองวีซ่า
Use Cases:
- แก้ไขข้อมูลการเดินทาง เช่น ประเทศ วันที่ หมายเลขพาสปอร์ต
- เปลี่ยนสถานะเอกสารผ่านการอัปเดต
Delete
ลบเอกสารหนังสือรับรองวีซ่า
Use Cases:
- ลบเอกสารที่สร้างผิดพลาด
- ลบได้เฉพาะเอกสารที่ยังไม่ได้รับการอนุมัติ
การลบข้อมูลไม่สามารถกู้คืนได้ กรุณาตรวจสอบให้แน่ใจก่อนดำเนินการ
ส่งออกเอกสาร
Export PDF
สร้างและดาวน์โหลดไฟล์ PDF ของหนังสือรับรองวีซ่า
Use Cases:
- ส่งออกเอกสารเป็น PDF พร้อมลายเซ็นผู้อนุมัติ
- เปิดดูเอกสารแบบ Inline ผ่านเบราว์เซอร์
ดึงข้อมูล
Get Detail
ดูรายละเอียดเอกสารหนังสือรับรองวีซ่า
Use Cases:
- ดูรายละเอียดเอกสารฉบับเต็ม รวมข้อมูลการเดินทางและโครงสร้างองค์กร
- ตรวจสอบสิทธิ์การอนุมัติ
Get List
ดูรายการเอกสารหนังสือรับรองวีซ่าทั้งหมด
Use Cases:
- แสดงรายการเอกสารทั้งหมดพร้อมตัวกรอง
- รองรับการแบ่งหน้า (Pagination)
Get Signatures
ดูรายการลายเซ็นที่ใช้งานได้
Use Cases:
- ดึงรายการลายเซ็นสำหรับใช้ในการอนุมัติขั้นสุดท้าย
- เลือกลายเซ็นสำหรับแนบในเอกสาร PDF
Related APIs
- Document Overview - ภาพรวมโมดูลเอกสารทั้งหมด
- Salary Certificate - หนังสือรับรองเงินเดือน
- Work Certificate - หนังสือรับรองการทำงาน