Submit Work Certificate

สร้างเอกสารขอหนังสือรับรองการทำงานใหม่ ระบบจะตรวจสอบข้อมูลพนักงาน โควตา และส่งการแจ้งเตือนผู้อนุมัติอัตโนมัติ

เหมาะสำหรับกรณีที่พนักงานต้องการหนังสือรับรองการทำงานเพื่อใช้สมัครงาน ยื่นวีซ่า หรือเอกสารทางราชการ

Endpoint


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

Request Body

Required Parameters

Parameter	Type	Required	Description	Example
`employee_code`	string	Yes	รหัสพนักงาน	`"EMP001"`
`request_purpose`	string	Yes	วัตถุประสงค์การขอเอกสาร	`"เพื่อใช้สมัครงานใหม่"`
`send_doc_address`	string	Yes	ที่อยู่จัดส่งเอกสาร	`"บริษัท ABC จำกัด"`
`doc_language`	string	Yes	ภาษาของเอกสาร (`TH` หรือ `EN`)	`"TH"`

Optional Parameters

Parameter	Type	Default	Description	Example
`request_topic`	string	`""`	หัวข้อคำขอ	`"ขอหนังสือรับรองการทำงาน"`
`publish_flag`	string	`"N"`	เผยแพร่เอกสาร (`Y`/`N`)	`"N"`

Request Body Example


{
  "employee_code": "EMP001",
  "request_topic": "ขอหนังสือรับรองการทำงาน",
  "request_purpose": "เพื่อใช้สมัครงานใหม่",
  "send_doc_address": "บริษัท ABC จำกัด",
  "doc_language": "TH"
}

Response Format

Success Response (HTTP 200)


{
  "code": 200,
  "message": "สร้างเอกสารรับรองการทำงานสำเร็จ",
  "payload": {
    "work_certificate_letter_id": "20260305WC000000001",
    "employee_id": "20260309462FEF65EFCA",
    "employee_name": "คุณธาวัน รายเดือน",
    "position_name": "นักพัฒนาระบบ",
    "company_name": "บริษัท ตัวอย่าง จำกัด",
    "employee_type_name": "พนักงานประจำ",
    "request_topic": "ขอหนังสือรับรองการทำงาน",
    "request_purpose": "เพื่อใช้สมัครงานใหม่",
    "send_doc_address": "บริษัท ABC จำกัด",
    "document_flow_lv": "01",
    "document_flow_lv_name": "รออนุมัติ",
    "employee_effective_dt": "2024-01-01",
    "emp_effective_sub": "1 มกราคม 2567 จนถึงปัจจุบัน (รวมระยะเวลา 1 ปี 2 เดือน 9 วัน)",
    "emp_until_sub": "ปัจจุบัน",
    "req_dt": "2026-03-09",
    "approve_dt": null,
    "send_doc_dt": null,
    "doc_language": "TH",
    "publish_flag": "N",
    "order_no": null
  }
}

Error Response - Validation Failed (HTTP 422)


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

Error Response - Employee Not Found (HTTP 400)


{
  "code": 400,
  "message": "Employee not found: EMP001"
}

Error Response - Employee Data Incomplete (HTTP 400)


{
  "code": 400,
  "message": "Employee data incomplete: missing 'position_id'"
}

Error Response - Quota Exceeded (HTTP 400)


{
  "code": 400,
  "message": "เกินจำนวนครั้งที่สามารถขอใบรับรองการทำงานได้ในรอบนี้"
}

Response Fields

