Mỗi lệnh gọi theo lô
200
Sản phẩm mỗi lệnh gọi
Một yêu cầu theo lô phân loại và định giá tối đa 200 sản phẩm song song, hoàn thành trong 3 đến 5 phút.
Sản phẩm
API phân loại và chi phí cập bến cho các nhà nhập khẩu khối lượng lớn
Các đơn vị giao nhận vận tải, nền tảng thương mại điện tử xuyên biên giới, đơn vị bưu chính và chuyển phát, cùng các nhà nhập khẩu số lượng lớn đưa hàng nghìn sản phẩm qua hải quan mỗi ngày. GingerControl API biến một mô tả sản phẩm đơn giản và nước xuất xứ thành một mã HTS cùng toàn bộ chồng thuế quan, để hệ thống của bạn có thể báo giá chi phí cập bến và chuẩn bị tờ khai mà không cần con người phân loại từng dòng.
Được xây dựng cho toàn bộ danh mục, không phải từng lần lẻ
Bậc production
200K+
Lượt phân loại mỗi ngày
Công suất production tiêu chuẩn. Các bậc doanh nghiệp tùy chỉnh có thể mở rộng đến 100K lượt phân loại mỗi giờ.
Nhà phát triển
Toàn bộ hợp đồng yêu cầu, phản hồi và lỗi nằm trong tài liệu tham chiếu API.
Tài liệu tham chiếu APIHoặc gửi email tới chen@gingercontrol.com để nhận key thử nghiệm.
Các con số thông lượng mô tả các API key bậc production tiêu chuẩn được đo trên lưu lượng thực. Công suất thực tế được định cỡ theo mẫu gọi và QPS đỉnh của từng khách hàng. Đầu ra phân loại là tài liệu nghiên cứu để đại lý hải quan có giấy phép xem xét trước khi khai báo.
Từ dòng sản phẩm đến chi phí cập bến chỉ trong một lệnh gọi
POST/v1/tariff
descriptionCotton T-shirt
countryVN
Gửi sản phẩm và xuất xứ
POST một mô tả sản phẩm và nước xuất xứ, một mục hoặc một lô tối đa 200. Không tra cứu biểu thuế, không xếp hàng chờ đại lý hải quan.
6109.10.0012
MFN
301
232
Ginger phân loại và tính toán
Bộ máy xác định mã HTS, rồi lắp ráp toàn bộ chồng thuế: mức thuế cơ bản MFN cộng với Section 301, 232, 122, và mọi mục Chương 99 áp dụng.
200 OK
hts_code
general_rate
Section 301
Section 232
Nhận về dữ liệu sẵn sàng cho chi phí cập bến
Một phản hồi JSON trả về mã HTS và mọi tầng thuế, sẵn sàng để đưa vào báo giá chi phí cập bến, chuẩn bị tờ khai hoặc bộ máy định giá của bạn.
Một yêu cầu vào, toàn bộ bức tranh thuế quan ra
Gửi một mô tả và một xuất xứ. Nhận về mã HTS và toàn bộ phân tích thuế trong một lệnh gọi. Đây là một ảnh chụp tiếp thị; tài liệu tham chiếu API mô tả mọi trường, mã lỗi và hành vi theo lô.
Yêu cầu
curl -X POST 'https://api.gingercontrol.com/openapi/v1/tariff' \
-H 'Content-Type: application/json' \
-H 'X-Api-Key: YOUR_API_KEY' \
-d {
"description": "Cotton knit short sleeve T-shirt",
"country_of_origin": "VN"
}Phản hồi
{
"hts_code": "6109.10.0012",
"tariffs": {
"general_rate": "16.5%",
"special_rate": "Free",
"Section 301": [],
"Section 232 - Metals": [],
"Section 122": [
{ "code": "9903.03.01", "rate": "10%" }
]
}
}Xem tài liệu tham chiếu API đầy đủ để biết về các yêu cầu theo lô, các bộ phận mã tách, ngữ nghĩa lỗi và giới hạn tốc độ.
Những gì API mang lại cho hệ thống của bạn
Phân loại
Phân loại HTS vững vàng ở quy mô danh mục, bao gồm cả những hàng hóa hỗn hợp mà hầu hết các API lặng lẽ bỏ qua.
6109.10
6109.10
6109.10
6109.10
6109.10
Phân loại HTS ở quy mô danh mục
Gửi những mô tả sản phẩm thực tế lộn xộn và nhận về một mã HTS 10 chữ số. Trong bài kiểm chuẩn nội bộ của chúng tôi trên hơn 1.000 sản phẩm, bộ máy đạt độ chính xác 99,86%, và mỗi kết quả là đầu ra nghiên cứu để đại lý hải quan có giấy phép xem xét trước khi khai báo.
Tính toán
Không chỉ mức thuế cơ bản. Toàn bộ chồng thuế thực sự áp lên tờ khai.
MFN
301
232
122
Ch 99
Total
Toàn bộ chồng thuế đến kho
Mỗi phản hồi mang theo mức thuế General (MFN) và Special cùng Section 301, Section 232, Section 122, và mọi mục Chương 99 áp dụng, để con số chi phí cập bến của bạn phản ánh đúng những gì hải quan thực sự sẽ áp.
Tích hợp
Các hợp đồng có thể dự đoán và các chế độ lỗi rõ ràng, những thứ mà một đội vận hành lập kế hoạch dựa vào.
POST/tariff1 item
POST/tariff/batch200
Điểm cuối đơn lẻ và theo lô
Phân loại một sản phẩm cho báo giá thanh toán trực tiếp, hoặc đẩy tối đa 200 mục trong một lệnh gọi theo lô cho một lượt chạy danh mục ban đêm. Cả hai điểm cuối dùng chung một cấu trúc phản hồi và một hạn ngạch.
Ai xây dựng dựa trên nó
API được xây dựng cho các đơn vị vận hành đưa khối lượng lớn hàng bán lẻ, hàng tạp hóa và bưu kiện qua hải quan mỗi ngày, nơi việc phân loại từng dòng bằng tay đơn giản là không thể mở rộng.
Đơn vị giao nhận vận tải
Phân loại và định giá toàn bộ bảng kê lô hàng của khách hàng trước khi xe rời đi, thay vì chờ đại lý hải quan cho từng dòng.
Thương mại điện tử xuyên biên giới
Hiển thị chi phí cập bến đã bao gồm thuế chính xác ngay khi thanh toán để người mua không bị bất ngờ bởi các khoản phí hải quan lúc giao hàng.
Đơn vị bưu chính và chuyển phát
Chạy mã HTS và thuế trên các luồng bưu kiện đến khối lượng lớn để cung cấp cho tờ khai hải quan và trả trước.
Sàn giao dịch và nền tảng bán lẻ
Cung cấp cho hàng nghìn người bán bên thứ ba các mã HTS và ước tính thuế chính xác mà không cần bố trí một đội phân loại.
3PL và hoàn tất đơn hàng
Tích hợp phân loại và chi phí cập bến vào quy trình tiếp nhận để mọi danh mục khách hàng mới đều sẵn sàng khai báo ngay từ ngày đầu.
ERP, TMS và bộ máy định giá
Nhúng dữ liệu thuế trực tiếp vào nền tảng mà chính khách hàng của bạn đang dùng, không cần duy trì biểu thuế.
Công việc nó đảm nhận
"Chúng tôi luân chuyển hàng nghìn SKU mỗi tuần. Chúng tôi không thể bố trí một con người cho mỗi dòng, nhưng một ước tính thuế sai tại thời điểm báo giá khiến chúng tôi mất hợp đồng hoặc mất biên lợi nhuận."
Điều đó chuyển thành gì
| Định giá chi phí cập bến trước khi hàng luân chuyển | Một lệnh gọi trả về mã HTS và toàn bộ chồng thuế, đủ nhanh cho một báo giá thanh toán hoặc một bảng kê lô hàng. |
|---|---|
| Xử lý toàn bộ danh mục, không phải từng lần tra cứu lẻ | Điểm cuối theo lô xử lý tối đa 200 sản phẩm mỗi lệnh gọi và mở rộng đến hơn 200K lượt phân loại mỗi ngày. |
| Tin tưởng vào con số đưa vào báo giá | Toàn bộ chồng thuế với Section 301, 232 và 122, cùng thuế cấp bộ phận cho mã tách, được thiết kế để đại lý hải quan xem xét trước khi khai báo. |
Câu hỏi thường gặp về API
Tôi có cần là đại lý hải quan có giấy phép để dùng API không?
+
Không. API trả về đầu ra nghiên cứu: một mã HTS và toàn bộ chồng thuế để hệ thống của bạn dùng vào việc báo giá và chuẩn bị. Kết quả được thiết kế để đại lý hải quan có giấy phép xem xét trước khi được dùng cho một hồ sơ khai báo hải quan. Nó đẩy nhanh công việc, chứ không thay thế sự phê duyệt của đại lý hải quan.
Một lần phân loại nhanh đến mức nào?
+
Một lần phân loại sản phẩm đơn lẻ thường trả về trong chưa đầy một phút. Một lô tối đa 200 sản phẩm chạy song song và hoàn thành trong khoảng 3 đến 5 phút, đó là điều cho phép các key production tiêu chuẩn xử lý hơn 200K lượt phân loại mỗi ngày.
API có thể cho tôi chi phí cập bến đã bao gồm thuế không?
+
Nó trả về mọi tầng thuế áp lên tờ khai: mức thuế General (MFN) và Special cùng Section 301, 232, 122, và các mục Chương 99 áp dụng. Kết hợp chồng thuế đó với cước phí và các khoản phí của riêng bạn để tạo ra một con số chi phí cập bến cho báo giá hoặc thanh toán.
Làm thế nào để lấy một API key?
+
Yêu cầu một key thử nghiệm và chúng tôi chuyển nó qua một kênh ngoại tuyến như email. Key thử nghiệm có hạn ngạch nhỏ và hết hạn trong 7 đến 30 ngày, chỉ dùng để phát triển. Khi bạn đã sẵn sàng vận hành, chúng tôi cấp một key production được định cỡ theo mẫu gọi, danh sách IP cho phép và QPS đỉnh của bạn.
Giới hạn theo lô là gì?
+
Điểm cuối theo lô nhận tối đa 200 sản phẩm mỗi lệnh gọi. Mỗi mục báo cáo trạng thái riêng, nên một sản phẩm không phân loại được không làm hỏng cả lô, và cả điểm cuối đơn lẻ lẫn điểm cuối theo lô đều rút từ cùng một hạn ngạch mục dưới key của bạn.
Tài liệu kỹ thuật đầy đủ ở đâu?
+
Tài liệu tham chiếu API mô tả mọi điểm cuối, trường yêu cầu và phản hồi, mã lỗi, header và quy tắc giới hạn tốc độ, kèm các ví dụ curl có thể sao chép và dán. Đây là trang để xây dựng dựa vào một khi bạn đã có key.
Đặt một bộ phân loại đằng sau hoạt động của bạn
Yêu cầu một key thử nghiệm để bắt đầu tích hợp, hoặc đọc toàn bộ tài liệu tham chiếu API để xây dựng dựa trên hợp đồng.
Chỉ dùng để tham khảo chung. Xem tuyên bố miễn trừ tuân thủ.
Lưu ý tuân thủ
Đây là một HTS classification researcher. Kết quả chỉ dùng cho mục đích tham khảo chung, giáo dục và lập kế hoạch, được thiết kế để giúp các đội tuân thủ thương mại, nhà nhập khẩu và đại lý hải quan có giấy phép giao tiếp tốt hơn. Theo Phán quyết CBP HQ H290535, việc cung cấp phân loại HTS vượt quá 6 chữ số cho hàng nhập khẩu cụ thể cấu thành "hoạt động hải quan" theo 19 U.S.C. § 1641. Không sử dụng các kết quả này trực tiếp trong chứng từ tờ khai nhập khẩu nếu chưa được đại lý hải quan có giấy phép xem xét độc lập.
Đọc toàn văn tuyên bố miễn trừ tuân thủ →