Skip to Content
🚀 Welcome to Humansoft Open API Documentation

Get Work Certificate Detail

ดึงรายละเอียดเอกสารหนังสือรับรองการทำงานเดียว พร้อมข้อมูลพนักงาน ผู้อนุมัติ สิทธิ์การแก้ไข และข้อมูลองค์กร

เหมาะสำหรับแสดงหน้ารายละเอียดเอกสารบน Mobile App หรือ Web รองรับการแสดงผลทั้งภาษาไทยและภาษาอังกฤษ

Endpoint

GET /api/v1/open-apis/work-certificate/get-detail

Request Parameters

Required Parameters

ParameterTypeRequiredDescriptionExample
work_certificate_letter_idstring (base64)Yesรหัสเอกสาร (base64 encoded)"MjAyNjAzMDVXQzAwMDAwMDAwMQ=="
language_codestringYesภาษาสำหรับแสดงผล (TH หรือ EN)"TH"

Optional Parameters

ParameterTypeDefaultDescriptionExample
authorize_linebooleanfalseเปิดตรวจสอบสิทธิ์ตามสายการอนุมัติ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

FieldTypeNullableDescription
work_certificate_letter_idstringNoรหัสเอกสาร (plain text)
employee_idstringNoรหัสพนักงาน
employee_first_namestringNoชื่อพนักงาน
employee_last_namestringNoนามสกุลพนักงาน
employee_nicknamestringYesชื่อเล่นพนักงาน
photographstringNoURL รูปภาพพนักงาน
employee_type_codestringNoรหัสประเภทพนักงาน
employee_effective_dtstringYesวันที่เริ่มงาน (YYYY-MM-DD)
request_topicstringNoหัวข้อคำขอ
request_purposestringNoวัตถุประสงค์
send_doc_addressstringNoที่อยู่จัดส่ง
document_flow_lvstringNoสถานะเอกสาร
document_flow_lv_namestringNoชื่อสถานะเอกสาร
doc_languagestringNoภาษาเอกสาร
req_dtstringNoวันที่ขอเอกสาร (YYYY-MM-DD)
approve_dtstringYesวันที่อนุมัติ
send_doc_dtstringYesวันที่ส่งเอกสาร
branch_namestringNoชื่อสาขา
department_namestringNoชื่อแผนก
position_namestringNoชื่อตำแหน่ง
company_namestringNoชื่อบริษัท
edit_approvebooleanNoสิทธิ์แก้ไข/อนุมัติ
authorize_flagbooleanNoสิทธิ์อนุมัติตามสายงาน
approve_bystringYesชื่อผู้อนุมัติ
emp_effective_substringNoข้อความระยะเวลาการทำงาน
organizationobjectNoข้อมูลองค์กร (department, branch, company)
auth_{step}_idstringYesรหัสผู้อนุมัติขั้นที่ {step} (step: first, second, third, fourth, fifth)
auth_{step}_namestringYesชื่อผู้อนุมัติ (step: first, second, third, fourth, fifth)
auth_{step}_photographstringYesรูปภาพผู้อนุมัติ (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-5Manager Approved Level 1-5

Code Examples

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 ที่ระบุ (ชื่อพนักงาน, ตำแหน่ง, องค์กร)
  • ถ้าพนักงานลาออกแล้ว ระบบจะแสดงวันที่สิ้นสุดการทำงานแทน “ปัจจุบัน”
  • หนังสือรับรองการทำงาน ไม่มีข้อมูลเงินเดือน
  • Get List - ดูรายการเอกสารเพื่อเลือกดูรายละเอียด
  • Update - แก้ไขเอกสาร
  • Approve - อนุมัติ/ปฏิเสธเอกสาร
  • Export PDF - สร้าง PDF ของเอกสาร
Last updated on