Thu thập & chuẩn hoá biểu thuế, chính sách và văn bản pháp luật XNK thành dữ liệu sạch, phơi ra API chuẩn cho ERP và cộng đồng. Toàn bộ dữ liệu pháp quy công khai — không giấu.
Số liệu cập nhật trực tiếp từ kho dữ liệu.
Ba việc lõi phục vụ nghiệp vụ khai báo Hải quan.
Nhập tên hàng → gợi ý mã HS kèm độ tin cậy, áp 6 quy tắc GIR (WCO) và đối chiếu tiền lệ. /api/suggest
Tra thuế NK/ACFTA/VAT theo mã HS, kèm cảnh báo giấy phép/kiểm tra chuyên ngành + link văn bản. /api/tax
Tạo mô tả hàng hoá chuẩn Thông tư 39/2018 để khai tờ khai Hải quan. /api/describe
Hàng nghìn tên sản phẩm ví dụ cho mã HS 8 số "Loại khác" — giúp tra cứu & AI hiểu phạm vi từng mã. /api/products
Không tô hồng: chấm AI trên mẫu tờ khai thật, phủ mọi chương HS.
Hệ thống định nghĩa & mô tả sản phẩm cho nhóm mã residual (không khớp mã con cụ thể).
Đang tải corpus Loại khác…
| Mã HS | Phạm vi (h6En) | Sản phẩm ví dụ | Độ đào |
|---|---|---|---|
| Đang tải… | |||
Từ mã HS 8 số đã chốt → mô tả một dòng khớp ô ECUS/VNACCS, chấm compliance TT 39/2018.
Đang tải…
Bỏ phụ kiện trước (quy cách → công dụng → thông số → thành phần → model → nhãn hiệu). Xuất xứ + tình trạng luôn giữ cuối.
Văn bản được trích tự động từ chính sách của … mã HS. Ô verified = tiêu đề đã đối chiếu nguồn chính thống.
| Mã văn bản | Tiêu đề | Cơ quan | Trích dẫn | |
|---|---|---|---|---|
| Đang tải… | ||||
Dữ liệu đi qua pipeline nhiều lớp, mỗi lớp làm sạch thêm.
Nguồn thô → Chuẩn hoá → File sạch → API ───────────────────────────────────────────────────────────────────────────────────────────── Biểu thuế TCHQ (Excel) → import + snapshot → tax.json (11.871 mã) → /api/tax Cột chính sách (chữ tự do) → Gemini bóc tách (AI) → tax-enriched.json → warnings Mã văn bản trong chính sách → extract-legal-refs → legal-docs.json (108) → /api/legal-docs Tiêu đề VB (tra tay, chính thống) → legal-doc-titles.json → apply-verified-titles → tiêu đề thật (50) Mã Loại khác (residual) → domain template + index → loai-khac-products.jsonl → /api/products Mô tả ECUS (≤200 ký tự) → AI + compose + validator → customsDescription → /api/describe Kho tri thức cũ → import-legacy → notes/precedents/... → /api/notes...
API dành cho hệ thống (ERP, tích hợp) — cần Bearer token. Xem tài liệu đầy đủ trên GitHub.
GET /api/tax?hs=85171300
→ tên hàng, thuế NK/ACFTA/VAT, cảnh báo chính sách + văn bản liên quan.
GET /api/legal-docs?issuer=BCT
→ danh sách văn bản kèm tiêu đề & link gốc.
Chỉ /api/health không cần token; còn lại cần header
Authorization: Bearer <token>.
Bấm Chi tiết ở từng dòng để xem ví dụ curl + response thực tế.
| Endpoint | Method | Token | Khi nào dùng | |
|---|---|---|---|---|
| Đang tải hướng dẫn API… | ||||
* /api/match có thể bỏ token khi bật HS_MATCH_PUBLIC=true (server-to-server ERP).
Về hạ tầng: chạy trên Vercel Pro; nhiều route logic được gộp qua rewrite trong vercel.json (vd dataset.js gánh hàng chục resource) để ít cold start & repo gọn — URL công khai vẫn tách bạch.
Đây là dự án cộng đồng — mọi góp ý, phát hiện sai sót, đề xuất tính năng đều quý. Góp ý gửi công khai qua GitHub (cần tài khoản GitHub, miễn phí).
Nút này mở GitHub với nội dung điền sẵn để bạn xác nhận đăng.
Đặt câu hỏi, chia sẻ kinh nghiệm phân loại HS, thảo luận chính sách XNK cùng mọi người.