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

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

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 có thể tra mã ngay tại chỗ, và khi bấm vào kết quả, trang chi tiết trên hscodevn.com sẽ mở ra:

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 tệp JSON tĩnh, lưu đệm CDN dài hạn, mở CORS, dùng trực tiếp mà không cần khóa API hay đăng ký. (Các tính năng AI và sàng lọc đối tác của HSCodeVN chạy phía máy chủ và không phải API công khai.)

Base URL: https://hscodevn.com · CORS đã được bật, nên có thể gọi trực tiếp từ trình duyệt hoặc AI agent. Bản tóm tắt cho LLM có 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ả tiếng Việt và tiếng Anh, đơn vị tính và parentId.

/data/2026/search-index.json

Chỉ mục tìm kiếm phẳng (mã, cờ leaf, văn bản bổ trợ từ SEN, tiền lệ phân loại và biểu thuế Hoa Kỳ). Mô tả nằm trong nodes.json, ghép theo id.

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

Thuế suất của mọi mã 8 số thuộc một chương (2 số đầu của mã HS), gồm thuế nhập khẩu MFN, mọi biểu FTA, VAT, thuế tiêu thụ đặc biệt và thuế bảo vệ môi trường, kèm văn bản và ngày 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ế và FTA xuất hiện trong rates/*.json.

/data/2026/code-mapping.json

Danh sách mã được thêm mới hoặc 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 và văn bản 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. Dữ liệu được nhận dạng (OCR) từ bản quét, vui lòng đố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 xuất nhập khẩu của Việt Nam theo phân nhóm HS6 (UN Comtrade): giá trị USD và khối lượng kg theo năm và theo chiều, cùng các đối tác lớn nhất. Trường mir là số liệu dựng từ báo cáo của nước đối tác cho những năm Việt Nam chưa nộp báo cáo. Đây không phải cùng một đại lượng, chỉ nên so sánh 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 đủ và thuế General, là mức áp cho hàng Việt Nam. xmap/us/meta.json ghi phiên bản HTS và thuế bổ sung Chương 99 áp riêng cho hàng Việt Nam.

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

Để tính thuế hoặc tìm kiếm theo tên hàng trong phần mềm của bạn, có thể chạy phần xử lý đó phía client trên chính dữ liệu tĩnh này. Tham khảo 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.