Skip to Content
🚀 Welcome to Humansoft Open API Documentation

Salary Summary

ดึงข้อมูลสรุปเงินเดือนของพนักงานในรอบเดือนที่ระบุ แสดงข้อมูลรอบเดือน, สรุปรายรับ-รายจ่าย, และข้อมูลสลิป

Endpoint

GET /api/v1/open-apis/salary/get-data-filter?path_action=salary_summary

Request Parameters

ParameterTypeRequiredDescriptionExample
employee_codestringYesรหัสพนักงาน"EMP001"
year_monthstringYesรอบเงินเดือน (YYYY-MM)"2026-02"
language_codestringNoภาษา: 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

FieldTypeDescription
master_salary_report_idstringรหัสรอบเงินเดือน
master_salary_monthstringรอบเดือน (YYYY-MM)
salary_report_start_dtstringวันที่เริ่มต้นรอบ
salary_report_end_dtstringวันที่สิ้นสุดรอบ
day_in_monthstringจำนวนวันในรอบ
salary_paid_dtstringวันที่จ่ายเงิน
read_only_flagstringสถานะปิดรอบ: "Y" (ปิดแล้ว), "N" (เปิดอยู่)
approve_flagstringสถานะอนุมัติ: "Y" (อนุมัติแล้ว), "N" (ยังไม่อนุมัติ)

Key Response Fields - summary[]

col1Description
รวมการคำนวณเวลายอดรวมจากการคำนวณเวลา (สาย, OT ฯลฯ)
รวมรายรับรวม Income ทั้งหมด
รวมรายจ่ายรวม Expense ทั้งหมด
รวมรายรับรายจ่ายรายรับ - รายจ่าย
เงินเดือนที่ได้รับเงินเดือนสุทธิ
รวมเบิกล่วงหน้ายอดเบิกล่วงหน้า
คงเหลือเงินเดือนสุทธิ - เบิกล่วงหน้า

Key Response Fields - slip

FieldTypeDescription
employee_codestringรหัสพนักงาน
employee_namestringชื่อพนักงาน
company_namestringชื่อบริษัท
department_namestringชื่อแผนก
position_namestringชื่อตำแหน่ง
income_totalstringรายรับรวม (decimal string)
expense_totalstringรายจ่ายรวม (decimal string)
net_totalstringเงินสุทธิ (decimal string)

Error Response

{ "code": 404, "message": "Employee not found with code: 9999", "payload": [] }
HTTP StatusDescription
400พารามิเตอร์ไม่ถูกต้อง เช่น year_month ผิดรูปแบบ
401API Key ไม่ถูกต้องหรือไม่ได้ส่ง
404ไม่พบพนักงาน หรือไม่พบรอบเดือนที่ระบุ

Code Examples

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 บาทเสมอไป

  • Daily In Month - ดูข้อมูลเต็มรวมตารางเวลารายวัน
  • Calculate Month - คำนวณเงินเดือน ควรเรียกก่อน salary_summary
  • Slip Normal - ดูสลิปเงินเดือนแบบ PDF
  • Current Month - ดูรอบเดือนปัจจุบัน เพื่อหา year_month
Last updated on