Tính tiền phạt thuế, hóa đơn API
Tính phạt chậm nộp tờ khai thuế, vi phạm hóa đơn theo NĐ 125/2020 sửa đổi bởi NĐ 310/2025: khung phạt, mức phạt dự kiến và tiền chậm nộp.
Với violation=late_filing, gửi hạn nộp deadline (hoặc kỳ thuế period như 2026-05, 2026-Q2, 2025 kèm form vat, pit, cit, pit_individual, financial_statements: hạn nộp lấy từ /v1/vn-tax-calendar, đã lùi qua ngày nghỉ, ngày lễ) và ngày nộp filed_date hoặc số ngày chậm days_late. API trả khung phạt theo Nghị định 125/2020/NĐ-CP Điều 13 (cảnh cáo khi chậm 1–5 ngày có tình tiết giảm nhẹ, 2–5 triệu đến 30 ngày, 5–8 triệu đến 60 ngày, 8–15 triệu đến 90 ngày, 15–25 triệu khi quá 90 ngày đã nộp đủ thuế, nếu chưa nộp thuế thì là trốn thuế bị phạt 1–3 lần số thuế) và mức phạt cơ quan thuế lấy làm căn cứ: mức trung bình của khung, giảm 10% khi có một tình tiết giảm nhẹ, mức tối thiểu khi có từ hai tình tiết, tăng 10% hoặc mức tối đa với tình tiết tăng nặng (NĐ 310/2025/NĐ-CP, từ 16/01/2026; vi phạm trước đó dùng quy tắc ±10% mỗi tình tiết).
Các vi phạm khác: late_invoice và no_invoice (khung theo số lượng hóa đơn, tách bán hàng và hàng khuyến mại, biếu tặng, tiêu dùng nội bộ, NĐ 310 Điều 24), understatement (20% số thuế khai thiếu) và evasion (1–3 lần). Cá nhân, hộ kinh doanh (entity) bị phạt bằng một nửa tổ chức. Gửi tax_amount và paid_date để tính thêm tiền chậm nộp 0,03%/ngày bằng /v1/vn-late-interest.
Tham số
| Tên | Vị trí | Kiểu | Bắt buộc | Mặc định | |
|---|---|---|---|---|---|
violation | query|body | string | không | late_filing | late_filing, not_filed, late_invoice, no_invoice, understatement, evasion. |
deadline | query|body | string | không | Hạn nộp hồ sơ (YYYY-MM-DD). | |
period | query|body | string | không | Kỳ thuế thay cho hạn nộp: YYYY-MM, YYYY-Qn hoặc YYYY, kèm form. | |
form | query|body | string | không | vat | vat, pit, cit, pit_individual, financial_statements. |
filed_date | query|body | string | không | Ngày nộp hồ sơ (mặc định hôm nay) — hoặc days_late. | |
tax_amount | query|body | number | không | Số thuế phải nộp trên tờ khai (0 = không phát sinh). | |
tax_paid | query|body | boolean | không | true | Chậm trên 90 ngày: đã nộp đủ thuế và tiền chậm nộp trước khi bị kiểm tra? |
paid_date | query|body | string | không | Ngày nộp tiền thuế: tính thêm tiền chậm nộp. | |
entity | query|body | string | không | organization | organization, individual hoặc household (bằng 1/2 mức phạt tổ chức). |
mitigating | query|body | number | không | 0 | Số tình tiết giảm nhẹ. |
aggravating | query|body | number | không | 0 | Số tình tiết tăng nặng. |
invoice_count | query|body | number | không | 1 | late_invoice / no_invoice: số lượng hóa đơn. |
purpose | query|body | string | không | sale | sale (bán hàng) hoặc internal (khuyến mại, hàng mẫu, biếu tặng, trả thay lương, tiêu dùng nội bộ). |
tax_shortfall | query|body | number | không | understatement: số thuế khai thiếu. | |
tax_evaded | query|body | number | không | evasion: số thuế trốn. |
Ví dụ
curl "https://apibox.io.vn/v1/vn-tax-penalty?form=vat&period=2026-05&filed_date=2026-07-10&tax_amount=10000000&paid_date=2026-07-10&mitigating=1" \
-H "Authorization: Bearer YOUR_API_KEY"const res = await fetch('https://apibox.io.vn/v1/vn-tax-penalty?form=vat&period=2026-05&filed_date=2026-07-10&tax_amount=10000000&paid_date=2026-07-10&mitigating=1', {
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-tax-penalty?form=vat&period=2026-05&filed_date=2026-07-10&tax_amount=10000000&paid_date=2026-07-10&mitigating=1",
headers={"Authorization": "Bearer YOUR_API_KEY"},
timeout=30,
)
print(res.json())<?php
$ch = curl_init('https://apibox.io.vn/v1/vn-tax-penalty?form=vat&period=2026-05&filed_date=2026-07-10&tax_amount=10000000&paid_date=2026-07-10&mitigating=1');
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ề
{
"violation": "late_filing",
"entity": "organization",
"deadline_info": {
"form": "vat",
"period": "2026-05",
"due_date": "2026-06-22",
"statutory_date": "2026-06-20",
"title_vi": "Khai, nộp thuế GTGT tháng 5/2026",
"ref": "Luật Quản lý thuế 38/2019/QH14 Điều 44",
"source": "/v1/vn-tax-calendar"
},
"deadline": "2026-06-22",
"filed_date": "2026-07-10",
"days_late": 18,
"tax_amount": 10000000,
"rules_version": "NĐ 125/2020 as amended by NĐ 310/2025 (violations from 2026-01-16)",
"classification": "fine",
"band": {
"min": 2000000,
"max": 5000000,
"middle": 3500000,
"ref": "NĐ 125/2020/NĐ-CP Điều 13 khoản 2",
"text_vi": "Quá thời hạn từ 01 đến 30 ngày"
},
"amount_rule": "1 mitigating circumstance: middle − 10%",
"fine": 3150000,
"late_interest": {
"principal": 10000000,
"due_date": "2026-06-22",
"paid_date": "2026-07-10",
"days": 17,
"interest": 51000,
"source": "/v1/vn-late-interest"
},
"total": 3201000,
"mitigating": 1,
"aggravating": 0,
"legal": [
"Nghị định 125/2020/NĐ-CP (sửa đổi bởi Nghị định 102/2021/NĐ-CP và Nghị định 310/2025/NĐ-CP, hiệu lực 16/01/2026)",
"Luật Xử lý vi phạm hành chính 15/2012/QH13 Điều 23 khoản 2 (mức phạt tổ chức gấp 2 lần cá nhân)"
],
"reviewed": "2026-11-11",
"disclaimer": "Reference calculation, not legal advice; check the official text."
}
Ứng dụng
- Nhắc kế toán trước khi tờ khai bị trễ hạn
- Ước tính tiền phạt khi nộp bù tờ khai còn thiếu
- Đánh giá rủi ro xuất hóa đơn chậm hoặc không xuất
- Cộng tiền phạt và tiền chậm nộp vào báo giá dịch vụ thuế
Hỏi đáp
Số tiền phạt có chính xác như kết quả không?
Cơ quan thuế quyết định trong khung; mức trung bình của khung là căn cứ theo luật và được điều chỉnh theo tình tiết giảm nhẹ, tăng nặng. API trả cả khung và mức căn cứ đó.
NĐ 310/2025 thay đổi gì?
Từ 16/01/2026: một tình tiết giảm nhẹ giảm 10%, từ hai tình tiết áp dụng mức tối thiểu; vi phạm hóa đơn bị phạt một lần trong vụ việc theo khung số lượng hóa đơn; chậm trên 90 ngày đã nộp đủ thuế vẫn phạt 15–25 triệu.
Khi nào chậm nộp tờ khai bị coi là trốn thuế?
Khi nộp quá 90 ngày, có số thuế phải nộp mà chưa nộp đủ thuế và tiền chậm nộp trước khi bị kiểm tra hoặc lập biên bản, hoặc không nộp tờ khai mà có phát sinh thuế.
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.