Hệ thống tài khoản kế toán API

Tra tài khoản kế toán theo Thông tư 99/2025 (áp dụng từ 2026) hoặc 133/2016, tìm theo tên, xem cấp tài khoản và đối chiếu tài khoản TT 200 sang TT 99.

GEThttps://apibox.io.vn/v1/vn-accounts/{number}
Dữ liệu & JSON▶ Dùng thử online

API hệ thống tài khoản trả về danh mục tài khoản kế toán chính thức: mặc định là Thông tư 99/2025/TT-BTC (Phụ lục II, áp dụng cho năm tài chính bắt đầu từ ngày 01/01/2026, thay thế Thông tư 200/2014), hoặc Thông tư 133/2016/TT-BTC cho doanh nghiệp nhỏ và vừa với chart=tt133. Tra một tài khoản (/v1/vn-accounts/3331) để có tên tiếng Việt và tiếng Anh, cấp, loại tài khoản, các tài khoản cấp trên và tài khoản chi tiết; hoặc liệt kê và tìm kiếm bằng q (gõ có dấu hay không dấu đều được, tien gui ra 112 và 1281; gõ số để tìm theo đầu số hiệu), level (1–4) và group (loại 1–9).

Khi chuyển đổi, mapping=tt200 liệt kê mọi tài khoản cấp 1 của Thông tư 200 cùng tài khoản tương ứng trong Thông tư 99 và loại thay đổi: thêm mới (215 Tài sản sinh học, 332 Phải trả cổ tức, lợi nhuận), bỏ (161, 417, 461, 611, 631), gộp (441 và 466 chuyển số dư sang 4118 theo Điều 29), đổi tên (112 Tiền gửi không kỳ hạn…) hoặc đổi tài khoản cấp 2. Lọc bằng change=removed, hoặc một tài khoản với tt200=441.

Danh mục được nhập tay từ phụ lục của các thông tư và rà soát hằng năm; mọi kết quả đều kèm số thông tư, ngày hiệu lực và ngày rà soát. Tên tiếng Anh do chúng tôi tự dịch, không phải bản dịch chính thức.

Tham số

TênVị tríKiểuBắt buộcMặc định
numberpath|querystringkhôngSố hiệu tài khoản (3–6 chữ số), trên đường dẫn hoặc qua ?number=.
chartquerystringkhôngtt99tt99 (Thông tư 99/2025, doanh nghiệp) hoặc tt133 (Thông tư 133/2016, DN nhỏ và vừa).
qquerystringkhôngTừ khoá (có hoặc không dấu) hoặc đầu số hiệu tài khoản.
levelquerynumberkhôngChỉ lấy tài khoản cấp này (1–4).
groupquerynumberkhôngChỉ lấy loại tài khoản này (1–9).
mappingquerystringkhôngtt200: bảng đối chiếu tài khoản cấp 1 Thông tư 200 sang Thông tư 99.
tt200querystringkhôngDùng với mapping: một tài khoản của Thông tư 200, ví dụ 441.
changequerystringkhôngDùng với mapping: added, removed, merged, renamed, changed_sub hoặc unchanged.
limitquerynumberkhôngSố tài khoản tối đa trong danh sách (1–500).

Ví dụ

curl "https://apibox.io.vn/v1/vn-accounts/3331" \
  -H "Authorization: Bearer YOUR_API_KEY"

Kết quả trả về

{
  "number": "3331",
  "name_vi": "Thuế giá trị gia tăng phải nộp",
  "name_en": "VAT payable",
  "level": 2,
  "parent": "333",
  "group": 3,
  "group_name_vi": "Loại tài khoản nợ phải trả",
  "group_name_en": "Liabilities",
  "hierarchy": [
    {
      "number": "333",
      "name_vi": "Thuế và các khoản phải nộp Nhà nước",
      "name_en": "Taxes and other payables to the State",
      "level": 1,
      "parent": null,
      "group": 3
    }
  ],
  "children": [
    {
      "number": "33311",
      "name_vi": "Thuế GTGT đầu ra",
      "name_en": "Output VAT",
      "level": 3,
      "parent": "3331",
      "group": 3
    },
    {
      "number": "33312",
      "name_vi": "Thuế GTGT hàng nhập khẩu",
      "name_en": "VAT on imports",
      "level": 3,
      "parent": "3331",
      "group": 3
    }
  ],
  "tt200_mapping": [
    {
      "tt200": "333",
      "tt200_name_vi": "Thuế và các khoản phải nộp Nhà nước",
      "tt99": "333",
      "tt99_name_vi": "Thuế và các khoản phải nộp Nhà nước",
      "change": "unchanged",
      "note_vi": "Giữ nguyên số hiệu, tên và TK cấp 2.",
      "note_en": "Number, name and level-2 accounts unchanged."
    }
  ],
  "chart": "tt99",
  "circular": "99/2025/TT-BTC",
  "title_vi": "Thông tư hướng dẫn Chế độ kế toán doanh nghiệp",
  "issued": "2025-10-27",
  "effective_from": "2026-01-01",
  "appendix": "Phụ lục II",
  "replaces": [
    "200/2014/TT-BTC",
    "75/2015/TT-BTC",
    "53/2016/TT-BTC",
    "195/2012/TT-BTC"
  ],
  "transition_vi": "Điều 29 (Chuyển đổi số dư trên sổ kế toán) và Điều 30 (Điều khoản chuyển tiếp).",
  "account_count": 184,
  "reviewed": "2026-11-11",
  "translation_note": "name_en is an unofficial translation"
}

Ứng dụng

  • Chuyển phần mềm kế toán, ERP từ TT 200 sang TT 99
  • Kiểm tra số hiệu tài khoản trong bút toán nhập từ file
  • Hiển thị tên tài khoản trong ứng dụng ghi sổ, hoá đơn
  • Làm ô chọn tài khoản có tìm kiếm

Hỏi đáp

Mặc định API trả về hệ thống tài khoản nào?

Thông tư 99/2025/TT-BTC, áp dụng cho doanh nghiệp từ năm tài chính 2026. Dùng chart=tt133 cho chế độ kế toán doanh nghiệp nhỏ và vừa, vẫn còn hiệu lực năm 2026.

Số dư tài khoản 441 chuyển đi đâu?

Điều 29 Thông tư 99 chuyển số dư 441 và 466 sang 4118 (vốn khác của chủ sở hữu); xem bằng mapping=tt200&tt200=441.

Doanh nghiệp có được tự mở thêm tài khoản chi tiết không?

Có, Điều 11 Thông tư 99 cho phép doanh nghiệp tự mở thêm; API chỉ trả về các tài khoản do Bộ Tài chính quy định.

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í →