List Employee Tax Records

ดึงรายการภาษีของพนักงานแยกตามปีภาษี พร้อมยอดหักลดหย่อนภาษีสะสม (tax_amt) ที่คำนวณจากเงินเดือน กองทุนสำรองเลี้ยงชีพ ประกันสังคม และรายการลดหย่อนอื่น

Endpoint


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

Query Parameters

Parameter	Type	Required	Description
`path_action`	string	Yes	ต้องเป็น `list-tax`
`employee_code`	string	Yes	รหัสพนักงานที่ต้องการดึงรายการภาษี

Response Format

Success Response


{
  "code": 200,
  "message": "สำเร็จ",
  "payload": [
    {
      "tax_year_code": "2024",
      "tax_amt": 185000.50,
      "month_count": "2",
      "month_count_00": "0"
    },
    {
      "tax_year_code": "2023",
      "tax_amt": 172000.00,
      "month_count": "1",
      "month_count_00": "0"
    }
  ]
}

Response Fields

Field	Type	Description
`code`	number	`200` = สำเร็จ
`message`	string	ข้อความตอบกลับ
`payload`	array	รายการภาษีแยกตามปีภาษี
`payload[].tax_year_code`	string	ปีภาษี (ค.ศ.) เช่น 2024
`payload[].tax_amt`	number	ยอดหักลดหย่อนภาษีสะสม (บาท)
`payload[].month_count`	string	จำนวนเดือน
`payload[].month_count_00`	string	จำนวนเดือน

Error Responses

Missing employee_code:


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

Employee Not Found:


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

หมายเหตุการคำนวณ tax_amt:

กองทุนสำรองเลี้ยงชีพ (cat 7): สูงสุด 500,000 บาท และไม่เกิน 15% ของเงินเดือนสะสม
ประเภทกองทุน (8, 9, 70, 18, 71, 19): วงเงินรวมไม่เกิน 500,000 บาท
ปีภาษีที่ไม่มี slip จะได้ tax_amt = 0

Code Examples

cURL


curl -X GET "https://openapi.humansoft.co.th/api/v1/open-apis/employee/get-employee-data-filter?path_action=list-tax&employee_code=EMP001" \
  -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=list-tax&employee_code=EMP001',
  {
    headers: {
      'Ocp-Apim-Subscription-Key': 'YOUR_API_KEY'
    }
  }
)
const data = await response.json()
console.log('Tax records:', data.payload)

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": "list-tax",
    "employee_code": "EMP001"
}
 
response = requests.get(url, headers=headers, params=params)
data = response.json()
 
for tax in data['payload']:
    print(f"Year: {tax['tax_year_code']}, Tax: {tax['tax_amt']} บาท")

PHP


<?php
$url = "https://openapi.humansoft.co.th/api/v1/open-apis/employee/get-employee-data-filter?path_action=list-tax&employee_code=EMP001";
 
$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);
foreach ($data['payload'] as $tax) {
    echo "Year: {$tax['tax_year_code']}, Tax: {$tax['tax_amt']} บาท\n";
}
?>

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