Skip to Content
🚀 Welcome to Humansoft Open API Documentation

Submit Salary Certificate

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

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

Endpoint

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

Request Body

Required Parameters

ParameterTypeRequiredDescriptionExample
employee_codestringYesรหัสพนักงาน"EMP001"
request_purposestringYesวัตถุประสงค์การขอเอกสาร"เพื่อใช้ยื่นกู้ธนาคาร"
send_doc_addressstringYesที่อยู่จัดส่งเอกสาร"ธนาคารกสิกรไทย สาขาสยาม"
doc_languagestringYesภาษาของเอกสาร (TH หรือ EN)"TH"

Optional Parameters

ParameterTypeRequiredDescriptionExample
request_topicstringNoหัวข้อคำขอ"ขอหนังสือรับรองเงินเดือน"
publish_flagstringNoเผยแพร่เอกสาร (Y/N) ค่าเริ่มต้น "N""N"

Request Body Example

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

Response Format

Success Response (HTTP 200)

{ "code": 200, "message": "สร้างเอกสารรับรองเงินเดือนสำเร็จ", "payload": { "salary_certificate_letter_id": "20260305IMP00000001", "employee_id": "20260309462FEF65EFCA", "employee_name": "ธาวัน", "employee_last_name": "รายเดือน", "employee_full_name": "ธาวัน รายเดือน", "salary_amt": "35000.00", "doc_salary_amt": "35000.00", "emp_effective_sub": "1 มกราคม 2567 จนถึงปัจจุบัน (รวมระยะเวลา 1 ปี 2 เดือน 9 วัน)", "emp_until_sub": "ปัจจุบัน", "emp_salary_detail": "(สามหมื่นห้าพันบาทถ้วน) ", "position_name": "นักพัฒนาระบบ", "department_name": "ฝ่ายไอที", "branch_name": "สำนักงานใหญ่", "company_name": "บริษัท ตัวอย่าง จำกัด", "employee_type_name": "พนักงานประจำ", "request_topic": "ขอหนังสือรับรองเงินเดือน", "request_purpose": "เพื่อใช้ยื่นกู้สินเชื่อธนาคาร", "send_doc_address": "ธนาคารกสิกรไทย สาขาสยามพารากอน", "document_flow_lv": "01", "document_flow_lv_name": "รออนุมัติ", "employee_effective_dt": "2024-01-01", "req_dt": "2026-03-09", "approve_dt": null, "send_doc_dt": null, "doc_language": "TH", "doc_header": null, "doc_approver_name": null, "doc_approver_position": null, "approve_name": "", "approve_remark": null, "publish_flag": "N", "order_no": null } }

Error Response - Validation Failed (HTTP 422)

{ "code": 422, "message": "Validation failed", "errors": [ "Missing required parameter: 'employee_code'", "Missing required parameter: 'request_purpose'", "'doc_language' must be 'TH' or 'EN'" ] }

Error Response - Employee Not Found (HTTP 400)

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

Error Response - Employee Data Incomplete (HTTP 400)

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

Error Response - Quota Exceeded (HTTP 400)

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

Response Fields

FieldTypeDescription
salary_certificate_letter_idstringรหัสเอกสาร (20 ตัวอักษร, plain text)
employee_idstringรหัสพนักงาน (20 ตัวอักษร, plain text)
employee_namestringชื่อพนักงาน (ตาม doc_language)
employee_last_namestringนามสกุลพนักงาน (ตาม doc_language)
employee_full_namestringชื่อ-นามสกุลเต็ม
salary_amtstringเงินเดือน (format: "35000.00")
doc_salary_amtstringเงินเดือนในเอกสาร (format: "35000.00")
emp_effective_substringข้อความระยะเวลาการทำงาน
emp_until_substringข้อความวันที่สิ้นสุด
emp_salary_detailstringเงินเดือนเป็นตัวอักษร
position_namestringชื่อตำแหน่ง (ตาม doc_language)
department_namestringชื่อแผนก (ตาม doc_language)
branch_namestringชื่อสาขา (ตาม doc_language)
company_namestringชื่อบริษัท (ตาม doc_language)
employee_type_namestringประเภทพนักงาน (ตาม doc_language)
request_topicstringหัวข้อคำขอ
request_purposestringวัตถุประสงค์
send_doc_addressstringที่อยู่จัดส่ง
document_flow_lvstringสถานะเอกสาร (เริ่มต้น: "01")
document_flow_lv_namestringชื่อสถานะเอกสาร
employee_effective_dtstringวันที่เริ่มงาน (YYYY-MM-DD)
req_dtstringวันที่ขอเอกสาร (YYYY-MM-DD)
approve_dtstring | nullวันที่อนุมัติ, null ถ้ายังไม่อนุมัติ
send_doc_dtstring | nullวันที่ส่งเอกสาร, null ถ้ายังไม่ส่ง
doc_languagestringภาษาเอกสาร ("TH" หรือ "EN")
doc_headerstring | nullประเภท header เอกสาร
doc_approver_namestring | nullชื่อผู้อนุมัติเอกสาร
doc_approver_positionstring | nullตำแหน่งผู้อนุมัติ
approve_namestringรหัสผู้อนุมัติ
approve_remarkstring | nullหมายเหตุการอนุมัติ
publish_flagstring | nullสถานะเผยแพร่ ("Y", "N")
order_nointeger | nullเลขที่เอกสาร

Code Examples

curl -X POST "https://openapi.humansoft.co.th/api/v1/open-apis/salary-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": "ธนาคารกสิกรไทย สาขาสยามพารากอน", "doc_language": "TH" }'

Notes

ข้อควรทราบ:

  • เอกสารที่สร้างจะมีสถานะเริ่มต้นเป็น document_flow_lv = '01' (รออนุมัติ)
  • ระบบจะคำนวณเงินเดือนรวมจากเงินเดือนพื้นฐานและค่าตอบแทนคงที่ที่เกี่ยวข้องอัตโนมัติ
  • อาจมีการจำกัดจำนวนครั้งที่สามารถขอเอกสารในแต่ละรอบเงินเดือน (ยกเว้น HR)
  • doc_language รองรับ TH (ภาษาไทย) และ EN (ภาษาอังกฤษ)
  • ระบบจะส่งการแจ้งเตือนไปยังผู้อนุมัติตามสายการอนุมัติอัตโนมัติ
  • Get List - ดูรายการเอกสารทั้งหมด
  • Get Detail - ดูรายละเอียดเอกสาร
  • Approve - อนุมัติ/ปฏิเสธเอกสาร
  • Delete - ลบเอกสารที่รออนุมัติ
  • Export PDF - สร้างไฟล์ PDF
  • Import - นำเข้าเอกสารจำนวนมาก
Last updated on