API công khai & widget nhúng

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:

<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>

Xem thử tại /embed. Được phép nhúng ở mọi website; vui lòng giữ nguyên dòng ghi nguồn hscodevn.com. Thêm ?lang=en vào src để widget hiển thị tiếng Anh.

Dữ liệu tĩnh (JSON)

HSCodeVN là site tĩnh — không có API tính toán phía server. Toàn bộ biểu thuế 2026 được phát hành thẳng dưới dạng file JSON tĩnh, cache CDN dài hạn, dùng được trực tiếp không cần khóa API:

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ã, mô tả không dấu, cờ leaf) — dùng để tự triển khai tìm kiếm phía client.

/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.

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.