Tra cứu mã HS và biểu thuế API
Tra cứu và tìm mã HS Việt Nam 2026 (AHTN 2022) kèm thuế nhập khẩu thông thường, ưu đãi, VAT, thuế xuất khẩu, TTĐB, thuế suất FTA và chính sách.
API mã HS cung cấp Danh mục hàng hoá xuất nhập khẩu Việt Nam (AHTN 2022, Thông tư 31/2022/TT-BTC): 11.414 dòng thuế 8 số cùng các chương, nhóm và phân nhóm. Mỗi dòng có mô tả tiếng Việt và tiếng Anh, đơn vị tính, thuế nhập khẩu thông thường và ưu đãi (MFN), VAT, thuế xuất khẩu, thuế tiêu thụ đặc biệt, thuế bảo vệ môi trường, thuế suất ưu đãi đặc biệt theo từng hiệp định thương mại tự do (ATIGA, ACFTA, CPTPP, EVFTA, UKVFTA, RCEP theo nhóm đối tác…) và chính sách quản lý gắn với mã (giấy phép, kiểm tra chuyên ngành). VAT dạng 8/10 nghĩa là 10%, được giảm còn 8% theo nghị định giảm thuế GTGT.
Tra một mã trên đường dẫn (/v1/hs-code/8471.30.20, có hay không có dấu chấm đều được) hoặc qua ?code=: mã 2, 4, 6 số trả về mô tả, cây phân cấp, các mã con và số dòng thuế. Tìm kiếm với ?q= bằng tiếng Việt hoặc tiếng Anh (máy tính xách tay, laptop, cà phê rang), có dấu hay không dấu (khi gõ có dấu thì dấu được tính: bia khác bìa), hoặc theo đầu mã (q=8517); level chọn cấp 2, 4, 6, 8 hoặc any.
Dữ liệu lấy từ file “Biểu thuế xuất nhập khẩu” 2026 do Trung tâm WTO và Hội nhập – VCCI (trungtamwto.vn) tổng hợp từ biểu thuế hải quan, cập nhật hằng tuần, kèm phần hiệu chỉnh thủ công theo các nghị định ban hành sau. Đây là công cụ tra cứu, không có giá trị pháp lý: hãy đối chiếu văn bản pháp luật trước khi khai báo hải quan.
Tham số
| Tên | Vị trí | Kiểu | Bắt buộc | Mặc định | |
|---|---|---|---|---|---|
code | path|query | string | không | Mã HS 2, 4, 6 hoặc 8 số, dấu chấm tuỳ ý (8471.30.20), trên đường dẫn hoặc qua ?code=. | |
q | query | string | không | Từ khoá tìm kiếm (tiếng Việt hoặc tiếng Anh) hoặc đầu mã; bắt buộc khi không có mã. | |
level | query | string | không | 8 | Cấp tìm kiếm: 2, 4, 6, 8 hoặc any. |
limit | query | number | không | 20 | Số kết quả tìm kiếm (1–50). |
Ví dụ
curl "https://apibox.io.vn/v1/hs-code/8471.30.20" \
-H "Authorization: Bearer YOUR_API_KEY"const res = await fetch('https://apibox.io.vn/v1/hs-code/8471.30.20', {
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/hs-code/8471.30.20",
headers={"Authorization": "Bearer YOUR_API_KEY"},
timeout=30,
)
print(res.json())<?php
$ch = curl_init('https://apibox.io.vn/v1/hs-code/8471.30.20');
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": "84713020",
"level": 8,
"description_vi": "Máy tính xách tay kể cả notebook và subnotebook",
"description_en": "Laptops including notebooks and subnotebooks",
"unit": "chiếc",
"unit_en": "unit",
"normal_rate": 5,
"mfn_rate": 0,
"vat": "8/10",
"vat_reduction": null,
"export_rate": null,
"special_consumption_tax": null,
"environmental_tax": null,
"fta": {
"ACFTA": 0,
"ATIGA": 0,
"AJCEP": 0,
"VJEPA": 0,
"AKFTA": 0,
"AANZFTA": 0,
"AIFTA": 0,
"VKFTA": 0,
"VCFTA": 0,
"VN-EAEU": "*",
"CPTPP": 0,
"AHKFTA": 0,
"EVFTA": 0,
"UKVFTA": 0,
"VN-LAO": 0,
"VIFTA": 0,
"RCEPT": {
"A": 0,
"B": 0,
"C": 0,
"D": 0,
"E": 0,
"F": 0
}
},
"policies": "Hàng tiêu dùng QSD cấp NK (08/2023/TT-BCT - PL1.I); KTCN về hiệu suất năng lượng và dán nhãn năng lượng (1725/QĐ-BCT 2024); SP CNTT ĐQSD cấm NK (11/2018/TT-BTTTT); SPHH lĩnh vực CNTT và VT bắt buộc phải công bố hợp quy (29/2025/TT-BKHCN-PL2)",
"parent": "847130",
"path_vi": "Máy xử lý dữ liệu tự động và các khối chức năng của chúng; … > Máy xử lý dữ liệu tự động loại xách tay, có khối lượng không quá 10 kg, … > Máy tính xách tay kể cả notebook và subnotebook",
"path_en": "Automatic data processing machines and units thereof; … > Portable automatic data processing machines, weighing not more than 10 kg, … > Laptops including notebooks and subnotebooks",
"code_formatted": "8471.30.20",
"hierarchy": [
{
"code": "84",
"level": 2,
"description_vi": "Lò phản ứng hạt nhân, nồi hơi, máy và thiết bị cơ khí; các bộ phận của chúng",
"description_en": "Nuclear reactors, boilers, machinery and mechanical appliances; parts thereof"
},
{
"code": "847130",
"level": 6,
"description_vi": "Máy xử lý dữ liệu tự động loại xách tay, có khối lượng không quá 10 kg, gồm ít nhất một đơn vị xử lý dữ liệu trung tâm, một bàn phím và một màn hình:",
"description_en": "Portable automatic data processing machines, weighing not more than 10 kg, consisting of at least a central processing unit, a keyboard and a display:"
}
],
"chapter_98": [],
"data_version": "2026-33303fdd33",
"tariff_year": 2026,
"source": "Biểu thuế xuất nhập khẩu Việt Nam (Trung tâm WTO và Hội nhập – VCCI, trungtamwto.vn)",
"source_page": "https://trungtamwto.vn/chuyen-de/31581-bieu-thue-xuat-nhap-khau-viet-nam-nam-2026",
"note": "Lookup aid compiled from the customs tariff workbook; check the decree texts before declaring goods. VAT \"8/10\" = 10%, reduced to 8% where the reduction applies.",
"rcept_groups": {
"A": "ASEAN",
"B": "Australia",
"C": "China",
"D": "Japan",
"E": "Korea",
"F": "New Zealand"
}
}
Ứng dụng
- Ô chọn mã HS trong phần mềm khai hải quan, logistics
- Ước tính thuế nhập khẩu và VAT cho một mặt hàng
- So sánh thuế suất FTA để chọn xuất xứ hàng hoá
- Kiểm tra giấy phép, kiểm tra chuyên ngành theo mã HS
Hỏi đáp
VAT "8/10" nghĩa là gì?
Thuế GTGT 10%, được giảm còn 8% với hàng hoá thuộc diện của nghị định giảm thuế GTGT hiện hành.
Dữ liệu cập nhật đến khi nào?
File biểu thuế 2026 được kiểm tra hằng tuần; mỗi kết quả có data_version và trang nguồn, các nghị định mới được áp dụng qua phần hiệu chỉnh thủ công.
Có dùng kết quả để khai tờ khai hải quan được không?
Đây là công cụ hỗ trợ tra cứu. Việc phân loại và thuế suất cần đối chiếu văn bản pháp luật và hỏi cơ quan hải quan khi cần.
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.