Export Salary Certificate PDF

สร้างไฟล์ PDF ของเอกสารหนังสือรับรองเงินเดือน รองรับทั้งการแสดงผลในเบราว์เซอร์ (Inline) และการดาวน์โหลดไฟล์

ใช้ API นี้เพื่อสร้างไฟล์ PDF ของหนังสือรับรองเงินเดือน รองรับทั้ง Web และ Mobile

Endpoint


GET /api/v1/open-apis/salary-certificate/export
POST /api/v1/open-apis/salary-certificate/export

Request Body

Required Parameters

Parameter	Type	Required	Description	Example
`salary_certificate_letter_id`	string (base64)	Yes	รหัสเอกสาร (Base64 encoded) รองรับ `salary_certificate_id` ด้วย	`"MjAyNjAzMDU0NjI1RUY2NUVGQ0E="`

Optional Parameters

Parameter	Type	Required	Description	Example
`output`	string	No	โหมด output: `"I"` (Inline/เปิดในเบราว์เซอร์), `"F"` (File/ดาวน์โหลด) ค่าเริ่มต้น `"F"`	`"I"`
`is_mobile`	string	No	ระบุ platform: `"true"` สำหรับ Mobile ค่าเริ่มต้น `"false"`	`"true"`

Response Format

Success Response - File Mode (HTTP 200)


{
  "payload": "https://example.com/exporting/abc123def456.pdf"
}

Success Response - Mobile Mode (HTTP 200)


{
  "message": "Success",
  "payload": {
    "salary_certificate_letter_id": "20260305IMP00000001",
    "employee_id": "20260309462FEF65EFCA",
    "salary_amt": "35000.00",
    "document_flow_lv": "02",
    "file_pdf": "https://example.com/exporting/abc123def456.pdf"
  }
}

เมื่อ output=I (Inline) API จะ stream PDF โดยตรงในเบราว์เซอร์ ไม่ใช่ JSON response

Error Response - Validation Failed (HTTP 400)


{
  "message": "Validation failed: salary_certificate_id or salary_certificate_letter_id is required",
  "payload": null
}

Error Response - Certificate Not Found (HTTP 500)


{
  "message": "Error: Salary certificate not found",
  "payload": null
}

Response Fields

File Mode (output=F)

Field	Type	Description
`payload`	string	URL ของไฟล์ PDF

Mobile Mode (is_mobile=true)

Field	Type	Description
`salary_certificate_letter_id`	string	รหัสเอกสาร (20 ตัวอักษร, plain text)
`employee_id`	string	รหัสพนักงาน
`salary_amt`	string	เงินเดือน
`document_flow_lv`	string	สถานะเอกสาร
`file_pdf`	string	URL ของไฟล์ PDF

Code Examples

cURL


# File mode (ดาวน์โหลด)
curl -X GET "https://openapi.humansoft.co.th/api/v1/open-apis/salary-certificate/export?salary_certificate_letter_id=MjAyNjAzMDU0NjI1RUY2NUVGQ0E=&output=F" \
  -H "Ocp-Apim-Subscription-Key: YOUR_API_KEY"
 
# Inline mode (แสดงในเบราว์เซอร์)
curl -X GET "https://openapi.humansoft.co.th/api/v1/open-apis/salary-certificate/export?salary_certificate_letter_id=MjAyNjAzMDU0NjI1RUY2NUVGQ0E=&output=I" \
  -H "Ocp-Apim-Subscription-Key: YOUR_API_KEY"
 
# Mobile mode
curl -X GET "https://openapi.humansoft.co.th/api/v1/open-apis/salary-certificate/export?salary_certificate_letter_id=MjAyNjAzMDU0NjI1RUY2NUVGQ0E=&is_mobile=true" \
  -H "Ocp-Apim-Subscription-Key: YOUR_API_KEY"

JavaScript


const params = new URLSearchParams({
  salary_certificate_letter_id: 'MjAyNjAzMDU0NjI1RUY2NUVGQ0E=',
  output: 'F'
})
 
const response = await fetch(
  `https://openapi.humansoft.co.th/api/v1/open-apis/salary-certificate/export?${params}`,
  {
    method: 'GET',
    headers: {
      'Ocp-Apim-Subscription-Key': 'YOUR_API_KEY'
    }
  }
)
 
const data = await response.json()
 
if (data.payload) {
  console.log('PDF URL:', data.payload)
} else {
  console.error('Error:', data.message)
}

Python


import requests
 
url = "https://openapi.humansoft.co.th/api/v1/open-apis/salary-certificate/export"
headers = {
    "Ocp-Apim-Subscription-Key": "YOUR_API_KEY"
}
params = {
    "salary_certificate_letter_id": "MjAyNjAzMDU0NjI1RUY2NUVGQ0E=",
    "output": "F"
}
 
response = requests.get(url, headers=headers, params=params)
data = response.json()
 
if data.get("payload"):
    print("PDF URL:", data["payload"])
else:
    print("Error:", data.get("message"))

PHP


<?php
$params = http_build_query([
    "salary_certificate_letter_id" => "MjAyNjAzMDU0NjI1RUY2NUVGQ0E=",
    "output" => "F"
]);
 
$url = "https://openapi.humansoft.co.th/api/v1/open-apis/salary-certificate/export?" . $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['payload']) {
    echo "PDF URL: " . $data['payload'];
} else {
    echo "Error: " . $data['message'];
}
 
curl_close($ch);
?>

Notes

ข้อควรทราบ:

salary_certificate_letter_id ใน request ต้องเข้ารหัส Base64
รองรับ parameter name ทั้ง salary_certificate_letter_id และ salary_certificate_id
เมื่อ output=I API จะ stream PDF โดยตรง ไม่ส่ง JSON response
ลายเซ็นใน PDF จะเลือกตามภาษาเอกสาร (doc_language)
แนะนำให้อนุมัติเอกสาร (document_flow_lv = '02') ก่อนทำการ export

Get Detail - ดูรายละเอียดเอกสารก่อน export
Approve - อนุมัติเอกสารก่อน export
Get Signatures - ดูลายเซ็นที่ใช้ได้