Thuế hộ kinh doanh API
Tính thuế GTGT, thuế TNCN của hộ kinh doanh năm 2026: ngưỡng 1 tỷ, tỷ lệ theo ngành, chọn cách tính theo doanh thu hoặc thu nhập, giảm 30% thuế.
Thuế khoán chấm dứt từ 1/1/2026. Gửi doanh thu năm và ngành nghề (hoặc nhiều ngành qua lines), API áp dụng quy định năm 2026: doanh thu từ 1 tỷ đồng trở xuống không chịu thuế GTGT và không nộp thuế TNCN (NĐ 141/2026/NĐ-CP nâng ngưỡng 500 triệu của Luật Thuế TNCN 109/2025 và NĐ 68/2026), trên ngưỡng thì thuế GTGT tính theo tỷ lệ trên toàn bộ doanh thu (phân phối 1%, dịch vụ 5%, sản xuất, vận tải 3%, khác 2%), còn thuế TNCN tính trên phần doanh thu vượt ngưỡng (0,5% / 2% / 1,5% / 1%; 5% với cho thuê tài sản, đại lý, nội dung số).
Doanh thu đến 3 tỷ đồng được chọn cách tính theo thu nhập: (doanh thu − expenses) × 15%. Trên 3 tỷ bắt buộc tính theo thu nhập với thuế suất 17% (đến 50 tỷ) hoặc 20%. Khi có expenses, API tính cả hai cách và chọn cách có lợi hơn, trừ khi bạn chỉ định method. Ngưỡng 1 tỷ chỉ trừ một lần, ưu tiên ngành có tỷ lệ cao nhất, và API tự giảm 30% thuế TNCN cho doanh thu đến 10 tỷ trong năm 2026–2027 (NĐ 398/2026/NĐ-CP).
Kết quả còn cho biết kỳ khai theo quý hay tháng, có bắt buộc hóa đơn điện tử không, và liệt kê văn bản pháp luật đã dùng. year=2025 áp dụng quy định cũ (ngưỡng 100 triệu, TT 40/2021). Kết quả chỉ để ước tính, không thay thế tư vấn thuế.
Tham số
| Tên | Vị trí | Kiểu | Bắt buộc | Mặc định | |
|---|---|---|---|---|---|
revenue | query|body | number | không | Doanh thu năm (đồng), kèm sector. | |
sector | query|body | string | không | other | distribution (phân phối), services (dịch vụ), production (sản xuất, vận tải), asset_leasing, real_estate_leasing, agency, digital_content, other. |
lines | body | array | không | Nhiều ngành nghề: [{"sector":"distribution","revenue":600000000}, ...]. | |
expenses | query|body | number | không | Chi phí hợp lý trong năm (phương pháp thu nhập; bắt buộc khi trên 3 tỷ). | |
method | query|body | string | không | Chỉ định revenue hoặc income. | |
year | query|body | number | không | Năm tính thuế (2025–2030, mặc định năm nay). |
Ví dụ
curl "https://apibox.io.vn/v1/vn-household-tax?revenue=2000000000§or=distribution" \
-H "Authorization: Bearer YOUR_API_KEY"const res = await fetch('https://apibox.io.vn/v1/vn-household-tax?revenue=2000000000§or=distribution', {
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-household-tax?revenue=2000000000§or=distribution",
headers={"Authorization": "Bearer YOUR_API_KEY"},
timeout=30,
)
print(res.json())<?php
$ch = curl_init('https://apibox.io.vn/v1/vn-household-tax?revenue=2000000000§or=distribution');
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ề
{
"year": 2026,
"revenue": 2000000000,
"threshold": 1000000000,
"below_threshold": false,
"vat": {
"total": 20000000,
"lines": [
{
"sector": "distribution",
"revenue": 2000000000,
"rate_percent": 1,
"vat": 20000000
}
]
},
"pit": {
"method": "revenue",
"gross": 5000000,
"reduction_30_percent": 1500000,
"total": 3500000,
"revenue_method": {
"method": "revenue",
"allowed": true,
"lines": [
{
"sector": "distribution",
"revenue": 2000000000,
"taxable_revenue": 1000000000,
"rate_percent": 0.5,
"pit": 5000000
}
],
"pit": 5000000
}
},
"total_tax": 23500000,
"effective_rate_percent": 1.18,
"obligations": {
"declare": "Quarterly returns, due the last day of the first month of the next quarter",
"period": "quarterly",
"e_invoice_required": true,
"licence_fee": "abolished from 1/1/2026"
},
"legal": [
"Luật Thuế TNCN 109/2025/QH15 Điều 7",
"Luật Thuế GTGT 48/2024/QH15 Điều 12",
"Nghị định 68/2026/NĐ-CP, sửa đổi bởi Nghị định 141/2026/NĐ-CP (threshold 1 billion from 1/1/2026)",
"Nghị quyết 198/2025/QH15 Điều 10 (no lump-sum tax, no licence fee from 1/1/2026)",
"Nghị định 398/2026/NĐ-CP (PIT −30% for revenue ≤ 10 billion, 2026–2027)"
],
"reviewed": "2026-11-11"
}
Ứng dụng
- Hiển thị số thuế phải nộp trong phần mềm bán hàng cho hộ kinh doanh
- Ước tính thuế cho người bán trên sàn thương mại điện tử
- So sánh cách tính theo doanh thu và theo thu nhập trước khi đăng ký
- Lập kế hoạch dòng tiền trong dịch vụ kế toán cho cửa hàng nhỏ
Hỏi đáp
Ngưỡng miễn thuế là 200 triệu, 500 triệu hay 1 tỷ?
Năm 2026 là 1 tỷ đồng/năm: Luật Thuế TNCN 109/2025 quy định 500 triệu và giao Chính phủ điều chỉnh; NĐ 141/2026/NĐ-CP nâng lên 1 tỷ, áp dụng từ 1/1/2026.
Thuế GTGT có tính trên phần vượt ngưỡng không?
Không. Khi doanh thu năm vượt ngưỡng, thuế GTGT tính trên toàn bộ doanh thu; chỉ thuế TNCN theo phương pháp doanh thu mới tính trên phần vượt ngưỡng.
Có những mã ngành nào?
distribution, services, production, asset_leasing, real_estate_leasing, agency, digital_content, other.
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.