每次批次呼叫
200
每次呼叫商品數
一次批次請求並行分類並計價最多 200 件商品,3 到 5 分鐘內完成。
產品
為大批量進口商打造的分類與到岸成本 API
貨運承攬業者、跨境電商平台、郵政與包裹營運商,以及大批量進口商,每天都有成千上萬件商品要過關。GingerControl API 把一段普通的產品描述加原產國,轉換成 HTS 編碼與完整的關稅疊加,讓您的系統無需逐行人工分類,就能報出到岸成本、準備報關。
為整本目錄而建,而非一次一件
正式層級
200K+
每日分類量
標準正式容量。企業客製層級可擴展至每小時 10 萬件分類。
開發者
完整的請求、回應與錯誤約定都在 API 參考文件中。
API 參考文件或來信 chen@gingercontrol.com 申請測試 Key。
處理量數據來自標準正式層級 API Key 在真實流量下的測量。實際容量會依各客戶的呼叫模式與尖峰 QPS 配置。分類輸出為研究材料,須經持照報關行複核後才可用於報關。
從一條產品線到到岸成本,一次呼叫搞定
POST/v1/tariff
descriptionCotton T-shirt
countryVN
送出產品與原產國
POST 一段產品描述與原產國,單件或最多 200 件的批次皆可。不必查稅則,不必排隊等報關行。
6109.10.0012
MFN
301
232
Ginger 分類並計算
引擎先判定 HTS 編碼,再組裝完整的關稅疊加:MFN 基礎稅率,加上 Section 301、232、122 以及所有適用的 Chapter 99 條目。
200 OK
hts_code
general_rate
Section 301
Section 232
取回可直接算到岸成本的資料
一份 JSON 回應返回 HTS 編碼與每一層關稅,可直接接入您的到岸成本報價、報關準備或定價引擎。
一個請求進,完整關稅全貌出
送出描述與原產國,一次呼叫即取回 HTS 編碼與完整關稅明細。以下是行銷示意,API 參考文件記錄了每個欄位、錯誤碼與批次行為。
請求
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"
}回應
{
"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%" }
]
}
}批次請求、拆分編碼元件、錯誤語意與速率限制,請見完整 API 參考文件。
API 為您的系統提供什麼
分類
在整本目錄規模下依然站得住腳的 HTS 分類,連多數 API 默默跳過的組合商品也涵蓋在內。
6109.10
6109.10
6109.10
6109.10
6109.10
目錄規模的 HTS 分類
送進真實世界裡雜亂的產品描述,取回 10 位 HTS 編碼。在我們針對 1,000+ 件商品的內部基準中,引擎達到 99.86% 準確率,而每個結果都是供持照報關行複核後才用於報關的研究輸出。
計算
不只是基礎稅率,而是真正會落在報關單上的整套疊加。
MFN
301
232
122
Ch 99
Total
完整的到岸關稅疊加
每個回應都帶有 General(MFN)與 Special 稅率,加上 Section 301、Section 232、Section 122 以及所有適用的 Chapter 99 條目,讓您的到岸成本數字反映海關實際會課徵的金額。
整合
可預期的約定與清晰的失敗模式,這些是營運團隊能據以規劃的東西。
POST/tariff1 item
POST/tariff/batch200
單件與批次端點
為即時結帳報價分類單件商品,或在一次批次呼叫中推送最多 200 件做夜間目錄跑批。兩個端點共用同一套回應結構與同一份額度。
誰在用它來搭建
這套 API 是為每天把大量零售商品、雜貨與包裹送進海關的營運而建,在這種場景下,逐行人工分類根本無法規模化。
貨運承攬業者
在卡車出發前就把客戶整份貨運清單分類並計價,而不是每一行都等報關行回覆。
跨境電商
在結帳時呈現準確的含稅到岸成本,讓買家不會在收貨時被海關費用嚇一跳。
郵政與包裹營運商
對大批量入境包裹流跑出 HTS 編碼與稅額,用以餵入海關申報與預繳。
平台與零售市集
為成千上萬的第三方賣家提供正確的 HTS 編碼與稅額估算,無需自建分類團隊。
3PL 與履約
把分類與到岸成本內建進入駐流程,讓每一份新客戶目錄在第一天就可報關。
ERP、TMS 與定價引擎
把即時稅額資料嵌入您自己客戶已在使用的平台,無需維護任何稅則。
它解決的工作
"我們一週流轉數千個 SKU。我們沒辦法在每一行上都放一個人,但報價時一個錯誤的稅額估算,會讓我們丟掉訂單或賠掉利潤。"
這具體對應到什麼
| 在貨物移動前就算出到岸成本 | 一次呼叫返回 HTS 編碼與完整關稅疊加,快到足以用於結帳報價或貨運清單。 |
|---|---|
| 處理整本目錄,而非單次查詢 | 批次端點每次呼叫處理最多 200 件商品,並可擴展至每日 200K+ 件分類。 |
| 信得過進入報價的那個數字 | 含 Section 301、232、122 的完整關稅疊加,加上拆分編碼的元件稅額,專為報關前的報關行複核而設計。 |
API 常見問題
使用 API 需要持照報關行執照嗎?
+
不需要。API 返回的是研究輸出:供您系統用於報價與準備的 HTS 編碼與完整關稅疊加。該結果設計為在用於報關前先經持照報關行複核。它加快工作,但不取代報關行的簽核。
一次分類有多快?
+
單件商品分類通常遠低於一分鐘即可返回。最多 200 件的批次會並行處理,約 3 到 5 分鐘完成,這正是標準正式 Key 每日能處理 200K+ 件分類的原因。
API 能給我含稅的到岸成本嗎?
+
它返回會落在報關單上的每一層稅額:General(MFN)與 Special 稅率,加上 Section 301、232、122 與適用的 Chapter 99 條目。把這套關稅疊加與您自己的運費與雜費相加,即可算出用於報價或結帳的到岸成本數字。
我要怎麼取得 API Key?
+
申請測試 Key,我們會透過電子郵件等線下管道交付。測試 Key 額度較小,7 到 30 天內到期,僅供開發使用。準備上線時,我們會依您的呼叫模式、IP 允許清單與尖峰 QPS 配置一把正式 Key。
批次上限是多少?
+
批次端點每次呼叫最多接受 200 件商品。每件都會回報自己的狀態,因此一件無法分類的商品不會讓整批失敗;單件與批次端點共用同一份逐件額度,均歸屬您的 Key。
完整的技術文件在哪裡?
+
API 參考文件記錄了每個端點、請求與回應欄位、錯誤碼、標頭與速率限制規則,並附可直接複製的 curl 範例。拿到 Key 之後,就照著這頁來開發。
合規提醒
本工具為 HTS 分類研究工具。研究結果僅供一般參考、教育及規劃用途,旨在促進貿易合規團隊、進口商和持牌報關行之間的溝通。根據 CBP Ruling HQ H290535,針對特定進口貨物提供超過 6 位數的 HTS 分類,構成 19 U.S.C. § 1641 所定義的「海關業務」。未經持牌報關行獨立審查,不得將結果直接用於海關申報文件。
閱讀完整合規免責聲明 →