Skip to Content
🚀 Welcome to Humansoft Open API Documentation

Get Extra Round Detail

ดึงรายละเอียดทั้งหมดของงวดพิเศษ รวมถึงรายชื่อพนักงาน ประเภทรายรับ รายจ่าย ข้อมูลภาษี และการตั้งค่าทศนิยม

Endpoint

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

Request Parameters

ParameterTypeRequiredDescriptionExample
master_salary_xtra_report_idstringYesรหัสงวดพิเศษ (Base64 encoded)"MjAyNTAzMjM5NzQxNDI="
language_codestringNoภาษา: TH หรือ EN (ค่าเริ่มต้น: TH)"TH"

Response Format

Success Response

{ "code": 200, "message": "Extra Round Details Retrieved Successfully", "payload": { "month": { "master_salary_xtra_report_id": "20250323974142", "master_salary_xtra_name": "โบนัสไตรมาส1", "salary_paid_dt": "2026-03-31", "read_only_flag": "N" }, "employee_lists": [ { "employee_id": "1001", "employee_name": "สมชาย", "employee_last_name": "ใจดี", "company_name": "HumanSoft" } ], "income_lists": [ { "salary_type_id": "INC-01", "salary_type_name": "โบนัสพิเศษ" } ], "expense_lists": [ { "salary_type_id": "EXP-01", "salary_type_name": "หักวันขาด" } ], "tax_lists": [ { "salary_type_id": "TAX-01", "salary_type_name": "ภาษีหัก ณ ที่จ่าย" } ], "master_config": { "decimal": "2" } } }

Response Fields

FieldTypeDescription
monthobjectข้อมูลภาพรวมของงวดพิเศษ
month.master_salary_xtra_report_idstringรหัสงวดพิเศษ (plain text)
month.master_salary_xtra_namestringชื่องวดพิเศษ
month.salary_paid_dtstringวันที่จ่ายเงิน (YYYY-MM-DD)
month.read_only_flagstringสถานะงวด: Y = ปิดแล้ว, N = เปิดอยู่
employee_listsarrayรายชื่อพนักงานและข้อมูล Slip ของแต่ละคน
income_listsarrayประเภทรายรับที่ใช้ได้ในงวดพิเศษ
expense_listsarrayประเภทรายจ่ายที่ใช้ได้ในงวดพิเศษ
tax_listsarrayประเภทการหักภาษี
master_configobjectการตั้งค่าหลัก (เช่น จำนวนทศนิยม)

Error Response

{ "code": 500, "message": "Extra round not found", "payload": [] }

Code Examples

curl -X GET "https://openapi.humansoft.co.th/api/v1/open-apis/salary/get-data-filter?path_action=get_extra_round&master_salary_xtra_report_id=MjAyNTAzMjM5NzQxNDI=&language_code=TH" \ -H "Ocp-Apim-Subscription-Key: YOUR_API_KEY"

Notes

  • ข้อมูล income_lists และ expense_lists ที่ได้รับสามารถนำไปใช้เป็นตัวเลือกเมื่อบันทึกข้อมูลด้วย Save Extra Round
  • ค่า salary_type_id ใน income/expense lists เป็น plain text สำหรับนำไปใช้ต้อง encode เป็น Base64

  • Save Extra Paid Date - อัปเดตวันที่จ่ายเงิน
  • Save Extra Round - บันทึกข้อมูลรายรับรายจ่ายของพนักงาน
Last updated on