Field	Type	Nullable	Description
`work_certificate_letter_id`	string	No	รหัสเอกสาร (plain text)
`employee_id`	string	No	รหัสพนักงาน (plain text)
`employee_name`	string	No	ชื่อพนักงาน (ตาม doc_language)
`position_name`	string	No	ชื่อตำแหน่ง (ตาม doc_language)
`company_name`	string	No	ชื่อบริษัท (ตาม doc_language)
`employee_type_name`	string	No	ประเภทพนักงาน (ตาม doc_language)
`request_topic`	string	No	หัวข้อคำขอ
`request_purpose`	string	No	วัตถุประสงค์
`send_doc_address`	string	No	ที่อยู่จัดส่ง
`document_flow_lv`	string	No	สถานะเอกสาร (เริ่มต้น: `"01"`)
`document_flow_lv_name`	string	No	ชื่อสถานะเอกสาร
`employee_effective_dt`	string	Yes	วันที่เริ่มงาน (YYYY-MM-DD)
`emp_effective_sub`	string	No	ข้อความระยะเวลาการทำงาน
`emp_until_sub`	string	No	วันที่สิ้นสุด (`"ปัจจุบัน"` / `"now"`)
`req_dt`	string	No	วันที่ขอเอกสาร (YYYY-MM-DD)
`approve_dt`	string	Yes	วันที่อนุมัติ, `null` ถ้ายังไม่อนุมัติ
`send_doc_dt`	string	Yes	วันที่ส่งเอกสาร, `null` ถ้ายังไม่ส่ง
`doc_language`	string	No	ภาษาเอกสาร (`"TH"` / `"EN"`)
`publish_flag`	string	Yes	สถานะเผยแพร่ (`"Y"` / `"N"`)
`order_no`	integer	Yes	เลขที่เอกสาร, `null` ถ้ายังไม่กำหนด

Code Examples

cURL


curl -X POST "https://openapi.humansoft.co.th/api/v1/open-apis/work-certificate/submit" \
  -H "Ocp-Apim-Subscription-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "employee_code": "EMP001",
    "request_topic": "ขอหนังสือรับรองการทำงาน",
    "request_purpose": "เพื่อใช้สมัครงานใหม่",
    "send_doc_address": "บริษัท ABC จำกัด",
    "doc_language": "TH"
  }'

JavaScript


const response = await fetch(
  'https://openapi.humansoft.co.th/api/v1/open-apis/work-certificate/submit',
  {
    method: 'POST',
    headers: {
      'Ocp-Apim-Subscription-Key': 'YOUR_API_KEY',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      employee_code: 'EMP001',
      request_topic: 'ขอหนังสือรับรองการทำงาน',
      request_purpose: 'เพื่อใช้สมัครงานใหม่',
      send_doc_address: 'บริษัท ABC จำกัด',
      doc_language: 'TH'
    })
  }
)
 
const data = await response.json()
 
if (data.code === 200) {
  console.log('สร้างเอกสารสำเร็จ:', data.payload.work_certificate_letter_id)
} else {
  console.error('Error:', data.errors || data.message)
}

Python


import requests
 
url = "https://openapi.humansoft.co.th/api/v1/open-apis/work-certificate/submit"
headers = {
    "Ocp-Apim-Subscription-Key": "YOUR_API_KEY",
    "Content-Type": "application/json"
}
payload = {
    "employee_code": "EMP001",
    "request_topic": "ขอหนังสือรับรองการทำงาน",
    "request_purpose": "เพื่อใช้สมัครงานใหม่",
    "send_doc_address": "บริษัท ABC จำกัด",
    "doc_language": "TH"
}
 
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/submit";
 
$headers = [
    "Ocp-Apim-Subscription-Key: YOUR_API_KEY",
    "Content-Type: application/json"
];
 
$payload = [
    "employee_code" => "EMP001",
    "request_topic" => "ขอหนังสือรับรองการทำงาน",
    "request_purpose" => "เพื่อใช้สมัครงานใหม่",
    "send_doc_address" => "บริษัท ABC จำกัด",
    "doc_language" => "TH"
];
 
$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

ข้อควรทราบ:

API นี้ใช้ employee_code ไม่ใช่ employee_id
doc_language ต้องเป็น TH หรือ EN (case-insensitive)
ข้อมูลพนักงานต้องครบถ้วน (คำนำหน้า, ตำแหน่ง, บริษัท, ประเภทพนักงาน, วันเริ่มงาน)
ระบบจะตรวจสอบโควตาจำนวนเอกสารในรอบเงินเดือน (ยกเว้น HR user)
หนังสือรับรองการทำงาน ไม่มีข้อมูลเงินเดือน
เอกสารที่สร้างจะเริ่มต้นด้วยสถานะ 01 (รออนุมัติ)

Get List - ดูรายการเอกสารทั้งหมด
Get Detail - ดูรายละเอียดเอกสาร
Update - แก้ไขเอกสารที่รออนุมัติ
Delete - ลบเอกสารที่รออนุมัติ
Approve - อนุมัติ/ปฏิเสธเอกสาร