Tính tiền chậm nộp API
Tính tiền chậm nộp thuế 0,03%/ngày, chậm đóng BHXH, chậm nộp phạt và lãi chậm trả theo Bộ luật Dân sự, có nộp nhiều lần và lịch sử thay đổi mức tính.
Gửi số tiền (amount), hạn nộp (due_date) và ngày nộp (paid_date), danh sách các lần nộp (payments) hoặc ngày tính đến (to), chọn loại (kind): tax (tiền chậm nộp thuế: 0,05%/ngày từ 2015, 0,03%/ngày từ 1/7/2016, giữ nguyên tại Luật Quản lý thuế 38/2019 và 108/2025), social_insurance (BHXH, BHYT, BHTN: 0,03%/ngày từ 1/7/2025, Luật BHXH 2024 Điều 40), fine (chậm nộp tiền phạt vi phạm hành chính: 0,05%/ngày), civil (Bộ luật Dân sự Điều 357: lãi suất thỏa thuận tối đa 20%/năm, hoặc 10%/năm), loan_overdue (150% lãi suất vay) hoặc custom.
Số ngày được tính như cơ quan thuế: từ ngày liền sau hạn nộp đến ngày liền trước ngày nộp tiền, tính cả thứ Bảy, Chủ nhật và ngày lễ (include_payment_day=true để tính cả ngày nộp). Thời gian được chia đoạn khi mức tính thay đổi hoặc khi nộp một phần làm giảm số nợ, mỗi đoạn có số ngày, số nợ, mức tính và căn cứ pháp lý.
Nếu hạn nộp trùng ngày nghỉ thì hạn được lùi sang ngày làm việc tiếp theo: hãy gửi ngày đó vào due_date. API không tự áp dụng miễn tiền chậm nộp hay gia hạn do cơ quan thuế quyết định.
Tham số
| Tên | Vị trí | Kiểu | Bắt buộc | Mặc định | |
|---|---|---|---|---|---|
kind | query|body | string | không | tax | tax, social_insurance, fine, civil, loan_overdue hoặc custom. |
amount | query|body | number | có | Số tiền chậm nộp (đồng). | |
due_date | query|body | string | có | Hạn nộp (YYYY-MM-DD). | |
paid_date | query|body | string | không | Ngày nộp hết số nợ. | |
payments | body | array | không | Các lần nộp: [{"date":"2026-04-10","amount":50000000}]. | |
to | query|body | string | không | Tính đến hết ngày này (mặc định hôm nay khi chưa nộp). | |
rate_percent_per_year | query|body | number | không | Lãi suất thỏa thuận / lãi suất vay cho civil, loan_overdue, custom. | |
rate_percent_per_day | query|body | number | không | Mức tính theo ngày tự nhập (ví dụ BHXH trước 7/2025). | |
include_payment_day | query|body | boolean | không | Tính cả ngày nộp tiền. |
Ví dụ
curl "https://apibox.io.vn/v1/vn-late-interest?amount=100000000&due_date=2026-07-20&paid_date=2026-08-15" \
-H "Authorization: Bearer YOUR_API_KEY"const res = await fetch('https://apibox.io.vn/v1/vn-late-interest?amount=100000000&due_date=2026-07-20&paid_date=2026-08-15', {
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-late-interest?amount=100000000&due_date=2026-07-20&paid_date=2026-08-15",
headers={"Authorization": "Bearer YOUR_API_KEY"},
timeout=30,
)
print(res.json())<?php
$ch = curl_init('https://apibox.io.vn/v1/vn-late-interest?amount=100000000&due_date=2026-07-20&paid_date=2026-08-15');
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ề
{
"kind": "tax",
"name_vi": "Tiền chậm nộp thuế, khoản thu khác do cơ quan thuế, hải quan quản lý",
"name_en": "Late payment interest on tax",
"amount": 100000000,
"due_date": "2026-07-20",
"calculated_to": "2026-08-14",
"days_late": 25,
"interest": 750000,
"outstanding_principal": 0,
"total_still_due": 750000,
"segments": [
{
"from": "2026-07-21",
"to": "2026-08-14",
"days": 25,
"balance": 100000000,
"rate_percent_per_day": 0.03,
"interest": 750000,
"ref": "Luật Quản lý thuế 108/2025/QH15 Điều 16 khoản 2; Nghị định 252/2026/NĐ-CP Điều 26: 0,03%/ngày"
}
],
"payments": [
{
"date": "2026-08-15",
"amount": "remaining balance",
"balance_after": 0
}
],
"day_count": "day after due date → day before payment (inclusive)",
"legal": [
"Luật Quản lý thuế 108/2025/QH15 Điều 16 khoản 2; Nghị định 252/2026/NĐ-CP Điều 26: 0,03%/ngày"
],
"reviewed": "2026-11-11"
}
Ứng dụng
- Tự tính tiền chậm nộp khi lập giấy nộp tiền trong phần mềm kế toán
- Tính tiền lãi chậm đóng BHXH, BHYT, BHTN
- Tính lãi chậm thanh toán hóa đơn theo Bộ luật Dân sự
- Đối chiếu số tiền trên thông báo của cơ quan thuế
Hỏi đáp
Luật Quản lý thuế 2025 có đổi mức tiền chậm nộp không?
Không. Luật Quản lý thuế 108/2025/QH15 (hiệu lực 1/7/2026) giữ mức 0,03%/ngày (Điều 16 khoản 2 điểm a); thời gian tính theo Nghị định 252/2026/NĐ-CP Điều 26.
Có tính ngày nghỉ, ngày lễ không?
Có, tính theo ngày dương lịch liên tục. Chỉ riêng hạn nộp được lùi sang ngày làm việc tiếp theo khi trùng ngày nghỉ.
Chậm thanh toán hóa đơn thương mại tính lãi thế nào?
Theo Bộ luật Dân sự Điều 357: lãi suất thỏa thuận (tối đa 20%/năm) hoặc 10%/năm. Hợp đồng thương mại có thể đòi lãi theo lãi suất nợ quá hạn trung bình thị trường (Luật Thương mại Điều 306): gửi vào rate_percent_per_year.
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.