Skip to Content
🚀 Welcome to Humansoft Open API Documentation

Fill Employee Tax Exception

เติมข้อมูลลดหย่อนภาษีจากปีก่อนหน้าไปยังปีที่ระบุ

ระบบจะดึงข้อมูลลดหย่อนภาษีปีก่อน (year - 1) มา map กับรายการปีที่ระบุ (year) แล้วบันทึกลงปีนั้น บาง tax_category อาจถูกตัดออกตามช่วงปีภาษี

Endpoint

POST /api/v1/open-apis/employee/update-employee-financial?path_action=fill-tax-exception

Query Parameters

ParameterTypeRequiredDescription
path_actionstringYesต้องเป็น fill-tax-exception

Request Body

FieldTypeRequiredDescription
employee_codestringYesรหัสพนักงาน
yearstringYesปีภาษีที่ต้องการเติมข้อมูล (ค.ศ.) เช่น 2024

Example Request Body

{ "employee_code": "EMP001", "year": "2024" }

Response Format

Success Response

{ "code": 200, "message": "Fill Employee Tax Exception Success", "payload": { "employee_code": "EMP001", "year": "2024", "tax_list": [ { "tax_category_id": "01", "person_tax_transac_id": "xxx", "tax_secure_code": "", "tax_amt": 50000 } ] } }

Response Fields

FieldTypeDescription
codenumber200 = สำเร็จ
messagestringข้อความตอบกลับ
payloadobjectข้อมูลที่ส่งเข้าและรายการที่บันทึก
payload.employee_codestringรหัสพนักงานที่ส่งเข้า
payload.yearstringปีภาษีที่เติมข้อมูล
payload.tax_listarrayรายการลดหย่อนภาษีที่บันทึก
payload.tax_list[].tax_category_idstringรหัสหมวดหมู่ภาษี
payload.tax_list[].person_tax_transac_idstringID ของรายการลดหย่อน
payload.tax_list[].tax_secure_codestringรหัสประเภทลดหย่อน
payload.tax_list[].tax_amtnumberจำนวนเงินลดหย่อน

Error Responses

Missing employee_code:

{ "code": 400, "message": "ข้อมูลไม่ถูกต้อง", "error": "กรุณาระบุ 'employee_code'" }

Missing year:

{ "code": 400, "message": "ข้อมูลไม่ถูกต้อง", "error": "กรุณาระบุ 'year' (ปีภาษี เช่น 2024)" }

Employee Not Found:

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

Code Examples

curl -X POST "https://openapi.humansoft.co.th/api/v1/open-apis/employee/update-employee-financial?path_action=fill-tax-exception" \ -H "Ocp-Apim-Subscription-Key: YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "employee_code": "EMP001", "year": "2024" }'

  • List Tax Exception - ดึงรายการลดหย่อนภาษี
  • Update Tax Exception - บันทึกรายการลดหย่อนภาษี
  • Delete Tax - ลบข้อมูลภาษีทั้งปี
Last updated on