API công khai & widget nhúng

Name: Vietnam HS Code & Import-Export Tariff 2026 (AHTN 2022)
Creator: HSCodeVN
License: https://hscodevn.com/gioi-thieu

Dùng dữ liệu HSCodeVN trong phần mềm của bạn, hoặc nhúng ô tra cứu vào website — miễn phí.

Nhúng widget tra cứu vào website

Dán đoạn mã sau vào trang của bạn — người xem tra mã ngay tại chỗ, bấm kết quả sẽ mở trang chi tiết trên hscodevn.com:

Rộng (px)Cao (px)

<iframe
  src="https://hscodevn.com/embed"
  width="380" height="480"
  style="border:1px solid #e2e8f0;border-radius:12px"
  title="Tra cứu mã HS - hscodevn.com"
></iframe>

Được phép nhúng ở mọi website; vui lòng giữ nguyên dòng ghi nguồn hscodevn.com.

Dữ liệu tĩnh (JSON)

Toàn bộ biểu thuế 2026 được phát hành dưới dạng file JSON tĩnh — cache CDN dài hạn, CORS mở, dùng trực tiếp không cần khóa API hay đăng ký. (Các tính năng AI/sàng lọc của site chạy phía server nhưng không phải API công khai.)

Base URL: https://hscodevn.com · Đã bật CORS — gọi thẳng từ trình duyệt/AI agent. Tóm tắt cho LLM tại /llms.txt.

/data/2026/nodes.json

Toàn bộ cây danh mục HS: mọi node (Phần/Chương/Nhóm/Phân nhóm/dòng thuế) kèm mã, mô tả VI/EN, đơn vị tính, parentId.

/data/2026/search-index.json

Chỉ mục tìm kiếm phẳng (mã, cờ leaf, text bổ trợ SEN/tiền lệ/biểu Mỹ) — mô tả lấy từ nodes.json, join theo id.

/data/2026/rates/{chapter}.json

Thuế suất của mọi mã 8 số thuộc 1 chương (2 số đầu mã HS), gồm NK MFN, mọi FTA, VAT, TTĐB, BVMT kèm văn bản/hiệu lực.

Thử: /data/2026/rates/84.json

/data/2026/fta-meta.json

Tên, loại và mẫu C/O của từng biểu thuế/FTA xuất hiện trong rates/*.json.

/data/2026/code-mapping.json

Danh sách mã thêm mới/loại bỏ so với danh mục năm trước.

/data/2026/psr/{chapter}.json

Quy tắc xuất xứ cụ thể mặt hàng theo từng FTA, tiêu chí trích nguyên văn thông tư; psr/meta.json ghi thông tư nguồn, psr-general.json là quy tắc chung của từng hiệp định.

Thử: /data/2026/psr/61.json

/data/2026/classification/{chapter}.json

Thông báo phân loại / xác định trước mã số của cơ quan hải quan (2020–2026): số hiệu, ngày, mã được áp, tên hàng (OCR từ bản scan — đối chiếu văn bản gốc qua trường ma). classification/all.json gộp toàn bộ.

Thử: /data/2026/classification/85.json

/data/2026/trade/{chapter}.json

Kim ngạch XNK của Việt Nam theo phân nhóm HS6 (UN Comtrade): USD + kg theo năm và chiều, top đối tác. Trường mir là số dựng từ báo cáo nước đối tác cho năm Việt Nam chưa nộp — KHÔNG cùng đại lượng, chỉ so với cặp *Base của chính nó.

Thử: /data/2026/trade/76.json

/data/2026/xmap/us/{chapter}.json

Dòng thuế Hoa Kỳ (HTSUS) theo phân nhóm HS6: mã 10 số, mô tả đầy đủ, thuế General — mức áp cho hàng Việt Nam. xmap/us/meta.json ghi bản HTS và thuế bổ sung Chương 99 áp riêng hàng Việt Nam.

Thử: /data/2026/xmap/us/61.json

Muốn tính thuế hay tìm kiếm theo tên hàng bằng code của bạn? Chạy logic đó phía client trên dữ liệu tĩnh này — xem mã nguồn mở của lib/tax-calc.ts và lib/search.ts trên GitHub.

Dữ liệu chỉ mang tính tham khảo — xem miễn trừ trách nhiệm. Cấu trúc file có thể thay đổi; các thay đổi lớn sẽ ghi ở trang Cập nhật dữ liệu.