Get Visa Certificate Detail

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

ระบบจะแปลงข้อมูลชื่อ ตำแหน่ง ที่อยู่ และข้อมูลอื่นๆ ตามภาษาที่ระบุใน language_code โดยอัตโนมัติ

Endpoint


GET /api/v1/open-apis/visa-certificate/get-detail
POST /api/v1/open-apis/visa-certificate/get-detail

Request Body

Required Parameters

Parameter	Type	Required	Description	Example
`visa_certificate_letter_id`	string (base64)	Yes	รหัสเอกสาร (Base64 encoded)	`"MjAyNjAzMTJWQzAwMDAwMDAwMQ=="`
`language_code`	string	Yes	ภาษาสำหรับแสดงผลข้อมูล (`TH` หรือ `EN`)	`"EN"`

Optional Parameters

Parameter	Type	Required	Description	Example
`authorize_line`	boolean	No	เลือกดูจากสายอนุมัติ เพื่อแสดง `authorize_flag` ค่าเริ่มต้น: `false`	`true`

Response Format

Success Response (HTTP 200)


{
  "code": 200,
  "message": "สำเร็จ",
  "payload": {
    "visa_certificate_letter_id": "20260312VC000000001",
    "employee_id": "20260309462FEF65EFCA",
    "employee_first_name": "Tawan",
    "employee_last_name": "Raiduen",
    "position_name": "Software Developer",
    "department_name": "IT",
    "branch_name": "Head Office",
    "company_name": "Example Company",
    "passport_no": "AA1234567",
    "country_visit": "Japan",
    "travel_start_dt": "2026-04-10",
    "travel_end_dt": "2026-04-15",
    "return_dt": "2026-04-16",
    "address": "123 Example Rd, Bangkok 10900",
    "salary": "50,000",
    "begin_dt": "2024-01-01",
    "position_full_name": "Senior Software Developer",
    "document_flow_lv": "01",
    "document_flow_lv_name": "Pending Approval",
    "doc_language": "EN",
    "edit_approve": true,
    "approve_flag_name": "Pending Approval",
    "authorize_flag": true,
    "organization": {
      "department": { "label": "Department", "value": "IT" },
      "company": { "label": "Company", "value": "Example Company" }
    }
  }
}

Error Response - Not Found (HTTP 400)


{
  "code": 400,
  "message": "ไม่สำเร็จ",
  "error": "ไม่พบเอกสาร"
}

Response Fields

Field	Type	Description
`visa_certificate_letter_id`	string	รหัสเอกสาร
`employee_id`	string	รหัสพนักงาน
`employee_first_name`	string	ชื่อพนักงาน (ตาม language_code)
`employee_last_name`	string	นามสกุลพนักงาน (ตาม language_code)
`position_name`	string	ชื่อตำแหน่ง
`department_name`	string	ชื่อแผนก
`branch_name`	string	ชื่อสาขา
`company_name`	string	ชื่อบริษัท
`passport_no`	string	หมายเลขพาสปอร์ต
`country_visit`	string	ประเทศที่เดินทาง
`travel_start_dt`	string	วันที่เริ่มเดินทาง
`travel_end_dt`	string	วันที่สิ้นสุดการเดินทาง
`return_dt`	string \| null	วันที่เดินทางกลับ
`address`	string	ที่อยู่พนักงาน (แปลงภาษาตาม language_code)
`salary`	string	เงินเดือน
`begin_dt`	string	วันที่เริ่มงาน
`document_flow_lv`	string	รหัสสถานะเอกสาร
`document_flow_lv_name`	string	ชื่อสถานะเอกสาร
`doc_language`	string	ภาษาเอกสาร (TH / EN)
`edit_approve`	boolean	มีสิทธิ์แก้ไข/อนุมัติหรือไม่
`authorize_flag`	boolean	Flag ผู้อนุมัติตามสายงาน
`organization`	object	ข้อมูลโครงสร้างองค์กร

