Thuế thu nhập doanh nghiệp API
Tính thuế TNDN theo Luật 67/2025: thuế suất 15/17/20% theo doanh thu, giảm 30% năm 2026–2027, kiểm tra tạm nộp quý 80% và tiền chậm nộp phần thiếu.
Gửi doanh thu năm (revenue), doanh thu năm trước (prior_year_revenue, căn cứ xác định thuế suất) và thu nhập tính thuế (taxable_income, hoặc profit kèm non_deductible, exempt_income, losses_carried_forward). API áp dụng Luật Thuế TNDN 67/2025/QH15 và Nghị định 320/2025/NĐ-CP: 15% khi tổng doanh thu năm trước không quá 3 tỷ đồng, 17% khi đến 50 tỷ, còn lại 20%; công ty con, công ty liên kết có bên liên kết không đáp ứng điều kiện thì áp dụng 20% (related_party_not_eligible=true). Doanh nghiệp nhỏ không xác định được chi phí có thể dùng method=revenue (0,3% – 4% doanh thu theo ngành).
Với kỳ tính thuế 2026 và 2027, API tự giảm 30% số thuế cho doanh nghiệp có doanh thu không quá 10 tỷ đồng (Nghị quyết 43/2026/QH16, Nghị định 398/2026/NĐ-CP), tính sau khi trừ ưu đãi (incentive_reduction).
Gửi 4 lần tạm nộp (provisional) để kiểm tra quy định 80% (Nghị định 252/2026/NĐ-CP Điều 24): mức tối thiểu, số còn thiếu và tiền chậm nộp 0,03%/ngày tính từ ngày sau hạn tạm nộp quý 4 đến ngày nộp. Hạn tạm nộp quý và hạn quyết toán được lùi sang ngày làm việc tiếp theo khi trùng ngày nghỉ, ngày lễ.
Tham số
| Tên | Vị trí | Kiểu | Bắt buộc | Mặc định | |
|---|---|---|---|---|---|
year | query|body | number | không | Năm tính thuế 2025–2030 (mặc định năm nay). | |
revenue | query|body | number | có | Tổng doanh thu trong năm (đồng). | |
prior_year_revenue | query|body | number | không | Tổng doanh thu năm trước (mặc định bằng revenue). | |
taxable_income | query|body | number | không | Thu nhập tính thuế, hoặc gửi profit kèm non_deductible, exempt_income, losses_carried_forward. | |
related_party_not_eligible | query|body | boolean | không | Công ty con, công ty liên kết có bên liên kết không đủ điều kiện 15% / 17%. | |
method | query|body | string | không | income | income hoặc revenue (tỷ lệ % trên doanh thu, ≤ 3 tỷ, kèm sector). |
incentive_reduction | query|body | number | không | Số thuế được ưu đãi trừ trước khi giảm 30%. | |
provisional | body | array | không | Số tạm nộp quý 1–4, ví dụ [10000000,10000000,10000000,10000000]. | |
payment_date | query|body | string | không | Ngày nộp số còn thiếu (mặc định hạn quyết toán). |
Ví dụ
curl "https://apibox.io.vn/v1/vn-cit?year=2026&revenue=2500000000&prior_year_revenue=2500000000&taxable_income=400000000" \
-H "Authorization: Bearer YOUR_API_KEY"const res = await fetch('https://apibox.io.vn/v1/vn-cit?year=2026&revenue=2500000000&prior_year_revenue=2500000000&taxable_income=400000000', {
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-cit?year=2026&revenue=2500000000&prior_year_revenue=2500000000&taxable_income=400000000",
headers={"Authorization": "Bearer YOUR_API_KEY"},
timeout=30,
)
print(res.json())<?php
$ch = curl_init('https://apibox.io.vn/v1/vn-cit?year=2026&revenue=2500000000&prior_year_revenue=2500000000&taxable_income=400000000');
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,
"method": "income",
"revenue": 2500000000,
"prior_year_revenue": 2500000000,
"rate_percent": 15,
"rate_tier": "revenue_up_to_3_billion",
"taxable_income": 400000000,
"tax_before_reductions": 60000000,
"incentive_reduction": 0,
"reduction_30_percent": 18000000,
"tax_payable": 42000000,
"effective_rate_percent": 1.68,
"provisional": {
"minimum_total_80_percent": 33600000,
"suggested_per_quarter": 8400000,
"deadlines": [
{
"quarter": 1,
"deadline": "2026-05-04"
},
{
"quarter": 2,
"deadline": "2026-07-31"
},
{
"quarter": 3,
"deadline": "2026-11-02"
},
{
"quarter": 4,
"deadline": "2027-02-01"
}
]
},
"final_return_deadline": "2027-03-31",
"payment_codes": {
"sub_item": "1052",
"late_interest_sub_item": "4918"
},
"legal": [
"Luật Thuế thu nhập doanh nghiệp 67/2025/QH15",
"Nghị định 320/2025/NĐ-CP Điều 11, 12",
"Nghị quyết 43/2026/QH16; Nghị định 398/2026/NĐ-CP Điều 3 (giảm 30% thuế TNDN năm 2026, 2027, doanh thu ≤ 10 tỷ đồng)"
],
"reviewed": "2026-11-11"
}
Ứng dụng
- Ước tính thuế TNDN và số tạm nộp quý trong phần mềm kế toán
- Kiểm tra số tạm nộp có đạt 80% không
- Hiển thị mức giảm 30% cho doanh nghiệp nhỏ năm 2026–2027
- Lập kế hoạch thuế khi doanh nghiệp vượt mốc 3 hoặc 50 tỷ
Hỏi đáp
Doanh thu nào dùng để xác định thuế suất 15% hay 17%?
Tổng doanh thu (bán hàng, hoạt động tài chính, thu nhập khác) của kỳ tính thuế năm trước liền kề; doanh nghiệp mới thành lập dùng doanh thu dự kiến và quyết toán lại cuối năm.
Tạm nộp thấp hơn 80% thì sao?
Phần chênh lệch giữa 80% số thuế quyết toán và số đã tạm nộp bị tính tiền chậm nộp 0,03%/ngày từ ngày sau hạn tạm nộp quý 4 đến ngày nộp.
Giảm 30% có cần làm hồ sơ không?
Doanh nghiệp tự xác định khi tạm nộp quý và khi quyết toán (Nghị định 398/2026). Nếu doanh thu thực tế vượt 10 tỷ thì phải nộp lại số đã giảm và tiền chậm nộp.
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.