HitechCloud v2
VI EN
Portal Lấy khoá API
Doanh nghiệp & Thuế opengov/customs/hs-codes

Danh mục hàng hoá xuất nhập khẩu Việt Nam theo mã HS, tra theo tiền tố

Mỗi dòng gồm mã HS (tới 8 chữ số) và mô tả hàng hoá. BẮT BUỘC có tham số `prefix` từ 2 chữ số trở lên: nguồn không có phân trang, nên một truy vấn rộng kéo về hàng megabyte trong một lượt — vừa nặng cho máy chủ cơ quan nhà nước, vừa không dùng được. Ví dụ `prefix=87` (chương phương tiện vận tải) trả về toàn chương; `prefix=8703` (ô tô chở người) đo được 519 dòng. Kết quả trên 1.000 dòng bị cắt và endpoint NÓI RA điều đó ở trường `warning` kèm tổng số thật — im lặng cắt bớt sẽ khiến người gọi kết luận sai rằng một mã HS không tồn tại. Danh mục này ban hành kèm Thông tư của Bộ Tài chính về Danh mục hàng hoá xuất khẩu, nhập khẩu Việt Nam; dùng để khai báo hải quan và tra biểu thuế.

GET https://api-tools.hitechcloud.vn/api/opengov/customs/hs-codes Đã chép
Cần khoá API

Tham số

prefix string · truy vấn bắt buộc

Tiền tố mã HS, 2–8 chữ số. BẮT BUỘC — nguồn không có phân trang nên phải thu hẹp. Ký tự không phải chữ số bị bỏ qua, nên 87.038703 cho cùng kết quả. Dưới 2 chữ số trả 422.

Mã trả về

200 Thành công.
401 Thiếu hoặc sai khoá API. Gửi kèm header X-API-Key.
404 Không tìm thấy dữ liệu tương ứng.
429 Vượt hạn mức của khoá. Xem header Retry-After.