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.
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ên | Vị trí | Kiểu | Bắt buộc | Mặc định | |
|---|---|---|---|---|---|
number | path|query | string | không | Số hiệu tài khoản (3–6 chữ số), trên đường dẫn hoặc qua ?number=. | |
chart | query | string | không | tt99 | tt99 (Thông tư 99/2025, doanh nghiệp) hoặc tt133 (Thông tư 133/2016, DN nhỏ và vừa). |
q | query | string | không | Từ khoá (có hoặc không dấu) hoặc đầu số hiệu tài khoản. | |
level | query | number | không | Chỉ lấy tài khoản cấp này (1–4). | |
group | query | number | không | Chỉ lấy loại tài khoản này (1–9). | |
mapping | query | string | không | tt200: bảng đối chiếu tài khoản cấp 1 Thông tư 200 sang Thông tư 99. | |
tt200 | query | string | không | Dùng với mapping: một tài khoản của Thông tư 200, ví dụ 441. | |
change | query | string | không | Dùng với mapping: added, removed, merged, renamed, changed_sub hoặc unchanged. | |
limit | query | number | không | Số 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"const res = await fetch('https://apibox.io.vn/v1/vn-accounts/3331', {
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-accounts/3331",
headers={"Authorization": "Bearer YOUR_API_KEY"},
timeout=30,
)
print(res.json())<?php
$ch = curl_init('https://apibox.io.vn/v1/vn-accounts/3331');
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ề
{
"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
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.