Đọc file XML tờ khai thuế HTKK (01/GTGT, 05/QTT) online
Đọc XML tờ khai thuế HTKK / eTax (01/GTGT, 05/QTT-TNCN…) thành JSON có tên chỉ tiêu và kiểm tra, hoặc lập bảng kê 05-1/BK-QTT-TNCN dạng XLSX.
Kết quả
Bấm “Chạy” để xem kết quả.
action=parse (mặc định) đọc file XML tờ khai đã nộp, xuất từ HTKK hoặc tải từ cổng eTax: mã và tên mẫu, thông tư, tờ khai chính thức hay bổ sung, kỳ tính thuế, người nộp thuế, cơ quan thuế, từng chỉ tiêu [NN] và giá trị, các phụ lục và file có chữ ký số hay không. Tên chỉ tiêu và kiểm tra số học có cho 01/GTGT (TT 80/2021 và TT 89/2026, áp dụng từ kỳ tính thuế 01/7/2026, có chỉ tiêu mới [32b], [34a]) và 05/QTT-TNCN (TT 80/2021); các mẫu khác trả mã chỉ tiêu và giá trị. Dùng để tổng hợp nhiều kỳ hoặc nhiều khách hàng vào bảng tính.
action=bk05_1 lập Phụ lục 05-1/BK-QTT-TNCN (cá nhân cư trú có hợp đồng lao động) từ các dòng JSON / CSV / XLSX: họ tên, mã số thuế hoặc số định danh, thu nhập chịu thuế, bảo hiểm, số người phụ thuộc, thuế đã khấu trừ, có ủy quyền quyết toán hay không. API kiểm tra mã số thuế (số kiểm tra, số định danh 12 chữ số), tính giảm trừ gia cảnh, thu nhập tính thuế [21] và với người ủy quyền: thuế phải nộp [24] theo biểu lũy tiến năm year (lấy từ /v1/vn-pit-annual), nộp thừa [25], còn phải nộp [26] và các chỉ tiêu tổng [28]–[43]. format=xlsx trả các cột theo thứ tự HTKK ([06]–[27]) để dán vào mẫu bảng kê của phiên bản HTKK bạn dùng. API không sinh file XML để nộp.
Dùng trong code của bạn
curl -X POST "https://apibox.io.vn/v1/vn-tax-form-xml" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/xml" \
--data-binary '<HSoThueDTu><HSoKhaiThue><TTinChung><TTinTKhaiThue><TKhaiThue><maTKhai>842</maTKhai><tenTKhai>TỜ KHAI THUẾ GIÁ TRỊ GIA TĂNG (Mẫu số 01/GTGT)</tenTKhai><moTaBMau>(Ban hành kèm theo Thông tư số 89/2026/TT-BTC…)</moTaBMau><loaiTKhai>C</loaiTKhai><KyKKhaiThue><kieuKy>M</kieuKy><kyKKhai>08/2026</kyKKhai></KyKKhaiThue></TKhaiThue><NNT><mst>0100109106</mst><tenNNT>CÔNG TY TNHH DEMO</tenNNT></NNT></TTinTKhaiThue></TTinChung><CTieuTKhaiChinh><ct22>5000000</ct22><ct25>20000000</ct25>…<ct40>5000000</ct40></CTieuTKhaiChinh></HSoKhaiThue></HSoThueDTu>'const res = await fetch('https://apibox.io.vn/v1/vn-tax-form-xml', {
method: 'POST',
headers: {
Authorization: 'Bearer YOUR_API_KEY',
'Content-Type': 'application/xml',
},
body: "<HSoThueDTu><HSoKhaiThue><TTinChung><TTinTKhaiThue><TKhaiThue><maTKhai>842</maTKhai><tenTKhai>TỜ KHAI THUẾ GIÁ TRỊ GIA TĂNG (Mẫu số 01/GTGT)</tenTKhai><moTaBMau>(Ban hành kèm theo Thông tư số 89/2026/TT-BTC…)</moTaBMau><loaiTKhai>C</loaiTKhai><KyKKhaiThue><kieuKy>M</kieuKy><kyKKhai>08/2026</kyKKhai></KyKKhaiThue></TKhaiThue><NNT><mst>0100109106</mst><tenNNT>CÔNG TY TNHH DEMO</tenNNT></NNT></TTinTKhaiThue></TTinChung><CTieuTKhaiChinh><ct22>5000000</ct22><ct25>20000000</ct25>…<ct40>5000000</ct40></CTieuTKhaiChinh></HSoKhaiThue></HSoThueDTu>",
});
const data = await res.json();
console.log(data);import requests
res = requests.post(
"https://apibox.io.vn/v1/vn-tax-form-xml",
headers={"Authorization": "Bearer YOUR_API_KEY", "Content-Type": "application/xml"},
data="<HSoThueDTu><HSoKhaiThue><TTinChung><TTinTKhaiThue><TKhaiThue><maTKhai>842</maTKhai><tenTKhai>TỜ KHAI THUẾ GIÁ TRỊ GIA TĂNG (Mẫu số 01/GTGT)</tenTKhai><moTaBMau>(Ban hành kèm theo Thông tư số 89/2026/TT-BTC…)</moTaBMau><loaiTKhai>C</loaiTKhai><KyKKhaiThue><kieuKy>M</kieuKy><kyKKhai>08/2026</kyKKhai></KyKKhaiThue></TKhaiThue><NNT><mst>0100109106</mst><tenNNT>CÔNG TY TNHH DEMO</tenNNT></NNT></TTinTKhaiThue></TTinChung><CTieuTKhaiChinh><ct22>5000000</ct22><ct25>20000000</ct25>…<ct40>5000000</ct40></CTieuTKhaiChinh></HSoKhaiThue></HSoThueDTu>".encode(),
timeout=30,
)
print(res.json())<?php
$ch = curl_init('https://apibox.io.vn/v1/vn-tax-form-xml');
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_CUSTOMREQUEST => 'POST',
CURLOPT_HTTPHEADER => ['Authorization: Bearer YOUR_API_KEY', 'Content-Type: application/xml'],
CURLOPT_POSTFIELDS => '<HSoThueDTu><HSoKhaiThue><TTinChung><TTinTKhaiThue><TKhaiThue><maTKhai>842</maTKhai><tenTKhai>TỜ KHAI THUẾ GIÁ TRỊ GIA TĂNG (Mẫu số 01/GTGT)</tenTKhai><moTaBMau>(Ban hành kèm theo Thông tư số 89/2026/TT-BTC…)</moTaBMau><loaiTKhai>C</loaiTKhai><KyKKhaiThue><kieuKy>M</kieuKy><kyKKhai>08/2026</kyKKhai></KyKKhaiThue></TKhaiThue><NNT><mst>0100109106</mst><tenNNT>CÔNG TY TNHH DEMO</tenNNT></NNT></TTinTKhaiThue></TTinChung><CTieuTKhaiChinh><ct22>5000000</ct22><ct25>20000000</ct25>…<ct40>5000000</ct40></CTieuTKhaiChinh></HSoKhaiThue></HSoThueDTu>',
]);
$response = curl_exec($ch);
print_r(json_decode($response, true));Tài liệu API → Nhận API key miễn phí
Hỏi đáp
Hỗ trợ những phiên bản mẫu nào?
Tên chỉ tiêu và kiểm tra: 01/GTGT (TT 80/2021 và TT 89/2026) và 05/QTT-TNCN (TT 80/2021). Mọi mẫu HTKK khác được đọc thành mã chỉ tiêu và giá trị. Bảng kê 05-1/BK theo bố cục cột [06]–[27] của TT 80/2021.
Có nộp thẳng kết quả cho cơ quan thuế được không?
Không. API chỉ đọc tờ khai đã nộp và chuẩn bị các dòng bảng kê 05-1/BK; bạn nhập vào HTKK, kiểm tra và ký số tờ khai.
Số định danh cá nhân có dùng thay mã số thuế được không?
Có. Từ 01/7/2025 số định danh cá nhân 12 chữ số được dùng làm mã số thuế; mã 10 chữ số được kiểm tra bằng chữ số kiểm tra mod 11.