Get Employee Tax Details

ดึงรายละเอียดภาษีของพนักงานสำหรับปีภาษีที่ระบุ (เงินเดือนสะสม, กองทุนฯ, ประกันสังคม, รายการลดหย่อน step1/2/3, income/expense)

Endpoint


GET /api/v1/open-apis/employee/get-employee-data-filter?path_action=get-tax

Query Parameters

Parameter	Type	Required	Description
`path_action`	string	Yes	ต้องเป็น `get-tax`
`employee_code`	string	Yes	รหัสพนักงาน
`year`	string	Yes	ปีภาษี (ค.ศ.) เช่น `2024`

Response Format

Success Response


{
  "code": 200,
  "message": "สำเร็จ",
  "payload": {
    "company_id": "20241225C3024958C974",
    "branch_id": "202412254358646B34E4",
    "department_id": "20241225F520AC8456ED",
    "employee_id": "20260121FC89F3BB9120",
    "tax_payment_dt": "2026-01-31",
    "tax_type_id": "3",
    "tax_month_code": "01",
    "tax_year_code": "2026",
    "at_month_name": "มกราคม 2026",
    "forcash_salary_summary": 425550,
    "estimated_salary": 385000,
    "past_salary_summary": 0,
    "salary_summary": 40550,
    "year_salary_summary": 0,
    "cnt_month": 0,
    "forcash_cat7_summary": 12600,
    "past_cat7_summary": 0,
    "cat7_summary": 1050,
    "year_cat7_summary": 0,
    "forcash_cat17_summary": 10500,
    "past_cat17_summary": 0,
    "cat17_summary": 875,
    "year_cat17_summary": 0,
    "exemption_summary_step1": 100000,
    "exemption_summary_step2": "60000.00",
    "exemption_summary_step3": 0,
    "income": {
      "total": null
    },
    "expense": {
      "total": null
    },
    "incomeType2": {
      "total": 0
    },
    "expenseType2": {
      "total": 0
    },
    "tax_method_lv": "01"
  }
}

Response Fields

Field	Type	Description
`code`	number	`200` = สำเร็จ
`message`	string	ข้อความตอบกลับ
`payload`	object	ข้อมูลภาษีหนึ่งปี
`payload.company_id`	string	รหัสบริษัท
`payload.branch_id`	string	รหัสสาขา
`payload.department_id`	string	รหัสแผนก
`payload.employee_id`	string	รหัสพนักงาน
`payload.tax_payment_dt`	string	วันที่จ่ายภาษี (Y-m-d)
`payload.tax_type_id`	string	ประเภทภาษี
`payload.tax_month_code`	string	เดือนภาษี (01-12)
`payload.tax_year_code`	string	ปีภาษี (ค.ศ.)
`payload.at_month_name`	string	ชื่อเดือนแสดงผล
`payload.forcash_salary_summary`	number	เงินเดือนสะสม (คาดการณ์)
`payload.estimated_salary`	number	เงินเดือนโดยประมาณ
`payload.past_salary_summary`	number	เงินเดือนสะสมก่อนหน้า
`payload.salary_summary`	number	เงินเดือนสรุป
`payload.year_salary_summary`	number	เงินเดือนสรุปทั้งปี
`payload.cnt_month`	number	จำนวนเดือน
`payload.forcash_cat7_summary`	number	กองทุนสำรองเลี้ยงชีพ (หักสูงสุด 500,000)
`payload.past_cat7_summary`	number	กองทุนฯ ก่อนหน้า
`payload.cat7_summary`	number	กองทุนฯ สรุป
`payload.year_cat7_summary`	number	กองทุนฯ สรุปทั้งปี
`payload.forcash_cat17_summary`	number	ประกันสังคมสะสม
`payload.past_cat17_summary`	number	ประกันสังคมก่อนหน้า
`payload.cat17_summary`	number	ประกันสังคมสรุป
`payload.year_cat17_summary`	number	ประกันสังคมสรุปทั้งปี
`payload.exemption_summary_step1`	number	รายการลดหย่อนขั้นที่ 1 (สูงสุด 100,000)
`payload.exemption_summary_step2`	number	รายการลดหย่อนขั้นที่ 2
`payload.exemption_summary_step3`	number	รายการลดหย่อนขั้นที่ 3
`payload.income`	object	รายรับ (ค่าคงที่)
`payload.expense`	object	รายจ่าย (ค่าคงที่)
`payload.incomeType2`	object	รายรับประเภท 2
`payload.expenseType2`	object	รายจ่ายประเภท 2
`payload.tax_method_lv`	string	ระดับวิธีคำนวณภาษี

