Skip to Content
🚀 Welcome to Humansoft Open API Documentation

Get Salary Certificate Detail

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

ใช้ API นี้เพื่อดูรายละเอียดเอกสารหนังสือรับรองเงินเดือนตาม ID ที่ระบุ เหมาะสำหรับแสดงหน้ารายละเอียดเอกสารบน Mobile App หรือ Web

Endpoint

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

Request Body

Required Parameters

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

Optional Parameters

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

FieldTypeDescription
salary_certificate_letter_idstringรหัสเอกสาร (20 ตัวอักษร, plain text)
employee_idstringรหัสพนักงาน (20 ตัวอักษร, plain text)
employee_first_namestringชื่อพนักงาน
employee_last_namestringนามสกุลพนักงาน
employee_nicknamestring | nullชื่อเล่นพนักงาน
photographstringURL รูปภาพพนักงาน
employee_type_codestringรหัสประเภทพนักงาน ("01" รายเดือน, "02" รายวัน, "03" รายชั่วโมง)
salarystringเงินเดือนพื้นฐาน
salary_amtstringเงินเดือนรวม (format: "35,000.00")
employee_effective_dtstring | nullวันที่เริ่มงาน (YYYY-MM-DD)
request_topicstring | nullหัวข้อคำขอ
request_purposestring | nullวัตถุประสงค์
send_doc_addressstring | nullที่อยู่จัดส่งเอกสาร
document_flow_lvstringสถานะเอกสาร
document_flow_lv_namestringชื่อสถานะเอกสาร
doc_languagestringภาษาเอกสาร ("TH" หรือ "EN")
req_dtstring | nullวันที่ขอเอกสาร (YYYY-MM-DD)
approve_dtstring | nullวันที่อนุมัติ
send_doc_dtstring | nullวันที่ส่งเอกสาร
branch_namestring | nullชื่อสาขา
department_namestring | nullชื่อแผนก
position_namestring | nullชื่อตำแหน่ง
company_namestring | nullชื่อบริษัท
edit_approvebooleanสิทธิ์แก้ไข/อนุมัติ
authorize_flagbooleanสิทธิ์อนุมัติตามสายงาน
approve_flag_namestringชื่อสถานะอนุมัติ
approve_bystring | nullชื่อผู้อนุมัติ
salary_until_dtstringวันที่สิ้นสุดสำหรับคำนวณ
emp_salary_detailstringเงินเดือนเป็นตัวอักษร
emp_effective_substringข้อความระยะเวลาการทำงาน
organizationobjectข้อมูลองค์กร (department, branch, company)
auth_{step}_idstring | nullรหัสผู้อนุมัติขั้นที่ {step} (step: first, second, third, fourth, fifth)
auth_{step}_codestring | nullรหัสพนักงานผู้อนุมัติ (step: first, second, third, fourth, fifth)
auth_{step}_namestring | nullชื่อผู้อนุมัติ (step: first, second, third, fourth, fifth)
auth_{step}_last_namestring | nullนามสกุลผู้อนุมัติ (step: first, second, third, fourth, fifth)
auth_{step}_nicknamestring | nullชื่อเล่นผู้อนุมัติ (step: first, second, third, fourth, fifth)
auth_{step}_photographstring | nullรูปภาพผู้อนุมัติ (step: first, second, third, fourth, fifth)

Document Flow Status

ValueDescription (TH)Description (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/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 ต้องเข้ารหัส Base64
  • salary_certificate_letter_id ใน response เป็น plain text 20 ตัวอักษร
  • ฟิลด์ auth_\{step\}_* จะมีเฉพาะเมื่อมีผู้อนุมัติในขั้นนั้น (step: first, second, third, fourth, fifth)
  • ฟิลด์ organization แสดงข้อมูลโครงสร้างองค์กรพร้อม label ที่ปรับตามการตั้งค่าขององค์กร
  • ข้อมูลพนักงาน ตำแหน่ง และองค์กรจะเปลี่ยนตาม language_code ที่ระบุ
  • Get List - ดูรายการเอกสารเพื่อเลือกดูรายละเอียด
  • Submit - สร้างเอกสารใหม่
  • Approve - อนุมัติ/ปฏิเสธเอกสาร
  • Delete - ลบเอกสาร
  • Export PDF - สร้าง PDF ของเอกสาร
Last updated on