Approve Visa Certificate

อนุมัติเอกสารขอหนังสือรับรองเพื่อขอวีซ่า รองรับขั้นตอนอนุมัติหลายระดับ (Multi-Level Approval) สูงสุด 5 ระดับ

ระบบจะคำนวณขั้นตอนการอนุมัติถัดไปอัตโนมัติตามโครงสร้างสายอนุมัติที่ตั้งค่าไว้ เมื่อถึงขั้นสุดท้าย (02) ระบบจะจับคู่ลายเซ็นและบันทึกข้อมูลผู้อนุมัติให้โดยอัตโนมัติ

Endpoint


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

Request Body

Required Parameters

Parameter	Type	Required	Description	Example
`visa_certificate_letter_id`	string (base64)	Yes	รหัสเอกสาร (Base64 encoded)	`"MjAyNjAzMTJWQzAwMDAwMDAwMQ=="`
`document_flow_lv`	string	Yes	สถานะเอกสารที่ต้องการเปลี่ยนไป	`"02"`

Optional Parameters

Parameter	Type	Required	Description	Example
`approve_remark`	string	No	หมายเหตุการอนุมัติหรือเหตุผลการปฏิเสธ	`"เตรียมเอกสารเรียบร้อย"`
`doc_approver_name`	string	No	ชื่อผู้อนุมัติ (สำหรับลงนามในเอกสาร)	`"สมชาย ฝ่ายบุคคล"`
`doc_approver_position`	string	No	ตำแหน่งผู้อนุมัติ	`"HR Manager"`
`signature_id`	string (base64)	No	รหัสลายเซ็น (Base64 encoded)	`"U0lHX3h4eHg="`
`authorize_line`	boolean	No	ยึดตามลำดับการอนุมัติ	`true`

Document Flow Level Values

ค่า	ความหมาย (EN)	ความหมาย (TH)
`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

Response Format

Success Response (HTTP 200)


{
  "code": 200,
  "message": "สำเร็จ",
  "payload": {
    "visa_certificate_letter_id": "20260312VC000000001",
    "employee_id": "20260309462FEF65EFCA",
    "document_flow_lv": "02",
    "approve_remark": "อนุมัติเรียบร้อย",
    "approved_at": "2026-03-12 11:15:00"
  }
}

Error Response - Validation Failed (HTTP 422)


{
  "code": 422,
  "message": "Validation failed",
  "errors": ["'document_flow_lv' is required"]
}

Error Response - Certificate Not Found (HTTP 400)


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

Response Fields

Field	Type	Description
`visa_certificate_letter_id`	string	รหัสเอกสาร
`employee_id`	string	รหัสพนักงาน
`document_flow_lv`	string	สถานะเอกสารหลังอนุมัติ
`approve_remark`	string	หมายเหตุการอนุมัติ
`approved_at`	string	วันเวลาที่อนุมัติ

Code Examples

cURL


curl -X POST "https://openapi.humansoft.co.th/api/v1/open-apis/visa-certificate/approve" \
  -H "Ocp-Apim-Subscription-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "visa_certificate_letter_id": "MjAyNjAzMTJWQzAwMDAwMDAwMQ==",
    "document_flow_lv": "02",
    "approve_remark": "อนุมัติเรียบร้อย"
  }'

JavaScript


const response = await fetch(
  'https://openapi.humansoft.co.th/api/v1/open-apis/visa-certificate/approve',
  {
    method: 'POST',
    headers: {
      'Ocp-Apim-Subscription-Key': 'YOUR_API_KEY',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      visa_certificate_letter_id: 'MjAyNjAzMTJWQzAwMDAwMDAwMQ==',
      document_flow_lv: '02',
      approve_remark: 'อนุมัติเรียบร้อย'
    })
  }
)
 
const data = await response.json()
 
if (data.code === 200) {
  console.log('อนุมัติสำเร็จ:', data.payload.visa_certificate_letter_id)
  console.log('สถานะ:', data.payload.document_flow_lv)
} else {
  console.error('Error:', data.errors || data.message)
}

Python


import requests
 
url = "https://openapi.humansoft.co.th/api/v1/open-apis/visa-certificate/approve"
headers = {
    "Ocp-Apim-Subscription-Key": "YOUR_API_KEY",
    "Content-Type": "application/json"
}
payload = {
    "visa_certificate_letter_id": "MjAyNjAzMTJWQzAwMDAwMDAwMQ==",
    "document_flow_lv": "02",
    "approve_remark": "อนุมัติเรียบร้อย"
}
 
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/approve";
 
$headers = [
    "Ocp-Apim-Subscription-Key: YOUR_API_KEY",
    "Content-Type: application/json"
];
 
$payload = [
    "visa_certificate_letter_id" => "MjAyNjAzMTJWQzAwMDAwMDAwMQ==",
    "document_flow_lv" => "02",
    "approve_remark" => "อนุมัติเรียบร้อย"
];
 
$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
ระบบรองรับการอนุมัติหลายขั้นตอน เช่น 01 -> 07 -> 08 -> 02
เมื่ออนุมัติขั้นสุดท้าย (02) ระบบจะจับคู่ลายเซ็นและบันทึกข้อมูลผู้อนุมัติ
ระบบจะส่งการแจ้งเตือนไปยังพนักงานและผู้ที่เกี่ยวข้องอัตโนมัติ

Get Detail - ดูรายละเอียดก่อนอนุมัติ
Export PDF - ดาวน์โหลดเอกสาร PDF หลังอนุมัติ
Get Signatures - ดูรายการลายเซ็นที่ใช้ได้