Update Visa Certificate

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

ส่งเฉพาะฟิลด์ที่ต้องการอัปเดต ฟิลด์ที่ไม่ส่งระบบจะใช้ค่าเดิม ไม่สามารถย้อนสถานะจากอนุมัติแล้ว (02) กลับมาเป็นรออนุมัติ (01) ได้

Endpoint


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

Request Body

Required Parameters

Parameter	Type	Required	Description	Example
`visa_certificate_letter_id`	string (base64)	Yes	รหัสเอกสาร (Base64 encoded)	`"MjAyNjAzMTJWQzAwMDAwMDAwMQ=="`

Optional Parameters (อย่างน้อย 1 ฟิลด์)

Parameter	Type	Required	Description	Example
`passport_no`	string	No	หมายเลขพาสปอร์ต	`"AA9999999"`
`country_visit`	string	No	ประเทศที่เดินทาง	`"South Korea"`
`travel_start_dt`	string	No	วันที่เริ่มเดินทาง (YYYY-MM-DD)	`"2026-05-01"`
`travel_end_dt`	string	No	วันที่สิ้นสุดการเดินทาง (YYYY-MM-DD)	`"2026-05-15"`
`return_dt`	string	No	วันที่เดินทางกลับ (YYYY-MM-DD)	`"2026-05-16"`
`request_purpose`	string	No	วัตถุประสงค์	`"เพื่อยื่นวีซ่า"`
`send_doc_address`	string	No	ที่อยู่จัดส่ง	`"สถานทูตเกาหลี กรุงเทพฯ"`
`doc_language`	string	No	ภาษาเอกสาร (`TH` หรือ `EN`)	`"EN"`
`publish_flag`	string	No	สถานะเผยแพร่ (`Y` หรือ `N`)	`"N"`
`document_flow_lv`	string	No	เปลี่ยนสถานะเอกสาร	`"02"`
`doc_approver_name`	string	No	ชื่อผู้อนุมัติ (สำหรับ flow `02`)	`"นางตัวอย่าง อนุมัติ"`
`doc_approver_position`	string	No	ตำแหน่งผู้อนุมัติ (สำหรับ flow `02`)	`"HR Manager"`
`signature_id`	string (base64)	No	รหัสลายเซ็น (Base64 encoded, สำหรับ flow `02`)	`"U0lHMDAwMQ=="`

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",
    "passport_no": "AA9999999",
    "country_visit": "South Korea",
    "document_flow_lv": "02",
    "document_flow_lv_name": "Approved",
    "doc_approver_name": "Miss HR Example",
    "doc_approver_position": "HR Director",
    "publish_flag": "N"
  }
}

Error Response - Validation Failed (HTTP 422)


{
  "code": 422,
  "message": "Validation failed",
  "errors": ["Missing required parameter: 'visa_certificate_letter_id'"]
}

Error Response - Not Found (HTTP 404)


{
  "code": 404,
  "message": "Certificate not found"
}

Error Response - Already Approved (HTTP 400)


{
  "code": 400,
  "message": "ไม่สามารถแปลงสถานะเอกสารที่อนุมัติแล้วกลับไปรออนุมัติได้"
}

Response Fields

Field	Type	Description
`visa_certificate_letter_id`	string	รหัสเอกสาร
`employee_id`	string	รหัสพนักงาน
`employee_name`	string	ชื่อพนักงาน
`employee_last_name`	string	นามสกุลพนักงาน
`passport_no`	string	หมายเลขพาสปอร์ต
`country_visit`	string	ประเทศที่เดินทาง
`document_flow_lv`	string	รหัสสถานะเอกสาร
`document_flow_lv_name`	string	ชื่อสถานะเอกสาร
`doc_approver_name`	string \| null	ชื่อผู้อนุมัติ
`doc_approver_position`	string \| null	ตำแหน่งผู้อนุมัติ
`publish_flag`	string	สถานะเผยแพร่ (Y / N)

Code Examples

cURL


curl -X POST "https://openapi.humansoft.co.th/api/v1/open-apis/visa-certificate/update" \
  -H "Ocp-Apim-Subscription-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "visa_certificate_letter_id": "MjAyNjAzMTJWQzAwMDAwMDAwMQ==",
    "passport_no": "AA9999999",
    "country_visit": "South Korea",
    "travel_start_dt": "2026-05-01",
    "travel_end_dt": "2026-05-15"
  }'

JavaScript


const response = await fetch(
  'https://openapi.humansoft.co.th/api/v1/open-apis/visa-certificate/update',
  {
    method: 'POST',
    headers: {
      'Ocp-Apim-Subscription-Key': 'YOUR_API_KEY',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      visa_certificate_letter_id: 'MjAyNjAzMTJWQzAwMDAwMDAwMQ==',
      passport_no: 'AA9999999',
      country_visit: 'South Korea',
      travel_start_dt: '2026-05-01',
      travel_end_dt: '2026-05-15'
    })
  }
)
 
const data = await response.json()
 
if (data.code === 200) {
  console.log('อัปเดตสำเร็จ:', data.payload.visa_certificate_letter_id)
} else {
  console.error('Error:', data.errors || data.message)
}

Python


import requests
 
url = "https://openapi.humansoft.co.th/api/v1/open-apis/visa-certificate/update"
headers = {
    "Ocp-Apim-Subscription-Key": "YOUR_API_KEY",
    "Content-Type": "application/json"
}
payload = {
    "visa_certificate_letter_id": "MjAyNjAzMTJWQzAwMDAwMDAwMQ==",
    "passport_no": "AA9999999",
    "country_visit": "South Korea",
    "travel_start_dt": "2026-05-01",
    "travel_end_dt": "2026-05-15"
}
 
response = requests.post(url, headers=headers, json=payload)
data = response.json()
 
if data["code"] == 200:
    print("อัปเดตสำเร็จ:", data["payload"]["visa_certificate_letter_id"])
else:
    print("Error:", data.get("errors") or data.get("message"))

PHP


<?php
$url = "https://openapi.humansoft.co.th/api/v1/open-apis/visa-certificate/update";
 
$headers = [
    "Ocp-Apim-Subscription-Key: YOUR_API_KEY",
    "Content-Type: application/json"
];
 
$payload = [
    "visa_certificate_letter_id" => "MjAyNjAzMTJWQzAwMDAwMDAwMQ==",
    "passport_no" => "AA9999999",
    "country_visit" => "South Korea",
    "travel_start_dt" => "2026-05-01",
    "travel_end_dt" => "2026-05-15"
];
 
$ch = curl_init($url);
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($payload));
 
$response = curl_exec($ch);
$data = json_decode($response, true);
 
if ($data['code'] === 200) {
    echo "อัปเดตสำเร็จ: " . $data['payload']['visa_certificate_letter_id'] . "\n";
} else {
    echo "Error: " . ($data['errors'][0] ?? $data['message']);
}
 
curl_close($ch);
?>

Notes

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

visa_certificate_letter_id ต้องเข้ารหัส Base64 (หากไม่เข้ารหัสระบบจะไม่พบรายการ)
ห้ามย้อนสถานะจากอนุมัติแล้ว (02) กลับมาเป็นรออนุมัติ (01)
หากเปลี่ยนสถานะเป็น 02 (อนุมัติ) สามารถระบุ doc_approver_name, doc_approver_position และ signature_id ได้
ระบบจะส่งการแจ้งเตือนไปยังพนักงานอัตโนมัติหลังอัปเดต

Submit - สร้างเอกสารวีซ่าใหม่
Delete - ลบเอกสารที่ยังไม่อนุมัติ
Get Detail - ดูรายละเอียดเอกสาร