Error Responses

Missing employee_code:


{
  "code": 400,
  "message": "ไม่สำเร็จ",
  "error": "Missing required parameter: employee_code"
}

Missing year:


{
  "code": 400,
  "message": "ไม่สำเร็จ",
  "error": "Missing required parameter: year (tax year, e.g. 2024)"
}

Employee Not Found:


{
  "code": 400,
  "message": "ไม่สำเร็จ",
  "error": "Employee not found with code: EMP999"
}

No Salary Slip:


{
  "code": 400,
  "message": "ไม่สำเร็จ",
  "error": "No salary slip found for employee in year: 2024"
}

Code Examples

cURL


curl -X GET "https://openapi.humansoft.co.th/api/v1/open-apis/employee/get-employee-data-filter?path_action=get-tax&employee_code=EMP001&year=2024" \
  -H "Ocp-Apim-Subscription-Key: YOUR_API_KEY"

JavaScript


const response = await fetch(
  'https://openapi.humansoft.co.th/api/v1/open-apis/employee/get-employee-data-filter?path_action=get-tax&employee_code=EMP001&year=2024',
  {
    headers: {
      'Ocp-Apim-Subscription-Key': 'YOUR_API_KEY'
    }
  }
)
const data = await response.json()
 
const payload = data.payload
console.log(`Tax year: ${payload.tax_year_code}`)
console.log(`Salary summary: ${payload.forcash_salary_summary}`)
console.log(`Exemption step1: ${payload.exemption_summary_step1}`)

Python


import requests
 
url = "https://openapi.humansoft.co.th/api/v1/open-apis/employee/get-employee-data-filter"
headers = {"Ocp-Apim-Subscription-Key": "YOUR_API_KEY"}
params = {
    "path_action": "get-tax",
    "employee_code": "EMP001",
    "year": "2024"
}
 
response = requests.get(url, headers=headers, params=params)
data = response.json()
 
payload = data['payload']
print(f"Tax Year: {payload['tax_year_code']}")
print(f"Salary Summary: {payload['forcash_salary_summary']}")
print(f"Fund (cat7): {payload['forcash_cat7_summary']}")
print(f"Social Security (cat17): {payload['forcash_cat17_summary']}")

PHP


<?php
$url = "https://openapi.humansoft.co.th/api/v1/open-apis/employee/get-employee-data-filter?path_action=get-tax&employee_code=EMP001&year=2024";
 
$ch = curl_init($url);
curl_setopt($ch, CURLOPT_HTTPHEADER, ["Ocp-Apim-Subscription-Key: YOUR_API_KEY"]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
 
$response = curl_exec($ch);
curl_close($ch);
 
$data = json_decode($response, true);
$payload = $data['payload'];
 
echo "Tax Year: " . $payload['tax_year_code'] . "\n";
echo "Salary Summary: " . $payload['forcash_salary_summary'] . "\n";
echo "Fund (cat7): " . $payload['forcash_cat7_summary'] . "\n";
?>

List Tax - ดึงรายการภาษีแยกตามปี
Delete Tax - ลบข้อมูลภาษีทั้งปี
List Tax Exception - ดึงรายการลดหย่อนภาษี
Update Tax Exception - บันทึกรายการลดหย่อนภาษี
Fill Tax Exception - เติมข้อมูลลดหย่อนภาษีจากปีก่อน
Get Cutoff Date - ดึงวันตัดแก้ไขภาษี