Thuế TNCN thu nhập ngoài lương API
Tính thuế TNCN các khoản ngoài lương: trúng thưởng, thừa kế, quà tặng, chứng khoán, chuyển nhượng vốn, nhà đất, bản quyền, cổ tức, thu nhập vãng lai.
Gửi loại thu nhập type và số tiền amount, API trả số thuế, phần thu nhập tính thuế, thuế suất và điều luật áp dụng. Các loại: prize (xổ số, khuyến mại, đặt cược, cuộc thi), inheritance và gift (chứng khoán, phần vốn, bất động sản, tài sản phải đăng ký), securities (0,1% giá bán), capital_transfer (20% phần lãi, hoặc 2% giá chuyển nhượng khi không xác định được giá mua), real_estate (2%), royalty và franchise (5% phần vượt ngưỡng), capital_investment (5% cổ tức, lãi cho vay), casual (khấu trừ 10%) và các khoản mới chịu thuế từ 1/7/2026: vn_domain, carbon_credit, license_plate (5% phần vượt 20 triệu) và digital_asset (0,1%). Vàng miếng có trong luật nhưng chưa thu cho đến khi Chính phủ quy định ngưỡng.
Tham số date chọn quy định: Luật Thuế TNCN 109/2025/QH15 và Nghị định 253/2026/NĐ-CP từ ngày 1/7/2026 (ngưỡng 20 triệu, khấu trừ vãng lai từ 5 triệu/lần), luật năm 2007 sửa đổi trước đó (10 triệu, 2 triệu). Các trường hợp miễn thuế được áp dụng khi bạn gửi thông tin: bất động sản giữa người thân (relationship), nhà ở duy nhất (sole_home), lãi tiền gửi ngân hàng (investment_kind=bank_deposit), chứng chỉ quỹ mở nắm giữ từ 2 năm. Cá nhân không cư trú dùng resident=false.
Thu nhập kinh doanh của hộ gia đình dùng /v1/vn-household-tax; tiền lương dùng /v1/vn-salary và /v1/vn-pit-annual. Mỗi kết quả có rules trích điều luật, legal và lời miễn trừ.
Tham số
| Tên | Vị trí | Kiểu | Bắt buộc | Mặc định | |
|---|---|---|---|---|---|
type | query|body | string | có | prize, inheritance, gift, securities, capital_transfer, real_estate, royalty, franchise, capital_investment, casual, vn_domain, carbon_credit, license_plate, digital_asset, gold. | |
amount | query|body | number | có | Giá trị giải thưởng, tài sản, giá chuyển nhượng hoặc thu nhập mỗi lần / hợp đồng (đồng). | |
date | query|body | string | không | Ngày nhận thu nhập (mặc định hôm nay); trước 01/7/2026 dùng luật cũ. | |
cost | query|body | number | không | capital_transfer: giá mua + chi phí hợp lý. | |
resident | query|body | boolean | không | true | false với cá nhân không cư trú. |
relationship | query|body | string | không | Quan hệ giữa hai bên (miễn thuế bất động sản giữa người thân). | |
asset | query|body | string | không | Thừa kế / quà tặng: real_estate, securities, capital, registered_asset. | |
sole_home | query|body | boolean | không | real_estate: nhà ở, đất ở duy nhất (miễn thuế). | |
investment_kind | query|body | string | không | capital_investment: bank_deposit, government_bond, life_insurance (miễn), dividend, loan_interest. | |
open_fund | query|body | boolean | không | securities: chứng chỉ quỹ mở (miễn khi held_years ≥ 2, từ 1/7/2026). |
Ví dụ
curl "https://apibox.io.vn/v1/vn-pit-other?type=prize&amount=50000000&date=2026-11-11" \
-H "Authorization: Bearer YOUR_API_KEY"const res = await fetch('https://apibox.io.vn/v1/vn-pit-other?type=prize&amount=50000000&date=2026-11-11', {
method: 'GET',
headers: {
Authorization: 'Bearer YOUR_API_KEY',
},
});
const data = await res.json();
console.log(data);import requests
res = requests.get(
"https://apibox.io.vn/v1/vn-pit-other?type=prize&amount=50000000&date=2026-11-11",
headers={"Authorization": "Bearer YOUR_API_KEY"},
timeout=30,
)
print(res.json())<?php
$ch = curl_init('https://apibox.io.vn/v1/vn-pit-other?type=prize&amount=50000000&date=2026-11-11');
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ['Authorization: Bearer YOUR_API_KEY'],
]);
$response = curl_exec($ch);
print_r(json_decode($response, true));Kết quả trả về
{
"type": "prize",
"type_vi": "Trúng thưởng (xổ số, khuyến mại, đặt cược, trò chơi, cuộc thi có thưởng)",
"type_en": "Winnings (lottery, promotions, betting, games, contests)",
"date": "2026-11-11",
"regime": "Luật 109/2025/QH15 (from 2026-07-01)",
"resident": true,
"amount": 50000000,
"status": "taxable",
"taxable_income": 30000000,
"rate_percent": 10,
"tax": 3000000,
"net": 47000000,
"steps": [
{
"step": "amount received (per prize / contract / occasion)",
"value": 50000000
},
{
"step": "threshold",
"value": 20000000
},
{
"step": "taxable income = amount − threshold",
"value": 30000000
}
],
"rules": [
{
"article": "Luật 109/2025/QH15 Điều 15",
"rule_vi": "10% × phần giá trị giải thưởng vượt trên 20 triệu đồng theo từng lần trúng thưởng"
}
],
"related": {
"business_income": "/v1/vn-household-tax",
"salary": "/v1/vn-salary",
"annual_finalisation": "/v1/vn-pit-annual"
},
"legal": [
"Luật Thuế thu nhập cá nhân 109/2025/QH15 (hiệu lực 01/7/2026)",
"Nghị định 253/2026/NĐ-CP (hiệu lực 01/7/2026)"
],
"reviewed": "2026-11-11",
"disclaimer": "Reference calculation, not legal advice; check the official text."
}
Ứng dụng
- Khấu trừ thuế giải thưởng trong app khuyến mại, trò chơi
- Ước tính thuế khi bán cổ phần, phần vốn, nhà đất
- Chi trả tiền bản quyền, thù lao vãng lai đúng mức khấu trừ
- Giải thích thay đổi thuế TNCN từ 1/7/2026 cho khách hàng
Hỏi đáp
Từ 1/7/2026 có gì thay đổi?
Luật 109/2025/QH15 nâng ngưỡng trúng thưởng, bản quyền, nhượng quyền, thừa kế, quà tặng từ 10 lên 20 triệu đồng mỗi lần, thêm mức 2% khi chuyển nhượng vốn không xác định được giá mua, và đánh thuế tên miền .vn, tín chỉ các-bon, biển số trúng đấu giá, tài sản số.
Bán vàng miếng có phải nộp thuế?
Luật quy định 0,1% nhưng giao Chính phủ quy định ngưỡng và thời điểm thu; hiện chưa thu, API trả trạng thái pending_decree kèm số thuế tham khảo.
Nhận thừa kế nhà của bố mẹ có phải nộp thuế?
Bất động sản giữa vợ chồng, cha mẹ và con, ông bà và cháu, anh chị em ruột, cha mẹ chồng/vợ với con dâu/rể được miễn. Tài sản khác (chứng khoán, phần vốn, ô tô) chịu 10% phần vượt 20 triệu.
API liên quan
Kiểm tra JSON
Kiểm tra cú pháp JSON, báo đúng dòng và cột bị lỗi, và validate dữ liệu theo JSON Schema (draft 4, 7, 2019-09 hoặc 2020-12).
{ }Định dạng JSON
Làm đẹp JSON với thụt lề 0-8 dấu cách hoặc tab, rút gọn (minify) hoặc sắp xếp key theo bảng chữ cái. Báo lỗi cú pháp kèm dòng và cột.
CSVCSV sang JSON
Chuyển CSV thành mảng object JSON theo dòng tiêu đề, tự nhận dấu phân cách, tự chuyển số và boolean, báo lỗi từng dòng.