Submit Salary Certificate
สร้างคำขอหนังสือรับรองเงินเดือนใหม่ ระบบจะคำนวณเงินเดือนรวม ตรวจสอบโควตา และส่งการแจ้งเตือนผู้อนุมัติอัตโนมัติ
ใช้ API นี้เพื่อสร้างคำขอหนังสือรับรองเงินเดือน เหมาะสำหรับกรณีที่พนักงานต้องการหนังสือรับรองเพื่อยื่นกู้ ยื่นวีซ่า หรือเอกสารทางราชการ
Endpoint
POST /api/v1/open-apis/salary-certificate/submitRequest Body
Required Parameters
| Parameter | Type | Required | Description | Example |
|---|---|---|---|---|
employee_code | string | Yes | รหัสพนักงาน | "EMP001" |
request_purpose | string | Yes | วัตถุประสงค์การขอเอกสาร | "เพื่อใช้ยื่นกู้ธนาคาร" |
send_doc_address | string | Yes | ที่อยู่จัดส่งเอกสาร | "ธนาคารกสิกรไทย สาขาสยาม" |
doc_language | string | Yes | ภาษาของเอกสาร (TH หรือ EN) | "TH" |
Optional Parameters
| Parameter | Type | Required | Description | Example |
|---|---|---|---|---|
request_topic | string | No | หัวข้อคำขอ | "ขอหนังสือรับรองเงินเดือน" |
publish_flag | string | No | เผยแพร่เอกสาร (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
| Field | Type | Description |
|---|---|---|
salary_certificate_letter_id | string | รหัสเอกสาร (20 ตัวอักษร, plain text) |
employee_id | string | รหัสพนักงาน (20 ตัวอักษร, plain text) |
employee_name | string | ชื่อพนักงาน (ตาม doc_language) |
employee_last_name | string | นามสกุลพนักงาน (ตาม doc_language) |
employee_full_name | string | ชื่อ-นามสกุลเต็ม |
salary_amt | string | เงินเดือน (format: "35000.00") |
doc_salary_amt | string | เงินเดือนในเอกสาร (format: "35000.00") |
emp_effective_sub | string | ข้อความระยะเวลาการทำงาน |
emp_until_sub | string | ข้อความวันที่สิ้นสุด |
emp_salary_detail | string | เงินเดือนเป็นตัวอักษร |
position_name | string | ชื่อตำแหน่ง (ตาม doc_language) |
department_name | string | ชื่อแผนก (ตาม doc_language) |
branch_name | string | ชื่อสาขา (ตาม doc_language) |
company_name | string | ชื่อบริษัท (ตาม doc_language) |
employee_type_name | string | ประเภทพนักงาน (ตาม doc_language) |
request_topic | string | หัวข้อคำขอ |
request_purpose | string | วัตถุประสงค์ |
send_doc_address | string | ที่อยู่จัดส่ง |
document_flow_lv | string | สถานะเอกสาร (เริ่มต้น: "01") |
document_flow_lv_name | string | ชื่อสถานะเอกสาร |
employee_effective_dt | string | วันที่เริ่มงาน (YYYY-MM-DD) |
req_dt | string | วันที่ขอเอกสาร (YYYY-MM-DD) |
approve_dt | string | null | วันที่อนุมัติ, null ถ้ายังไม่อนุมัติ |
send_doc_dt | string | null | วันที่ส่งเอกสาร, null ถ้ายังไม่ส่ง |
doc_language | string | ภาษาเอกสาร ("TH" หรือ "EN") |
doc_header | string | null | ประเภท header เอกสาร |
doc_approver_name | string | null | ชื่อผู้อนุมัติเอกสาร |
doc_approver_position | string | null | ตำแหน่งผู้อนุมัติ |
approve_name | string | รหัสผู้อนุมัติ |
approve_remark | string | null | หมายเหตุการอนุมัติ |
publish_flag | string | null | สถานะเผยแพร่ ("Y", "N") |
order_no | integer | null | เลขที่เอกสาร |
Code Examples
cURL
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(ภาษาอังกฤษ)- ระบบจะส่งการแจ้งเตือนไปยังผู้อนุมัติตามสายการอนุมัติอัตโนมัติ
Related APIs
- Get List - ดูรายการเอกสารทั้งหมด
- Get Detail - ดูรายละเอียดเอกสาร
- Approve - อนุมัติ/ปฏิเสธเอกสาร
- Delete - ลบเอกสารที่รออนุมัติ
- Export PDF - สร้างไฟล์ PDF
- Import - นำเข้าเอกสารจำนวนมาก
Last updated on