Skip to Content
🚀 Welcome to Humansoft Open API Documentation

Submit Visa Certificate

สร้างเอกสารขอหนังสือรับรองการทำงานเพื่อยื่นขอวีซ่าใหม่ ระบบจะตรวจสอบข้อมูลพนักงาน โควตา และส่งการแจ้งเตือนผู้อนุมัติอัตโนมัติ

เอกสารหนังสือรับรองวีซ่าต้องการข้อมูลการเดินทาง (ประเทศที่จะไป, หมายเลขพาสปอร์ต, วันที่เดินทาง) เพิ่มเติมจากหนังสือรับรองปกติ นอกจากนี้พนักงานต้องมีชื่อ-นามสกุลภาษาอังกฤษในระบบ

Endpoint

POST /api/v1/open-apis/visa-certificate/submit

Request Body

Required Parameters

ParameterTypeRequiredDescriptionExample
employee_codestringYesรหัสพนักงาน"EMP001"
passport_nostringYesหมายเลขพาสปอร์ต"AA1234567"
country_visitstringYesประเทศที่จะเดินทางไป"Japan"
travel_start_dtstringYesวันที่เริ่มเดินทาง (YYYY-MM-DD)"2026-04-10"
travel_end_dtstringYesวันที่สิ้นสุดการเดินทาง (YYYY-MM-DD) ต้อง >= travel_start_dt"2026-04-20"
request_purposestringYesวัตถุประสงค์การขอเอกสาร"เพื่อใช้ยื่นขอวีซ่าท่องเที่ยว"
send_doc_addressstringYesที่อยู่สถานทูตหรือสถานที่จัดส่งเอกสาร"สถานทูตญี่ปุ่น กรุงเทพฯ"
doc_languagestringYesภาษาของเอกสาร (TH หรือ EN)"EN"
authorize_idstring (base64)Yesรหัสสายอนุมัติ (Base64 encoded)"YOUR_AUTHORIZE_ID_BASE64"

Optional Parameters

ParameterTypeRequiredDescriptionExample
return_dtstringNoวันที่เดินทางกลับ (YYYY-MM-DD)"2026-04-21"
publish_flagstringNoเผยแพร่เอกสาร (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

FieldTypeDescription
visa_certificate_letter_idstringรหัสเอกสาร
employee_idstringรหัสพนักงาน
employee_namestringชื่อพนักงาน (ตาม doc_language)
employee_last_namestringนามสกุลพนักงาน (ตาม doc_language)
position_namestringชื่อตำแหน่ง (ตาม doc_language)
department_namestringชื่อแผนก (ตาม doc_language)
branch_namestringชื่อสาขา (ตาม doc_language)
company_namestringชื่อบริษัท (ตาม doc_language)
passport_nostringหมายเลขพาสปอร์ต
country_visitstringประเทศที่เดินทาง
travel_start_dtstringวันที่เริ่มเดินทาง (format ตาม doc_language)
travel_end_dtstringวันที่สิ้นสุดการเดินทาง
return_dtstring | nullวันที่เดินทางกลับ
request_purposestringวัตถุประสงค์
send_doc_addressstringที่อยู่จัดส่ง
document_flow_lvstringรหัสสถานะเอกสาร
document_flow_lv_namestringชื่อสถานะเอกสาร
employee_effective_dtstringวันที่เริ่มงาน
req_dtstringวันที่ขอเอกสาร (YYYY-MM-DD)
approve_dtstring | nullวันที่อนุมัติ
doc_languagestringภาษาเอกสาร (TH / EN)
publish_flagstringสถานะเผยแพร่ (Y / N)

Code Examples

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_dt
  • doc_language ต้องเป็น TH หรือ EN เท่านั้น
  • ระบบจะตรวจสอบโควตาจำนวนเอกสารที่ขอได้ในรอบเงินเดือน (หากเปิดใช้งาน)
  • เอกสารที่สร้างใหม่จะมีสถานะเริ่มต้นเป็น 01 (รออนุมัติ)
  • Get Detail - ดูรายละเอียดเอกสาร
  • Update - แก้ไขเอกสารที่รออนุมัติ
  • Delete - ลบเอกสารที่รออนุมัติ
  • Approve - อนุมัติ/ปฏิเสธเอกสาร
Last updated on