Get Extra Round Detail
ดึงรายละเอียดทั้งหมดของงวดพิเศษ รวมถึงรายชื่อพนักงาน ประเภทรายรับ รายจ่าย ข้อมูลภาษี และการตั้งค่าทศนิยม
Endpoint
GET /api/v1/open-apis/salary/get-data-filter?path_action=get_extra_roundRequest Parameters
| Parameter | Type | Required | Description | Example |
|---|---|---|---|---|
master_salary_xtra_report_id | string | Yes | รหัสงวดพิเศษ (Base64 encoded) | "MjAyNTAzMjM5NzQxNDI=" |
language_code | string | No | ภาษา: 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
| Field | Type | Description |
|---|---|---|
month | object | ข้อมูลภาพรวมของงวดพิเศษ |
month.master_salary_xtra_report_id | string | รหัสงวดพิเศษ (plain text) |
month.master_salary_xtra_name | string | ชื่องวดพิเศษ |
month.salary_paid_dt | string | วันที่จ่ายเงิน (YYYY-MM-DD) |
month.read_only_flag | string | สถานะงวด: Y = ปิดแล้ว, N = เปิดอยู่ |
employee_lists | array | รายชื่อพนักงานและข้อมูล Slip ของแต่ละคน |
income_lists | array | ประเภทรายรับที่ใช้ได้ในงวดพิเศษ |
expense_lists | array | ประเภทรายจ่ายที่ใช้ได้ในงวดพิเศษ |
tax_lists | array | ประเภทการหักภาษี |
master_config | object | การตั้งค่าหลัก (เช่น จำนวนทศนิยม) |
Error Response
{
"code": 500,
"message": "Extra round not found",
"payload": []
}Code Examples
cURL
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
Related APIs
- Save Extra Paid Date - อัปเดตวันที่จ่ายเงิน
- Save Extra Round - บันทึกข้อมูลรายรับรายจ่ายของพนักงาน
Last updated on