Get Salary Certificate Detail
ดึงรายละเอียดเอกสารหนังสือรับรองเงินเดือน พร้อมข้อมูลพนักงาน ผู้อนุมัติ สิทธิ์การแก้ไข และข้อมูลองค์กร
ใช้ API นี้เพื่อดูรายละเอียดเอกสารหนังสือรับรองเงินเดือนตาม ID ที่ระบุ เหมาะสำหรับแสดงหน้ารายละเอียดเอกสารบน Mobile App หรือ Web
Endpoint
GET /api/v1/open-apis/salary-certificate/get-detailRequest Body
Required Parameters
| Parameter | Type | Required | Description | Example |
|---|---|---|---|---|
salary_certificate_letter_id | string (base64) | Yes | รหัสเอกสาร (Base64 encoded) | "MjAyNjAzMDU0NjI1RUY2NUVGQ0E=" |
language_code | string | Yes | ภาษาสำหรับแสดงผล (TH หรือ EN) | "TH" |
Optional Parameters
| Parameter | Type | Required | Description | Example |
|---|---|---|---|---|
authorize_line | boolean | No | เปิดตรวจสอบสิทธิ์ตามสายการอนุมัติ | true |
Response Format
Success Response (HTTP 200)
{
"code": 200,
"message": "Success",
"payload": {
"salary_certificate_letter_id": "20260305IMP00000001",
"employee_id": "20260309462FEF65EFCA",
"employee_first_name": "ธาวัน",
"employee_last_name": "รายเดือน",
"employee_nickname": "วัน",
"photograph": "images/userPlaceHolder.png",
"employee_type_code": "01",
"salary": "35000",
"salary_amt": "35,000.00",
"employee_effective_dt": "2024-01-01",
"request_topic": "ขอหนังสือรับรองเงินเดือน",
"request_purpose": "เพื่อใช้ยื่นกู้สินเชื่อธนาคาร",
"send_doc_address": "ธนาคารกสิกรไทย สาขาสยาม",
"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": "สมชาย ผู้จัดการ",
"salary_until_dt": "2026-03-09",
"emp_salary_detail": "(สามหมื่นห้าพันบาทถ้วน) ",
"emp_effective_sub": "1 มกราคม 2567 จนถึงปัจจุบัน (รวมระยะเวลา 1 ปี 2 เดือน 9 วัน)",
"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": [
"'salary_certificate_letter_id' is required"
]
}Error Response - Document Not Found (HTTP 400)
{
"code": 400,
"message": "ไม่สำเร็จ",
"error": "Document not found"
}Response Fields
| Field | Type | Description |
|---|---|---|
salary_certificate_letter_id | string | รหัสเอกสาร (20 ตัวอักษร, plain text) |
employee_id | string | รหัสพนักงาน (20 ตัวอักษร, plain text) |
employee_first_name | string | ชื่อพนักงาน |
employee_last_name | string | นามสกุลพนักงาน |
employee_nickname | string | null | ชื่อเล่นพนักงาน |
photograph | string | URL รูปภาพพนักงาน |
employee_type_code | string | รหัสประเภทพนักงาน ("01" รายเดือน, "02" รายวัน, "03" รายชั่วโมง) |
salary | string | เงินเดือนพื้นฐาน |
salary_amt | string | เงินเดือนรวม (format: "35,000.00") |
employee_effective_dt | string | null | วันที่เริ่มงาน (YYYY-MM-DD) |
request_topic | string | null | หัวข้อคำขอ |
request_purpose | string | null | วัตถุประสงค์ |
send_doc_address | string | null | ที่อยู่จัดส่งเอกสาร |
document_flow_lv | string | สถานะเอกสาร |
document_flow_lv_name | string | ชื่อสถานะเอกสาร |
doc_language | string | ภาษาเอกสาร ("TH" หรือ "EN") |
req_dt | string | null | วันที่ขอเอกสาร (YYYY-MM-DD) |
approve_dt | string | null | วันที่อนุมัติ |
send_doc_dt | string | null | วันที่ส่งเอกสาร |
branch_name | string | null | ชื่อสาขา |
department_name | string | null | ชื่อแผนก |
position_name | string | null | ชื่อตำแหน่ง |
company_name | string | null | ชื่อบริษัท |
edit_approve | boolean | สิทธิ์แก้ไข/อนุมัติ |
authorize_flag | boolean | สิทธิ์อนุมัติตามสายงาน |
approve_flag_name | string | ชื่อสถานะอนุมัติ |
approve_by | string | null | ชื่อผู้อนุมัติ |
salary_until_dt | string | วันที่สิ้นสุดสำหรับคำนวณ |
emp_salary_detail | string | เงินเดือนเป็นตัวอักษร |
emp_effective_sub | string | ข้อความระยะเวลาการทำงาน |
organization | object | ข้อมูลองค์กร (department, branch, company) |
auth_{step}_id | string | null | รหัสผู้อนุมัติขั้นที่ {step} (step: first, second, third, fourth, fifth) |
auth_{step}_code | string | null | รหัสพนักงานผู้อนุมัติ (step: first, second, third, fourth, fifth) |
auth_{step}_name | string | null | ชื่อผู้อนุมัติ (step: first, second, third, fourth, fifth) |
auth_{step}_last_name | string | null | นามสกุลผู้อนุมัติ (step: first, second, third, fourth, fifth) |
auth_{step}_nickname | string | null | ชื่อเล่นผู้อนุมัติ (step: first, second, third, fourth, fifth) |
auth_{step}_photograph | string | null | รูปภาพผู้อนุมัติ (step: first, second, third, fourth, fifth) |
Document Flow Status
| Value | Description (TH) | Description (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/salary-certificate/get-detail?salary_certificate_letter_id=MjAyNjAzMDU0NjI1RUY2NUVGQ0E=&language_code=TH" \
-H "Ocp-Apim-Subscription-Key: YOUR_API_KEY" \
-H "Content-Type: application/json"Notes
ข้อควรทราบ:
salary_certificate_letter_idใน request ต้องเข้ารหัส Base64salary_certificate_letter_idใน response เป็น plain text 20 ตัวอักษร- ฟิลด์
auth_\{step\}_*จะมีเฉพาะเมื่อมีผู้อนุมัติในขั้นนั้น (step: first, second, third, fourth, fifth) - ฟิลด์
organizationแสดงข้อมูลโครงสร้างองค์กรพร้อม label ที่ปรับตามการตั้งค่าขององค์กร - ข้อมูลพนักงาน ตำแหน่ง และองค์กรจะเปลี่ยนตาม
language_codeที่ระบุ
Related APIs
- Get List - ดูรายการเอกสารเพื่อเลือกดูรายละเอียด
- Submit - สร้างเอกสารใหม่
- Approve - อนุมัติ/ปฏิเสธเอกสาร
- Delete - ลบเอกสาร
- Export PDF - สร้าง PDF ของเอกสาร
Last updated on