Classification + Tariff Calculation API 企業用 HTS 稅號與關稅 API
一次 API 呼叫，把產品描述和原產地變成10碼 HTS 稅號和每一層關稅，以 JSON 回傳。
示意畫面（採用 API 手冊的批次範例）：POST /openapi/v1/tariff/batch 的請求紀錄，顯示兩件棉質 T 恤的 200 OK JSON 回應，hts_code 6109.10.0012 那一行亮起；旁邊的「您的品項」面板顯示總數2、成功2、失敗0。
先講結論。
Classification + Tariff Calculation API（稅號判定加關稅試算 API）是 GingerControl 給企業客戶的 REST API，用來判定 HTS 稅號和試算美國關稅。您的系統送出一段產品描述和原產地，可以一次一項，也可以批次送（預設120項），拿回 JSON：10碼 HTS 稅號、一般稅率和優惠稅率，以及每一筆301條款（Section 301）和232條款（Section 232）加徵關稅及其第99章稅號。第91章手錶這類拆分稅號的貨物，會拆成組件（components）回傳。結果用於報關準備，由持照報關行覆核。
三個步驟，從您的系統出去，帶著稅號回來。
POST 一項產品，或批次送出，每一筆帶您自己的 item_id。API 金鑰放在請求標頭裡。
示意畫面（採用 API 手冊的批次範例）：一筆從您的系統送出的請求，「請求」分頁的 JSON 本文有兩件棉質 T 恤，產地分別是 DE 和 FR，各有自己的 item_id。旁邊是遮住 API 金鑰的請求標頭，下方的「您的品項」面板還沒有稅號。
結果依您送出的順序回傳，一項產品失敗不會拖垮整批。遇到429時，Retry-After 會告訴您要等多久。
示意畫面（採用 API 手冊的批次範例）：出現「傳送中」狀態，「您的品項」面板照送出順序列出兩個 item_id，狀態仍是等待中。
10碼 HTS 稅號、一般稅率和優惠稅率、每一筆301條款和232條款加徵，以及成功筆數的摘要。
示意畫面（採用 API 手冊的批次範例）：「回應」分頁顯示 200 OK 和 JSON 回應，hts_code 6109.10.0012 那一行亮起；「您的品項」面板顯示總數2、成功2、失敗0，每一項的 HTS 稅號都標著 OK。
POST 一項產品，或批次送出，每一筆帶您自己的 item_id。API 金鑰放在請求標頭裡。
示意畫面（採用 API 手冊的批次範例）：一筆從您的系統送出的請求，「請求」分頁的 JSON 本文有兩件棉質 T 恤，產地分別是 DE 和 FR，各有自己的 item_id。旁邊是遮住 API 金鑰的請求標頭，下方的「您的品項」面板還沒有稅號。
結果依您送出的順序回傳，一項產品失敗不會拖垮整批。遇到429時，Retry-After 會告訴您要等多久。
示意畫面（採用 API 手冊的批次範例）：出現「傳送中」狀態，「您的品項」面板照送出順序列出兩個 item_id，狀態仍是等待中。
10碼 HTS 稅號、一般稅率和優惠稅率、每一筆301條款和232條款加徵，以及成功筆數的摘要。
示意畫面（採用 API 手冊的批次範例）：「回應」分頁顯示 200 OK 和 JSON 回應，hts_code 6109.10.0012 那一行亮起；「您的品項」面板顯示總數2、成功2、失敗0，每一項的 HTS 稅號都標著 OK。
稅號、基本稅率，以及每一層關稅及其第99章稅號，都在同一個回應裡。
澆鑄國鋼材在哪裡熔煉澆鑄、鋁材在哪裡冶煉鑄造。232條款金屬關稅兩者都看。
10碼 HTS 稅號這項產品的美國稅號，填上報單前交給報關行覆核。
基本稅率一般稅率（MFN）和優惠稅率，照 HTS 上的寫法。
301條款每一行是一個第99章稅號和稅率，也就是報關行在報單上申報的那一行。
232條款金屬棉質 T 恤這裡是空的。產品含鋼或鋁的話，對應的第99章稅號就會列在這裡。
拆分稅號的組件第91章手錶要按零組件分別課稅：回傳8碼上層稅號，連同機芯、錶殼、錶帶和電池，每一項都有自己的10碼稅號和關稅。
示意畫面（範例資料）：POST /openapi/v1/tariff 的請求和回應加上標註：一件產地 CN 的棉質 T 恤，回傳 HTS 稅號、一般稅率和優惠稅率、兩筆301條款加徵和空的232條款清單；接著一支手錶拆成四個組件稅號。
進口美國貨物的10碼 HTS 稅號、一般稅率（MFN）和優惠稅率，以及每一層關稅各一份清單（例如301條款和232條款金屬），清單裡每一筆是一個第99章稅號和稅率。清單是空的，代表那一層不適用。拆分稅號的產品則改回傳 components 陣列。
從 ERP、報價工具或報關準備流程呼叫 Classification + Tariff Calculation API。送出產品描述和原產地，就以 JSON 拿回10碼 HTS 稅號、基本稅率和每一層第99章關稅；可以一次一項，或批次呼叫，預設每次120項。稅號填上報單前，仍由持照報關行覆核。
API 涵蓋的是到岸成本裡的關稅部分。API 回傳稅率和第99章稅號，由您的系統套用到完稅價格上，再加上運費、保險和各項費用。這支 API 是為進口前的決策和報關準備設計的。如果您需要在結帳時向購物者顯示保證準確的稅費，Zonos、Avalara 這類結帳工具就是為此設計的。
有些貨物（例如第91章的手錶）是按零組件分別課稅，而不是整件一起課。這類產品 API 會回傳8碼上層稅號和 components 陣列：每個部分都有自己的10碼 HTS 稅號和關稅資料，在同一次呼叫裡由我們這邊算好。
每次批次呼叫預設120項，可以依您的處理量調整，每項描述最長10,000個字元。每一項帶著您自己的 item_id，並照送出的順序回傳各自的狀態（ok 或 failed），所以一項產品判定不出稅號，不會讓整批失敗。單筆和批次端點共用同一把金鑰下的品項配額。
看您的金鑰設定多少，就能承受多少。每把金鑰有自己的速率限制和品項配額，我們了解您的呼叫模式、IP 白名單和尖峰 QPS 後，再設定正式環境金鑰。超過時，API 會回傳 429 Too Many Requests，並附 Retry-After 標頭，告訴您的程式要等幾秒。
這支 API 給企業客戶用，所以從一通電話開始：按本頁上方的「申請 API 金鑰」按鈕。我們會了解您的呼叫模式、IP 白名單和尖峰 QPS，依此設定金鑰的速率限制和品項配額，再透過 Email 等管道另行交付金鑰。
不用。API 回傳的是研究結果：HTS 稅號和每一層關稅，供您的系統用在報價和報關準備。依美國海關與邊境保護局（CBP）總署裁定 HQ H290535，為進口而把特定貨物判定到超過6碼的稅號，屬於 19 U.S.C. § 1641 所稱的報關業務，所以稅號填上報單前要由持照報關行覆核。GingerControl 不是報關行。
不能。API 只涵蓋美國進口的稅號判定和關稅。出口管制分類要用 Export Control Classifier（ECCN 出口管制分類工具）網頁版 app，這個工具目前沒有 API。
在 API 文件頁：gingercontrol.com/products/openapi。裡面寫了兩個端點、每個請求和回應欄位、錯誤碼、標頭和速率限制規則，還有可以直接貼上的 curl 範例。
