Fill Employee Tax Exception
เติมข้อมูลลดหย่อนภาษีจากปีก่อนหน้าไปยังปีที่ระบุ
ระบบจะดึงข้อมูลลดหย่อนภาษีปีก่อน (year - 1) มา map กับรายการปีที่ระบุ (year) แล้วบันทึกลงปีนั้น บาง tax_category อาจถูกตัดออกตามช่วงปีภาษี
Endpoint
POST /api/v1/open-apis/employee/update-employee-financial?path_action=fill-tax-exceptionQuery Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
path_action | string | Yes | ต้องเป็น fill-tax-exception |
Request Body
| Field | Type | Required | Description |
|---|---|---|---|
employee_code | string | Yes | รหัสพนักงาน |
year | string | Yes | ปีภาษีที่ต้องการเติมข้อมูล (ค.ศ.) เช่น 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
| Field | Type | Description |
|---|---|---|
code | number | 200 = สำเร็จ |
message | string | ข้อความตอบกลับ |
payload | object | ข้อมูลที่ส่งเข้าและรายการที่บันทึก |
payload.employee_code | string | รหัสพนักงานที่ส่งเข้า |
payload.year | string | ปีภาษีที่เติมข้อมูล |
payload.tax_list | array | รายการลดหย่อนภาษีที่บันทึก |
payload.tax_list[].tax_category_id | string | รหัสหมวดหมู่ภาษี |
payload.tax_list[].person_tax_transac_id | string | ID ของรายการลดหย่อน |
payload.tax_list[].tax_secure_code | string | รหัสประเภทลดหย่อน |
payload.tax_list[].tax_amt | number | จำนวนเงินลดหย่อน |
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
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"
}'Related APIs
- List Tax Exception - ดึงรายการลดหย่อนภาษี
- Update Tax Exception - บันทึกรายการลดหย่อนภาษี
- Delete Tax - ลบข้อมูลภาษีทั้งปี
Last updated on