Submit Visa Certificate
สร้างเอกสารขอหนังสือรับรองการทำงานเพื่อยื่นขอวีซ่าใหม่ ระบบจะตรวจสอบข้อมูลพนักงาน โควตา และส่งการแจ้งเตือนผู้อนุมัติอัตโนมัติ
เอกสารหนังสือรับรองวีซ่าต้องการข้อมูลการเดินทาง (ประเทศที่จะไป, หมายเลขพาสปอร์ต, วันที่เดินทาง) เพิ่มเติมจากหนังสือรับรองปกติ นอกจากนี้พนักงานต้องมีชื่อ-นามสกุลภาษาอังกฤษในระบบ
Endpoint
POST /api/v1/open-apis/visa-certificate/submitRequest Body
Required Parameters
| Parameter | Type | Required | Description | Example |
|---|---|---|---|---|
employee_code | string | Yes | รหัสพนักงาน | "EMP001" |
passport_no | string | Yes | หมายเลขพาสปอร์ต | "AA1234567" |
country_visit | string | Yes | ประเทศที่จะเดินทางไป | "Japan" |
travel_start_dt | string | Yes | วันที่เริ่มเดินทาง (YYYY-MM-DD) | "2026-04-10" |
travel_end_dt | string | Yes | วันที่สิ้นสุดการเดินทาง (YYYY-MM-DD) ต้อง >= travel_start_dt | "2026-04-20" |
request_purpose | string | Yes | วัตถุประสงค์การขอเอกสาร | "เพื่อใช้ยื่นขอวีซ่าท่องเที่ยว" |
send_doc_address | string | Yes | ที่อยู่สถานทูตหรือสถานที่จัดส่งเอกสาร | "สถานทูตญี่ปุ่น กรุงเทพฯ" |
doc_language | string | Yes | ภาษาของเอกสาร (TH หรือ EN) | "EN" |
authorize_id | string (base64) | Yes | รหัสสายอนุมัติ (Base64 encoded) | "YOUR_AUTHORIZE_ID_BASE64" |
Optional Parameters
| Parameter | Type | Required | Description | Example |
|---|---|---|---|---|
return_dt | string | No | วันที่เดินทางกลับ (YYYY-MM-DD) | "2026-04-21" |
publish_flag | string | No | เผยแพร่เอกสาร (Y/N) ค่าเริ่มต้น: "Y" | "N" |
Response Format
Success Response (HTTP 200)
{
"code": 200,
"message": "สร้างเอกสารรับรองสำหรับวีซ่าสำเร็จ",
"payload": {
"visa_certificate_letter_id": "20260312VC000000001",
"employee_id": "20260309462FEF65EFCA",
"employee_name": "Tawan",
"employee_last_name": "Raiduen",
"position_name": "Software Developer",
"department_name": "IT",
"branch_name": "Head Office",
"company_name": "Example Company Ltd.",
"passport_no": "AA1234567",
"country_visit": "Japan",
"travel_start_dt": "10 April 2026",
"travel_end_dt": "20 April 2026",
"return_dt": "21 April 2026",
"request_purpose": "For tourist visa application",
"send_doc_address": "Embassy of Japan, Bangkok",
"document_flow_lv": "01",
"document_flow_lv_name": "Pending Approval",
"employee_effective_dt": "2024-01-01",
"req_dt": "2026-03-12",
"approve_dt": null,
"send_doc_dt": null,
"receive_dt": null,
"doc_language": "EN",
"doc_header": null,
"doc_approver_name": null,
"doc_approver_position": null,
"approve_name": null,
"approve_remark": null,
"publish_flag": "N"
}
}Error Response - Validation Failed (HTTP 422)
{
"code": 422,
"message": "Validation failed",
"errors": ["Missing required parameter: 'passport_no'"]
}Error Response - Missing English Name (HTTP 400)
{
"code": 400,
"message": "ต้องระบุชื่อและนามสกุลภาษาอังกฤษของพนักงานสำหรับการขอวีซ่า"
}Response Fields
| Field | Type | Description |
|---|---|---|
visa_certificate_letter_id | string | รหัสเอกสาร |
employee_id | string | รหัสพนักงาน |
employee_name | string | ชื่อพนักงาน (ตาม doc_language) |
employee_last_name | string | นามสกุลพนักงาน (ตาม doc_language) |
position_name | string | ชื่อตำแหน่ง (ตาม doc_language) |
department_name | string | ชื่อแผนก (ตาม doc_language) |
branch_name | string | ชื่อสาขา (ตาม doc_language) |
company_name | string | ชื่อบริษัท (ตาม doc_language) |
passport_no | string | หมายเลขพาสปอร์ต |
country_visit | string | ประเทศที่เดินทาง |
travel_start_dt | string | วันที่เริ่มเดินทาง (format ตาม doc_language) |
travel_end_dt | string | วันที่สิ้นสุดการเดินทาง |
return_dt | string | null | วันที่เดินทางกลับ |
request_purpose | string | วัตถุประสงค์ |
send_doc_address | string | ที่อยู่จัดส่ง |
document_flow_lv | string | รหัสสถานะเอกสาร |
document_flow_lv_name | string | ชื่อสถานะเอกสาร |
employee_effective_dt | string | วันที่เริ่มงาน |
req_dt | string | วันที่ขอเอกสาร (YYYY-MM-DD) |
approve_dt | string | null | วันที่อนุมัติ |
doc_language | string | ภาษาเอกสาร (TH / EN) |
publish_flag | string | สถานะเผยแพร่ (Y / N) |
Code Examples
cURL
curl -X POST "https://openapi.humansoft.co.th/api/v1/open-apis/visa-certificate/submit" \
-H "Ocp-Apim-Subscription-Key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"employee_code": "EMP001",
"passport_no": "AA1234567",
"country_visit": "Japan",
"travel_start_dt": "2026-04-10",
"travel_end_dt": "2026-04-20",
"return_dt": "2026-04-21",
"request_purpose": "For tourist visa application",
"send_doc_address": "Embassy of Japan, Bangkok",
"doc_language": "EN",
"authorize_id": "YOUR_AUTHORIZE_ID_BASE64"
}'Notes
ข้อกำหนดสำคัญ:
- พนักงานต้องมีชื่อ-นามสกุลภาษาอังกฤษในระบบ มิฉะนั้นจะไม่สามารถสร้างเอกสารได้
travel_end_dtต้องมากกว่าหรือเท่ากับtravel_start_dtdoc_languageต้องเป็นTHหรือENเท่านั้น- ระบบจะตรวจสอบโควตาจำนวนเอกสารที่ขอได้ในรอบเงินเดือน (หากเปิดใช้งาน)
- เอกสารที่สร้างใหม่จะมีสถานะเริ่มต้นเป็น
01(รออนุมัติ)
Related APIs
- Get Detail - ดูรายละเอียดเอกสาร
- Update - แก้ไขเอกสารที่รออนุมัติ
- Delete - ลบเอกสารที่รออนุมัติ
- Approve - อนุมัติ/ปฏิเสธเอกสาร
Last updated on