Get Work Certificate Detail
ดึงรายละเอียดเอกสารหนังสือรับรองการทำงานเดียว พร้อมข้อมูลพนักงาน ผู้อนุมัติ สิทธิ์การแก้ไข และข้อมูลองค์กร
เหมาะสำหรับแสดงหน้ารายละเอียดเอกสารบน Mobile App หรือ Web รองรับการแสดงผลทั้งภาษาไทยและภาษาอังกฤษ
Endpoint
GET /api/v1/open-apis/work-certificate/get-detailRequest Parameters
Required Parameters
| Parameter | Type | Required | Description | Example |
|---|---|---|---|---|
work_certificate_letter_id | string (base64) | Yes | รหัสเอกสาร (base64 encoded) | "MjAyNjAzMDVXQzAwMDAwMDAwMQ==" |
language_code | string | Yes | ภาษาสำหรับแสดงผล (TH หรือ EN) | "TH" |
Optional Parameters
| Parameter | Type | Default | Description | Example |
|---|---|---|---|---|
authorize_line | boolean | false | เปิดตรวจสอบสิทธิ์ตามสายการอนุมัติ | true |
Response Format
Success Response (HTTP 200)
{
"code": 200,
"message": "Success",
"payload": {
"work_certificate_letter_id": "20260305WC000000001",
"employee_id": "20260309462FEF65EFCA",
"employee_first_name": "ธาวัน",
"employee_last_name": "รายเดือน",
"employee_nickname": "วัน",
"photograph": "images/userPlaceHolder.png",
"employee_type_code": "01",
"employee_effective_dt": "2024-01-01",
"request_topic": "ขอหนังสือรับรองการทำงาน",
"request_purpose": "เพื่อใช้สมัครงานใหม่",
"send_doc_address": "บริษัท ABC จำกัด",
"document_flow_lv": "01",
"document_flow_lv_name": "รออนุมัติ",
"doc_language": "TH",
"req_dt": "2026-03-09",
"approve_dt": null,
"send_doc_dt": null,
"branch_name": "สำนักงานใหญ่",
"department_name": "ฝ่ายไอที",
"position_name": "นักพัฒนาระบบ",
"company_name": "บริษัท ตัวอย่าง จำกัด",
"edit_approve": true,
"authorize_flag": true,
"approve_flag_name": "รออนุมัติ",
"approve_by": "สมชาย ผู้จัดการ",
"emp_effective_sub": "1 มกราคม 2567 จนถึงปัจจุบัน",
"organization": {
"department": { "label": "แผนก", "value": "ฝ่ายไอที" },
"branch": { "label": "สาขา", "value": "สำนักงานใหญ่" },
"company": { "label": "บริษัท", "value": "บริษัท ตัวอย่าง จำกัด" }
},
"auth_first_id": "20240101APPROVER001",
"auth_first_code": "MGR001",
"auth_first_name": "สมชาย",
"auth_first_last_name": "ผู้จัดการ",
"auth_first_nickname": "ชาย",
"auth_first_photograph": "images/userPlaceHolder.png"
}
}Error Response - Validation Failed (HTTP 400)
{
"code": 400,
"message": "Validation failed",
"errors": ["'work_certificate_letter_id' is required"]
}Error Response - Document Not Found (HTTP 400)
{
"code": 400,
"message": "ไม่สำเร็จ",
"error": "Document not found"
}Response Fields
| Field | Type | Nullable | Description |
|---|---|---|---|
work_certificate_letter_id | string | No | รหัสเอกสาร (plain text) |
employee_id | string | No | รหัสพนักงาน |
employee_first_name | string | No | ชื่อพนักงาน |
employee_last_name | string | No | นามสกุลพนักงาน |
employee_nickname | string | Yes | ชื่อเล่นพนักงาน |
photograph | string | No | URL รูปภาพพนักงาน |
employee_type_code | string | No | รหัสประเภทพนักงาน |
employee_effective_dt | string | Yes | วันที่เริ่มงาน (YYYY-MM-DD) |
request_topic | string | No | หัวข้อคำขอ |
request_purpose | string | No | วัตถุประสงค์ |
send_doc_address | string | No | ที่อยู่จัดส่ง |
document_flow_lv | string | No | สถานะเอกสาร |
document_flow_lv_name | string | No | ชื่อสถานะเอกสาร |
doc_language | string | No | ภาษาเอกสาร |
req_dt | string | No | วันที่ขอเอกสาร (YYYY-MM-DD) |
approve_dt | string | Yes | วันที่อนุมัติ |
send_doc_dt | string | Yes | วันที่ส่งเอกสาร |
branch_name | string | No | ชื่อสาขา |
department_name | string | No | ชื่อแผนก |
position_name | string | No | ชื่อตำแหน่ง |
company_name | string | No | ชื่อบริษัท |
edit_approve | boolean | No | สิทธิ์แก้ไข/อนุมัติ |
authorize_flag | boolean | No | สิทธิ์อนุมัติตามสายงาน |
approve_by | string | Yes | ชื่อผู้อนุมัติ |
emp_effective_sub | string | No | ข้อความระยะเวลาการทำงาน |
organization | object | No | ข้อมูลองค์กร (department, branch, company) |
auth_{step}_id | string | Yes | รหัสผู้อนุมัติขั้นที่ {step} (step: first, second, third, fourth, fifth) |
auth_{step}_name | string | Yes | ชื่อผู้อนุมัติ (step: first, second, third, fourth, fifth) |
auth_{step}_photograph | string | Yes | รูปภาพผู้อนุมัติ (step: first, second, third, fourth, fifth) |
Document Flow Level Values
| Value | ความหมาย (TH) | ความหมาย (EN) |
|---|---|---|
01 | รออนุมัติ | Pending Approval |
02 | อนุมัติแล้ว | Approved |
03 | ไม่อนุมัติ | Not Approved |
04 | ส่งเอกสารแล้ว | Sent Document |
05 | ได้รับเอกสารแล้ว | Receive Document |
06 | ตรวจสอบอีกครั้ง | Recheck |
07-11 | หัวหน้าอนุมัติขั้นที่ 1-5 | Manager Approved Level 1-5 |
Code Examples
cURL
curl -X GET "https://openapi.humansoft.co.th/api/v1/open-apis/work-certificate/get-detail?work_certificate_letter_id=MjAyNjAzMDVXQzAwMDAwMDAwMQ==&language_code=TH" \
-H "Ocp-Apim-Subscription-Key: YOUR_API_KEY" \
-H "Content-Type: application/json"Notes
ข้อควรทราบ:
work_certificate_letter_idใน request ต้องเข้ารหัส base64, ใน response เป็น plain text- ฟิลด์
auth_\{step\}_*จะมีเฉพาะเมื่อใช้ Multi-Level Approval - ข้อมูลจะแสดงตาม
language_codeที่ระบุ (ชื่อพนักงาน, ตำแหน่ง, องค์กร) - ถ้าพนักงานลาออกแล้ว ระบบจะแสดงวันที่สิ้นสุดการทำงานแทน “ปัจจุบัน”
- หนังสือรับรองการทำงาน ไม่มีข้อมูลเงินเดือน
Related APIs
- Get List - ดูรายการเอกสารเพื่อเลือกดูรายละเอียด
- Update - แก้ไขเอกสาร
- Approve - อนุมัติ/ปฏิเสธเอกสาร
- Export PDF - สร้าง PDF ของเอกสาร
Last updated on