Approve Work Certificate

อนุมัติหรือปฏิเสธเอกสารหนังสือรับรองการทำงาน รองรับ Multi-Level Approval สูงสุด 5 ขั้น

ระบบรองรับ workflow อนุมัติหลายขั้น พร้อมจัดการลายเซ็น เลขเอกสาร และการแจ้งเตือนอัตโนมัติ

Endpoint


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

Request Body

Required Parameters

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

Optional Parameters

Parameter	Type	Default	Description	Example
`approve_remark`	string	`""`	หมายเหตุการอนุมัติ/ปฏิเสธ	`"ตรวจสอบแล้วถูกต้อง"`
`signature_id`	string	`""`	รหัสลายเซ็น (สำหรับกรณีเลือกลายเซ็นเอง)	`"MjAyNTA0..."`
`doc_approver_name`	string	`""`	ชื่อผู้อนุมัติ (สำหรับกรณีพิมพ์ชื่อเอง)	`"สมชาย ผู้จัดการ"`
`doc_approver_position`	string	`""`	ตำแหน่งผู้อนุมัติ (สำหรับกรณีพิมพ์ชื่อเอง)	`"ผู้จัดการฝ่ายบุคคล"`
`doc_header`	string	`"company"` / `"branch"`	หัวข้อเอกสาร	`"หนังสือรับรองการทำงาน"`
`doc_until_dt`	string	`""`	วันที่สิ้นสุดการอนุมัติ	`"2026-03-12"`
`authorize_line`	string	`""`	สายการอนุมัติ	`"true"`

Document Flow Level Values

Value	ความหมาย (TH)	ความหมาย (EN)
`02`	อนุมัติ	Approved
`03`	ไม่อนุมัติ	Not Approved
`04`	ส่งเอกสารแล้ว	Sent Document
`05`	ได้รับเอกสารแล้ว	Receive Document
`06`	ตรวจสอบอีกครั้ง	Recheck
`07`-`11`	หัวหน้าอนุมัติขั้นที่ 1-5	Manager Approved Level 1-5

Request Body Example


{
  "work_certificate_letter_id": "MjAyNjAzMDVXQzAwMDAwMDAwMQ==",
  "document_flow_lv": "02",
  "approve_remark": "ตรวจสอบแล้วถูกต้อง"
}

Response Format

Success Response (HTTP 200)


{
  "code": 200,
  "message": "สำเร็จ",
  "payload": {
    "work_certificate_letter_id": "20260305WC000000001",
    "employee_id": "20260309462FEF65EFCA",
    "document_flow_lv": "02",
    "approve_remark": "ตรวจสอบแล้วถูกต้อง",
    "approved_at": "2026-03-09 11:10:00"
  }
}

Error Response - Validation Failed (HTTP 422)


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

Error Response - Certificate Not Found (HTTP 404)


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

Error Response - Business Logic Error (HTTP 400)


{
  "code": 400,
  "message": "Cannot change status from approved to pending"
}

Response Fields

Field	Type	Nullable	Description
`work_certificate_letter_id`	string	No	รหัสเอกสาร (plain text)
`employee_id`	string	No	รหัสพนักงาน (plain text)
`document_flow_lv`	string	No	สถานะเอกสารล่าสุด
`approve_remark`	string	No	หมายเหตุการอนุมัติ
`approved_at`	string	No	วันเวลาที่อนุมัติ (YYYY-MM-DD HH:mm:ss)

Code Examples

cURL


# อนุมัติเอกสาร
curl -X POST "https://openapi.humansoft.co.th/api/v1/open-apis/work-certificate/approve" \
  -H "Ocp-Apim-Subscription-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "work_certificate_letter_id": "MjAyNjAzMDVXQzAwMDAwMDAwMQ==",
    "document_flow_lv": "02",
    "approve_remark": "ตรวจสอบแล้วถูกต้อง"
  }'
 
# ปฏิเสธเอกสาร
curl -X POST "https://openapi.humansoft.co.th/api/v1/open-apis/work-certificate/approve" \
  -H "Ocp-Apim-Subscription-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "work_certificate_letter_id": "MjAyNjAzMDVXQzAwMDAwMDAwMQ==",
    "document_flow_lv": "03",
    "approve_remark": "ข้อมูลไม่ถูกต้อง กรุณาแก้ไข"
  }'

JavaScript


const response = await fetch(
  'https://openapi.humansoft.co.th/api/v1/open-apis/work-certificate/approve',
  {
    method: 'POST',
    headers: {
      'Ocp-Apim-Subscription-Key': 'YOUR_API_KEY',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      work_certificate_letter_id: 'MjAyNjAzMDVXQzAwMDAwMDAwMQ==',
      document_flow_lv: '02',
      approve_remark: 'ตรวจสอบแล้วถูกต้อง'
    })
  }
)
 
const data = await response.json()
 
if (data.code === 200) {
  console.log('อนุมัติสำเร็จ:', data.payload.work_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/work-certificate/approve"
headers = {
    "Ocp-Apim-Subscription-Key": "YOUR_API_KEY",
    "Content-Type": "application/json"
}
payload = {
    "work_certificate_letter_id": "MjAyNjAzMDVXQzAwMDAwMDAwMQ==",
    "document_flow_lv": "02",
    "approve_remark": "ตรวจสอบแล้วถูกต้อง"
}
 
response = requests.post(url, headers=headers, json=payload)
data = response.json()
 
if data["code"] == 200:
    print("อนุมัติสำเร็จ:", data["payload"]["work_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/work-certificate/approve";
 
$headers = [
    "Ocp-Apim-Subscription-Key: YOUR_API_KEY",
    "Content-Type: application/json"
];
 
$payload = [
    "work_certificate_letter_id" => "MjAyNjAzMDVXQzAwMDAwMDAwMQ==",
    "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"]["work_certificate_letter_id"];
} else {
    echo "Error: " . ($data["errors"][0] ?? $data["message"]);
}
 
curl_close($ch);
?>

Notes

ข้อควรทราบ:

work_certificate_letter_id ใน request ต้องเข้ารหัส base64, ใน response เป็น plain text
ระบบรองรับ Multi-Level Approval (ขั้นตอนที่ 1-5 ใช้ค่า 07-11)
เมื่ออนุมัติขั้นสุดท้าย (02) ระบบจะดึงลายเซ็นและกำหนดเลขเอกสาร (order_no) อัตโนมัติ
เมื่อส่งเอกสาร (04) ระบบจะกำหนดวันที่ส่งเอกสารอัตโนมัติ
เมื่อได้รับเอกสาร (05) ระบบจะกำหนดวันที่รับเอกสารอัตโนมัติ

Get List - ดูรายการเอกสารที่รออนุมัติ
Get Detail - ดูรายละเอียดเอกสารก่อนอนุมัติ
Update - แก้ไขเอกสารแทนการอนุมัติ
Export PDF - สร้าง PDF หลังอนุมัติ

Approve Work Certificate

Endpoint

Request Body

Required Parameters

Optional Parameters

Document Flow Level Values

Request Body Example

Response Format

Success Response (HTTP 200)

Error Response - Validation Failed (HTTP 422)

Error Response - Certificate Not Found (HTTP 404)

Error Response - Business Logic Error (HTTP 400)

Response Fields

Code Examples

cURL

JavaScript

Python

PHP

Notes

Related APIs