Delete Person Tax NVAT (ลบข้อมูลภาษี ณ ที่จ่าย รายบุคคล ภงด.3)

ลบข้อมูลภาษีเงินได้หัก ณ ที่จ่าย (ภงด.3) ของพนักงานรายบุคคล ตามงวดเดือนที่ระบุ

การลบข้อมูลไม่สามารถกู้คืนได้ — ควรตรวจสอบข้อมูลจาก NVAT Month Report ก่อนเรียก API นี้ทุกครั้ง

Endpoint


POST /api/v1/open-apis/report/delete-person-tax-nvat?path_action=delete_person_tax_nvat

Request Parameters

Required Parameters

Parameter	Type	Required	Description	Example
`authorize_id`	string	Yes	รหัสผู้เรียก API	`"EMP001"`
`employee_code`	string	Yes	รหัสพนักงาน (plain text ไม่ต้อง encode)	`"EMP001"`
`tax_month_code`	string	Yes	รหัสเดือนภาษี 2 หลัก (01-12)	`"03"`
`tax_year_code`	string	Yes	รหัสปีภาษี 4 หลัก (YYYY)	`"2026"`

Optional Parameters

Parameter	Type	Default	Description	Example
`xtra_slip_lists`	array<string>	`[]`	รายการ xtra slip ที่ต้องล็อกพร้อมการลบ (base64-encoded string)	`["eHRyYV9zbGlwXzAwMQ=="]`

xtra_slip_lists เป็น array ของ base64-encoded string โดยตรง (ไม่ใช่ array of object)
ค่า xtra_slip_lists ที่ถูกต้องสามารถดึงได้จาก extra.xtra_slip_lists ใน response ของ NVAT Month Report
item ที่ decode ไม่ได้หรือว่างจะถูกข้ามโดยอัตโนมัติ (ไม่ error)

Example Request Body


{
  "authorize_id": "EMP001",
  "employee_code": "EMP001",
  "tax_month_code": "03",
  "tax_year_code": "2026",
  "xtra_slip_lists": [
    "eHRyYV9zbGlwXzAwMQ==",
    "eHRyYV9zbGlwXzAwMg=="
  ]
}

Response Format

Success Response


{
  "code": "200",
  "message": "Success",
  "payload": {
    "employee_code": "EMP001",
    "employee_id": "2024010112345ABC",
    "tax_month_code": "03",
    "tax_year_code": "2026"
  }
}

Response Fields

Field	Type	Description
`payload.employee_code`	string	รหัสพนักงานที่ส่งมาใน request
`payload.employee_id`	string	รหัสพนักงานที่ resolve ได้จาก `employee_code`
`payload.tax_month_code`	string	รหัสเดือนภาษีที่ลบ
`payload.tax_year_code`	string	รหัสปีภาษีที่ลบ

Error Response


{
  "code": 400,
  "message": "Validation failed",
  "errors": [
    "Missing required parameter: 'employee_code'",
    "'tax_month_code' must be a two-digit month (01-12)",
    "'tax_year_code' must be in YYYY format"
  ]
}

HTTP Status	Description
`400`	พารามิเตอร์ไม่ครบหรือรูปแบบไม่ถูกต้อง
`401`	API Key ไม่ถูกต้องหรือไม่ได้ส่ง
`403`	ไม่มีสิทธิ์เรียก API นี้
`500`	ไม่พบพนักงาน หรือไม่พบข้อมูลภาษีของงวดที่ระบุ

เมื่อเรียก API สำเร็จ ข้อมูลภาษีของพนักงานในงวดดังกล่าวจะถูกลบทันทีและไม่สามารถกู้คืนได้ ข้อมูล xtra slip ที่ผูกกับงวดจะถูกล็อกไม่ให้แก้ไขย้อนหลัง

Code Examples

cURL


curl -X POST "https://openapi.humansoft.co.th/api/v1/open-apis/report/delete-person-tax-nvat?path_action=delete_person_tax_nvat" \
  -H "Ocp-Apim-Subscription-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "authorize_id": "EMP001",
    "employee_code": "EMP001",
    "tax_month_code": "03",
    "tax_year_code": "2026",
    "xtra_slip_lists": [
      "eHRyYV9zbGlwXzAwMQ=="
    ]
  }'

JavaScript


const response = await fetch(
  'https://openapi.humansoft.co.th/api/v1/open-apis/report/delete-person-tax-nvat?path_action=delete_person_tax_nvat',
  {
    method: 'POST',
    headers: {
      'Ocp-Apim-Subscription-Key': 'YOUR_API_KEY',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      authorize_id: 'EMP001',
      employee_code: 'EMP001',
      tax_month_code: '03',
      tax_year_code: '2026',
      xtra_slip_lists: ['eHRyYV9zbGlwXzAwMQ==']
    })
  }
)
const data = await response.json()
console.log(data.payload)

Python


import requests
 
url = "https://openapi.humansoft.co.th/api/v1/open-apis/report/delete-person-tax-nvat"
headers = {"Ocp-Apim-Subscription-Key": "YOUR_API_KEY"}
params = {"path_action": "delete_person_tax_nvat"}
payload = {
    "authorize_id": "EMP001",
    "employee_code": "EMP001",
    "tax_month_code": "03",
    "tax_year_code": "2026",
    "xtra_slip_lists": ["eHRyYV9zbGlwXzAwMQ=="]
}
 
response = requests.post(url, headers=headers, params=params, json=payload)
data = response.json()
print(data["payload"])

PHP


<?php
$url = "https://openapi.humansoft.co.th/api/v1/open-apis/report/delete-person-tax-nvat?path_action=delete_person_tax_nvat";
$data = json_encode([
    "authorize_id" => "EMP001",
    "employee_code" => "EMP001",
    "tax_month_code" => "03",
    "tax_year_code" => "2026",
    "xtra_slip_lists" => ["eHRyYV9zbGlwXzAwMQ=="]
]);
 
$ch = curl_init($url);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    "Ocp-Apim-Subscription-Key: YOUR_API_KEY",
    "Content-Type: application/json"
]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
 
$response = curl_exec($ch);
curl_close($ch);
 
$result = json_decode($response, true);
print_r($result["payload"]);
?>

NVAT Month Report (ภงด.3) - ดึงรายงานภาษี ณ ที่จ่ายประจำเดือน (แนะนำให้เรียกก่อน API นี้เพื่อดึง xtra_slip_lists)