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.

GEThttps://apibox.io.vn/v1/vn-budget-codes
Dữ liệu & JSON▶ Dùng thử online

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ênVị tríKiểuBắt buộcMặc định
codequerystringkhôngMã chương (3 số) hoặc mục / tiểu mục (4 số); hoặc /v1/vn-budget-codes/1001.
qquerystringkhôngTừ khóa (tiếng Việt có hoặc không dấu, hoặc tiếng Anh).
taxquerystringkhôngpit, cit, vat, excise, import, export, env, resource, land, registration, licence, late_interest, fine, fee, other.
typequerystringkhôngallall, chapter hoặc sub_item.
active_onlyquerybooleankhôngẨn các khoản đã bãi bỏ.
limitquerynumberkhông50Số 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"

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

Bắt đầu với 1.000 request miễn phí mỗi tháng. Nhận API key miễn phí →