Salary Summary
ดึงข้อมูลสรุปเงินเดือนของพนักงานในรอบเดือนที่ระบุ แสดงข้อมูลรอบเดือน, สรุปรายรับ-รายจ่าย, และข้อมูลสลิป
Endpoint
GET /api/v1/open-apis/salary/get-data-filter?path_action=salary_summaryRequest Parameters
| Parameter | Type | Required | Description | Example |
|---|---|---|---|---|
employee_code | string | Yes | รหัสพนักงาน | "EMP001" |
year_month | string | Yes | รอบเงินเดือน (YYYY-MM) | "2026-02" |
language_code | string | No | ภาษา: TH หรือ EN (ค่าเริ่มต้น: TH) | "TH" |
ก่อนเรียก API นี้ ควรเรียก Calculate Month ก่อน เพื่อให้ข้อมูลสรุปเป็นปัจจุบัน
Response Format
Success Response
{
"code": 200,
"message": "Success",
"payload": {
"month": {
"master_salary_report_id": "202601286709D2934361",
"master_salary_month": "2026-02",
"salary_report_start_dt": "2026-01-26 00:00:00",
"salary_report_end_dt": "2026-02-25 23:59:59",
"day_in_month": "31",
"salary_paid_dt": "2026-02-28",
"read_only_flag": "N",
"approve_flag": "N"
},
"summary": [
{ "col1": "รวมการคำนวณเวลา", "col2": 0 },
{ "col1": "รวมรายรับ", "col2": 35000 },
{ "col1": "รวมรายจ่าย", "col2": 1750 },
{ "col1": "รวมรายรับรายจ่าย", "col2": 33250 },
{ "col1": "เงินเดือนที่ได้รับ", "col2": 33250 },
{ "col1": "รวมเบิกล่วงหน้า", "col2": 0 },
{ "col1": "คงเหลือ", "col2": 33250 }
],
"slip": {
"salary_slip_id": "20260228SLIP000001",
"master_salary_report_id": "202601286709D2934361",
"employee_id": "20260121FC89F3BB9120",
"employee_code": "EMP001",
"employee_name": "สมชาย",
"employee_last_name": "ใจดี",
"company_name": "บริษัท ตัวอย่าง จำกัด",
"branch_name": "สำนักงานใหญ่",
"department_name": "ฝ่ายพัฒนา",
"position_name": "โปรแกรมเมอร์",
"salary_start_dt": "2026-01-26",
"salary_end_dt": "2026-02-25",
"salary_paid_dt": "2026-02-28",
"income_total": "35000.00",
"expense_total": "1750.00",
"net_total": "33250.00"
}
}
}Key Response Fields - month
| Field | Type | Description |
|---|---|---|
master_salary_report_id | string | รหัสรอบเงินเดือน |
master_salary_month | string | รอบเดือน (YYYY-MM) |
salary_report_start_dt | string | วันที่เริ่มต้นรอบ |
salary_report_end_dt | string | วันที่สิ้นสุดรอบ |
day_in_month | string | จำนวนวันในรอบ |
salary_paid_dt | string | วันที่จ่ายเงิน |
read_only_flag | string | สถานะปิดรอบ: "Y" (ปิดแล้ว), "N" (เปิดอยู่) |
approve_flag | string | สถานะอนุมัติ: "Y" (อนุมัติแล้ว), "N" (ยังไม่อนุมัติ) |
Key Response Fields - summary[]
| col1 | Description |
|---|---|
| รวมการคำนวณเวลา | ยอดรวมจากการคำนวณเวลา (สาย, OT ฯลฯ) |
| รวมรายรับ | รวม Income ทั้งหมด |
| รวมรายจ่าย | รวม Expense ทั้งหมด |
| รวมรายรับรายจ่าย | รายรับ - รายจ่าย |
| เงินเดือนที่ได้รับ | เงินเดือนสุทธิ |
| รวมเบิกล่วงหน้า | ยอดเบิกล่วงหน้า |
| คงเหลือ | เงินเดือนสุทธิ - เบิกล่วงหน้า |
Key Response Fields - slip
| Field | Type | Description |
|---|---|---|
employee_code | string | รหัสพนักงาน |
employee_name | string | ชื่อพนักงาน |
company_name | string | ชื่อบริษัท |
department_name | string | ชื่อแผนก |
position_name | string | ชื่อตำแหน่ง |
income_total | string | รายรับรวม (decimal string) |
expense_total | string | รายจ่ายรวม (decimal string) |
net_total | string | เงินสุทธิ (decimal string) |
Error Response
{
"code": 404,
"message": "Employee not found with code: 9999",
"payload": []
}| HTTP Status | Description |
|---|---|
400 | พารามิเตอร์ไม่ถูกต้อง เช่น year_month ผิดรูปแบบ |
401 | API Key ไม่ถูกต้องหรือไม่ได้ส่ง |
404 | ไม่พบพนักงาน หรือไม่พบรอบเดือนที่ระบุ |
Code Examples
cURL
curl -X GET "https://openapi.humansoft.co.th/api/v1/open-apis/salary/get-data-filter?path_action=salary_summary&employee_code=EMP001&year_month=2026-02&language_code=TH" \
-H "Ocp-Apim-Subscription-Key: YOUR_API_KEY"Notes
- API นี้ส่งข้อมูลเบากว่า
daily_in_monthเพราะส่งเฉพาะ month, summary, slip - เหมาะสำหรับ Dashboard หรือ Summary view ที่ต้องการข้อมูลเบา
summary[].col2 = 0อาจหมายถึงยังไม่ได้คำนวณ ไม่ใช่ 0 บาทเสมอไป
Related APIs
- Daily In Month - ดูข้อมูลเต็มรวมตารางเวลารายวัน
- Calculate Month - คำนวณเงินเดือน ควรเรียกก่อน salary_summary
- Slip Normal - ดูสลิปเงินเดือนแบบ PDF
- Current Month - ดูรอบเดือนปัจจุบัน เพื่อหา year_month
Last updated on