Mã chương, tiểu mục nộp thuế API
Tra mã chương và mã tiểu mục (NDKT) khi nộp thuế theo Thông tư 130/2025/TT-BTC, kèm mã tiền chậm nộp tương ứng và các khoản đã bãi bỏ như lệ phí môn bài.
Khi nộp thuế cần hai mã trong mục lục ngân sách nhà nước: mã chương của người nộp, ví dụ 554 / 854 cho công ty ngoài quốc doanh, 557 / 857 cho hộ gia đình, cá nhân, và mã tiểu mục của khoản thu, ví dụ 1001 thuế TNCN từ tiền lương, 1052 thuế TNDN, 1701 thuế GTGT hàng sản xuất trong nước, 2801 lệ phí trước bạ. API có 35 mã chương người nộp thuế hay dùng và 215 tiểu mục thuế, phí, lệ phí, tiền phạt, tiền chậm nộp theo Thông tư 130/2025/TT-BTC (hiệu lực 1/1/2026), đã cập nhật Thông tư 123/2026/TT-BTC (21/8/2026, ví dụ mã mới cho tài sản mã hóa 1016 / 1059).
Tra một mã (code; mã chương cấp huyện cũ như 757 sẽ chỉ sang mã mới 857), tìm theo từ khóa (q) tiếng Việt có dấu hoặc không dấu (“thue tncn”, “trước bạ”) hay tiếng Anh, hoặc lọc theo loại thuế (tax: pit, cit, vat, excise, import, env, resource, land, registration, licence, late_interest, fine, fee). Mỗi tiểu mục thuế đi kèm tiểu mục tiền chậm nộp tương ứng (Mục 4900).
Lệ phí môn bài (2862–2864) được đánh dấu đã bãi bỏ từ 1/1/2026, các mã chỉ còn dùng để nộp nợ các năm trước. Tên tiếng Anh do chúng tôi dịch.
Tham số
| Tên | Vị trí | Kiểu | Bắt buộc | Mặc định | |
|---|---|---|---|---|---|
code | query | string | không | Mã chương (3 số) hoặc mục / tiểu mục (4 số); hoặc /v1/vn-budget-codes/1001. | |
q | query | string | không | Từ khóa (tiếng Việt có hoặc không dấu, hoặc tiếng Anh). | |
tax | query | string | không | pit, cit, vat, excise, import, export, env, resource, land, registration, licence, late_interest, fine, fee, other. | |
type | query | string | không | all | all, chapter hoặc sub_item. |
active_only | query | boolean | không | Ẩn các khoản đã bãi bỏ. | |
limit | query | number | không | 50 | Số kết quả tối đa (1–500). |
Ví dụ
curl "https://apibox.io.vn/v1/vn-budget-codes?code=1001" \
-H "Authorization: Bearer YOUR_API_KEY"const res = await fetch('https://apibox.io.vn/v1/vn-budget-codes?code=1001', {
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-budget-codes?code=1001",
headers={"Authorization": "Bearer YOUR_API_KEY"},
timeout=30,
)
print(res.json())<?php
$ch = curl_init('https://apibox.io.vn/v1/vn-budget-codes?code=1001');
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ề
{
"code": "1001",
"kind": "sub_item",
"muc": "1000",
"muc_name_vi": "Thuế thu nhập cá nhân",
"tax": "pit",
"status": "active",
"name_vi": "Thuế thu nhập từ tiền lương, tiền công",
"name_en": "Tax on income from salaries and wages",
"late_interest_code": "4917",
"late_interest": {
"code": "4917",
"kind": "sub_item",
"muc": "4900",
"muc_name_vi": "Các khoản thu khác",
"tax": "late_interest",
"status": "active",
"name_vi": "Tiền chậm nộp thuế thu nhập cá nhân (không bao gồm tiền chậm nộp thuế thu nhập cá nhân từ hoạt động giao dịch, chuyển nhượng, kinh doanh tài sản mã hoá)",
"name_en": "Late-payment interest on PIT (excl. crypto-asset PIT)"
},
"legal": [
"Thông tư 130/2025/TT-BTC (hiệu lực 01/01/2026)",
"Thông tư 123/2026/TT-BTC (sửa đổi, hiệu lực 21/8/2026)"
],
"reviewed": "2026-11-11"
}
Ứng dụng
- Điền mã trên giấy nộp tiền vào NSNN trong ứng dụng ngân hàng
- Ánh xạ loại thuế sang tiểu mục trong phần mềm kế toán
- Tìm mã tiểu mục tiền chậm nộp đúng với loại thuế
- Chuyển mã chương cấp huyện cũ sang mã cấp xã mới
Hỏi đáp
Thông tư 130/2025 có đổi mã tiểu mục thuế không?
Không có mã thuế, phí hay tiền chậm nộp nào bị đổi số so với TT 324/2016, chỉ một số tên được sửa. Mã chương cấp huyện 754–760 đã chuyển thành 854–860 từ 1/7/2025.
Cá nhân nộp thuế TNCN dùng chương nào?
557 nếu do cơ quan thuế cấp tỉnh quản lý, 857 nếu do thuế cơ sở quản lý (ghi chú Mục 1000 TT 130/2025).
Còn phải nộp lệ phí môn bài không?
Không. Lệ phí môn bài bãi bỏ từ 1/1/2026 (Nghị quyết 198/2025/QH15); mã vẫn được giữ để thu nợ các năm trước.
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.