List Employee Tax Exceptions
ดึงรายการลดหย่อนภาษีของพนักงานตามปีภาษี (รายการที่แก้ไขได้ พร้อม child และ payload2 สำหรับฟอร์ม)
Endpoint
GET /api/v1/open-apis/employee/get-employee-data-filter?path_action=get-tax-exceptionQuery Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
path_action | string | Yes | ต้องเป็น get-tax-exception |
employee_code | string | Yes | รหัสพนักงาน |
year | string | Yes | ปีภาษี (ค.ศ.) เช่น 2024 |
language_code | string | No | รหัสภาษา (TH/EN) ค่าเริ่มต้น: TH |
Response Format
Success Response
{
"code": 200,
"message": "สำเร็จ",
"payload": [
{
"tax_category_id": "1",
"tax_category_name": "ค่าลดหย่อนส่วนตัว",
"tax_category_desc": "ผู้มีเงินได้หักได้ 60,000 บาท",
"person_tax_transac_id": "20260121PT01A2B3C4D5",
"need_secure_code": "N",
"tax_secure_code": "",
"max_amt": 60000,
"tax_amt": 60000
},
{
"tax_category_id": "3",
"tax_category_name": "ค่าลดหย่อนบุตร",
"tax_category_desc": "บุตรคนละ 30,000 บาท",
"child": [
{
"tax_category_id": "4",
"tax_category_name": "บุตรคนที่ 1",
"tax_category_desc": "บุตรคนที่ 1",
"person_tax_transac_id": "20260121PT02E3F4A5B6",
"need_secure_code": "N",
"tax_secure_code": "",
"max_amt": 60000,
"tax_amt": 30000
}
]
}
],
"payload2": [
{
"tax_category_id": "50",
"tax_category_name": "บิดาของผู้มีเงินได้",
"tax_input_type": "C",
"person_tax_transac_id": "20260121PT03F4A5B6C7",
"tax_secure_code": true,
"max_amt": 30000,
"tax_amt": 30000
}
]
}Response Fields
payload (Array) - รายการแยกตาม category (มี child ถ้ามี)
| Field | Type | Description |
|---|---|---|
tax_category_id | string | รหัสประเภทภาษี |
tax_category_name | string | ชื่อประเภท (ตามภาษา) |
tax_category_desc | string | คำอธิบาย |
person_tax_transac_id | string | ID รายการ |
need_secure_code | string | Y / N - ต้องกรอกรหัสลับหรือไม่ |
tax_secure_code | string | รหัสลับ (ถ้ามี) |
max_amt | number | วงเงินสูงสุด |
tax_amt | number | จำนวนเงิน |
child | array | รายการย่อย (โครงสร้างเดียวกัน) |
payload2 (Array) - รายการแยกตาม code (สำหรับฟอร์ม)
| Field | Type | Description |
|---|---|---|
tax_category_id | string | รหัสประเภทภาษี |
tax_category_name | string | ชื่อประเภท |
tax_input_type | string | ประเภทการกรอก (C = Checkbox) |
person_tax_transac_id | string | ID รายการ |
tax_secure_code | string / boolean | รหัสหรือสถานะเลือก (true/false เมื่อ input_type = C) |
max_amt | number | วงเงินสูงสุด |
tax_amt | number | จำนวนเงิน |
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)"
}No Data:
{
"code": 400,
"message": "ไม่สำเร็จ",
"error": "Invalid employee_id or no tax exception data for 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-exception&employee_code=EMP001&year=2024" \
-H "Ocp-Apim-Subscription-Key: YOUR_API_KEY"Related APIs
- Update Tax Exception - บันทึกรายการลดหย่อน (ส่ง tax_list จาก payload/payload2)
- Fill Tax Exception - เติมข้อมูลลดหย่อนภาษีจากปีก่อน
- Get Cutoff Date - ตรวจสอบสิทธิ์แก้ไขก่อนบันทึก
- Delete Tax - ลบข้อมูลภาษีทั้งปี
Last updated on