Skip to Content
🚀 Welcome to Humansoft Open API Documentation

List Employee Tax Exceptions

ดึงรายการลดหย่อนภาษีของพนักงานตามปีภาษี (รายการที่แก้ไขได้ พร้อม child และ payload2 สำหรับฟอร์ม)

Endpoint

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

Query Parameters

ParameterTypeRequiredDescription
path_actionstringYesต้องเป็น get-tax-exception
employee_codestringYesรหัสพนักงาน
yearstringYesปีภาษี (ค.ศ.) เช่น 2024
language_codestringNoรหัสภาษา (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 ถ้ามี)

FieldTypeDescription
tax_category_idstringรหัสประเภทภาษี
tax_category_namestringชื่อประเภท (ตามภาษา)
tax_category_descstringคำอธิบาย
person_tax_transac_idstringID รายการ
need_secure_codestringY / N - ต้องกรอกรหัสลับหรือไม่
tax_secure_codestringรหัสลับ (ถ้ามี)
max_amtnumberวงเงินสูงสุด
tax_amtnumberจำนวนเงิน
childarrayรายการย่อย (โครงสร้างเดียวกัน)

payload2 (Array) - รายการแยกตาม code (สำหรับฟอร์ม)

FieldTypeDescription
tax_category_idstringรหัสประเภทภาษี
tax_category_namestringชื่อประเภท
tax_input_typestringประเภทการกรอก (C = Checkbox)
person_tax_transac_idstringID รายการ
tax_secure_codestring / booleanรหัสหรือสถานะเลือก (true/false เมื่อ input_type = C)
max_amtnumberวงเงินสูงสุด
tax_amtnumberจำนวนเงิน

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 -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"

  • Update Tax Exception - บันทึกรายการลดหย่อน (ส่ง tax_list จาก payload/payload2)
  • Fill Tax Exception - เติมข้อมูลลดหย่อนภาษีจากปีก่อน
  • Get Cutoff Date - ตรวจสอบสิทธิ์แก้ไขก่อนบันทึก
  • Delete Tax - ลบข้อมูลภาษีทั้งปี
Last updated on