Code Examples

cURL


curl -X GET "https://openapi.humansoft.co.th/api/v1/open-apis/visa-certificate/get-detail?visa_certificate_letter_id=MjAyNjAzMTJWQzAwMDAwMDAwMQ==&language_code=EN" \
  -H "Ocp-Apim-Subscription-Key: YOUR_API_KEY"

JavaScript


const params = new URLSearchParams({
  visa_certificate_letter_id: 'MjAyNjAzMTJWQzAwMDAwMDAwMQ==',
  language_code: 'EN'
})
 
const response = await fetch(
  `https://openapi.humansoft.co.th/api/v1/open-apis/visa-certificate/get-detail?${params}`,
  {
    method: 'GET',
    headers: {
      'Ocp-Apim-Subscription-Key': 'YOUR_API_KEY'
    }
  }
)
 
const data = await response.json()
 
if (data.code === 200) {
  const doc = data.payload
  console.log('เอกสาร:', doc.visa_certificate_letter_id)
  console.log('พนักงาน:', doc.employee_first_name, doc.employee_last_name)
  console.log('ประเทศ:', doc.country_visit)
  console.log('สถานะ:', doc.document_flow_lv_name)
} else {
  console.error('Error:', data.error || data.message)
}

Python


import requests
 
url = "https://openapi.humansoft.co.th/api/v1/open-apis/visa-certificate/get-detail"
headers = {
    "Ocp-Apim-Subscription-Key": "YOUR_API_KEY"
}
params = {
    "visa_certificate_letter_id": "MjAyNjAzMTJWQzAwMDAwMDAwMQ==",
    "language_code": "EN"
}
 
response = requests.get(url, headers=headers, params=params)
data = response.json()
 
if data["code"] == 200:
    doc = data["payload"]
    print("เอกสาร:", doc["visa_certificate_letter_id"])
    print("พนักงาน:", doc["employee_first_name"], doc["employee_last_name"])
    print("ประเทศ:", doc["country_visit"])
    print("สถานะ:", doc["document_flow_lv_name"])
else:
    print("Error:", data.get("error") or data.get("message"))

PHP


<?php
$params = http_build_query([
    "visa_certificate_letter_id" => "MjAyNjAzMTJWQzAwMDAwMDAwMQ==",
    "language_code" => "EN"
]);
 
$url = "https://openapi.humansoft.co.th/api/v1/open-apis/visa-certificate/get-detail?" . $params;
 
$headers = [
    "Ocp-Apim-Subscription-Key: YOUR_API_KEY"
];
 
$ch = curl_init($url);
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
 
$response = curl_exec($ch);
$data = json_decode($response, true);
 
if ($data['code'] === 200) {
    $doc = $data['payload'];
    echo "เอกสาร: " . $doc['visa_certificate_letter_id'] . "\n";
    echo "พนักงาน: " . $doc['employee_first_name'] . " " . $doc['employee_last_name'] . "\n";
    echo "ประเทศ: " . $doc['country_visit'] . "\n";
    echo "สถานะ: " . $doc['document_flow_lv_name'] . "\n";
} else {
    echo "Error: " . ($data['error'] ?? $data['message']);
}
 
curl_close($ch);
?>

Notes

ข้อกำหนดสำคัญ:

visa_certificate_letter_id ต้องเข้ารหัส Base64 (หากไม่เข้ารหัสระบบจะไม่พบรายการ)
language_code กำหนดภาษาที่ใช้แสดงผลข้อมูล เช่น ชื่อ ตำแหน่ง ที่อยู่
ระบบจะดึงข้อมูลผู้อนุมัติในสายอนุมัติ (ระดับ 1-5) มาแสดงพร้อมกัน

Approve - อนุมัติเอกสารหลังตรวจสอบรายละเอียด
Export PDF - ส่งออกเอกสารเป็น PDF
Get List - ดูรายการเอกสารทั้งหมด