バッチ呼び出しあたり
200
呼び出しあたりの製品数
1回のバッチリクエストが最大200製品を並列で分類・価格計算し、3～5分で完了します。
製品
大量輸入者のための分類・着地コストAPI
フォワーダー、越境ECプラットフォーム、郵便・小包事業者、そして大量輸入者は、毎日数千の製品を税関に通します。GingerControl APIは、平易な製品説明と原産地をHTSコードと完全な関税スタックに変換するため、あなたのシステムは1行ごとに人が分類することなく着地コストを見積もり、輸入申告を準備できます。
単発ではなく、カタログ全体のために構築
本番稼働ティア
20万件以上
1日あたりの分類件数
標準の本番稼働処理能力。カスタムのエンタープライズティアは1時間あたり10万件の分類まで拡張します。
開発者向け
完全なリクエスト、レスポンス、エラーの契約はAPIリファレンスにあります。
APIリファレンスまたはテストキーについては chen@gingercontrol.com までメールをお送りください。
スループットの数値は、標準の本番稼働ティアAPIキーをライブトラフィック全体で測定したものです。実際の処理能力は、各顧客の呼び出しパターンとピークQPSに合わせて設定されます。分類出力は、申告前にライセンスを持つ通関業者が確認するためのリサーチ資料です。
製品ラインから着地コストまで、1回の呼び出しで
POST/v1/tariff
descriptionCotton T-shirt
countryVN
製品と原産地を送信
製品説明と原産地を、1品目または最大200のバッチでPOSTします。関税表の参照も、通関業者の待ち行列も不要です。
6109.10.0012
MFN
301
232
Gingerが分類・計算
エンジンがHTSコードを決定し、完全な関税スタック（MFN基本税率に加えてSection 301、232、122、そして該当するすべての第99類エントリー）を組み立てます。
200 OK
hts_code
general_rate
Section 301
Section 232
着地コスト対応のデータを取得
1つのJSONレスポンスがHTSコードとすべての関税層を返し、あなたの着地コスト見積もり、輸入申告準備、価格計算エンジンにそのまま組み込めます。
1回のリクエストで、完全な関税の全体像を
説明と原産地を送信します。1回の呼び出しで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
完全な着地関税スタック
すべてのレスポンスは、一般（MFN）税率および特別税率に加えて、Section 301、Section 232、Section 122、そして該当するすべての第99類エントリーを含むため、あなたの着地コストの数字は税関が実際に賦課する内容を反映します。
統合
予測可能な契約と明確な失敗モード。運用チームが計画に組み込めるものです。
POST/tariff1 item
POST/tariff/batch200
単一エンドポイントとバッチエンドポイント
ライブなチェックアウトの見積もりのために1製品を分類することも、夜間のカタログ処理のために最大200品目を1回のバッチ呼び出しで送ることもできます。両エンドポイントは1つのレスポンス形状と1つのクォータを共有します。
誰がこれを基盤に構築するか
このAPIは、大量の小売品、食料品、小包を毎日税関に通す事業のために構築されており、1行ずつ手作業で分類することが単純に立ち行かない場面のためのものです。
フォワーダー
トラックが出発する前に、顧客の貨物マニフェスト全体を分類・価格計算する。1行ごとに通関業者を待つ必要はありません。
越境EC
チェックアウト時に関税込みの正確な着地コストを表示し、配達時の税関手数料で買い物客を驚かせないようにする。
郵便・小包事業者
大量の輸入小包ストリームにわたってHTSコードと関税を算出し、税関申告と前払いに供給する。
マーケットプレイス・小売プラットフォーム
分類チームを配置することなく、数千のサードパーティ販売者に正しいHTSコードと関税見積もりを提供する。
3PL・フルフィルメント
オンボーディングに分類と着地コストを組み込み、すべての新規顧客カタログを初日から輸入申告対応にする。
ERP・TMS・価格計算エンジン
自社の顧客がすでに使っているプラットフォームにライブの関税データを組み込む。維持すべき関税表はありません。
このAPIが担う仕事
"私たちは週に数千のSKUを動かしています。すべての行に人を割くことはできませんが、見積もり時の誤った関税見積もりは、取引かマージンのどちらかを失わせます。"
それが意味すること
| 貨物が動く前に着地コストを価格計算する | 1回の呼び出しでHTSコードと完全な関税スタックが返され、チェックアウトの見積もりや貨物マニフェストに十分な速さです。 |
|---|---|
| 単発の照会ではなく、カタログ全体を扱う | バッチエンドポイントは1回の呼び出しで最大200製品を処理し、1日あたり20万件以上の分類まで拡張します。 |
| 見積もりに入る数字を信頼する | Section 301、232、122を含む完全な関税スタックに加えて分割コードの構成要素関税を備え、申告前の通関業者による確認を前提に設計されています。 |
API FAQ
APIを使うにはライセンスを持つ通関業者である必要がありますか？
+
いいえ。APIはリサーチ出力を返します。すなわち、見積もりや準備にあなたのシステムが使うためのHTSコードと完全な関税スタックです。その結果は、通関申告に使用される前にライセンスを持つ通関業者が確認することを前提に設計されています。作業を加速するものであり、通関業者の承認を置き換えるものではありません。
分類はどれくらい速いですか？
+
単一製品の分類は通常1分を大きく下回って返されます。最大200製品のバッチは並列で実行され、およそ3～5分で完了します。これにより、標準の本番稼働キーが1日あたり20万件以上の分類を処理できるのです。
APIは関税込みの着地コストを教えてくれますか？
+
輸入申告に載るすべての関税層、すなわち一般（MFN）税率および特別税率に加えて、Section 301、232、122、そして該当する第99類エントリーを返します。その関税スタックにあなた自身の運賃と手数料を組み合わせれば、見積もりやチェックアウト向けの着地コストの数字を算出できます。
APIキーはどうやって取得しますか？
+
テストキーをリクエストいただければ、メールなどのオフラインチャネルを通じてお届けします。テストキーは少量のクォータを持ち、7～30日で失効し、開発専用です。本番稼働の準備が整ったら、あなたの呼び出しパターン、IP許可リスト、ピークQPSに合わせてサイズを設定した本番キーを発行します。
バッチの上限はどれくらいですか？
+
バッチエンドポイントは1回の呼び出しにつき最大200製品を受け付けます。各品目が独自のステータスを報告するため、1つの分類できない製品がバッチ全体を失敗させることはなく、単一エンドポイントとバッチエンドポイントの両方が、あなたのキーのもとで同じ品目クォータから引き出します。
完全な技術ドキュメントはどこにありますか？
+
APIリファレンスは、すべてのエンドポイント、リクエストおよびレスポンスのフィールド、エラーコード、ヘッダー、レート制限ルールを、コピー＆ペースト可能なcurl例とともに文書化しています。キーを取得したら、それを対象に開発するページです。
あなたの業務の背後に分類エンジンを
統合を始めるにはテストキーをリクエストするか、契約を対象に開発するにはAPIリファレンスの全文をお読みください。
一般的な参照のみを目的としています。 コンプライアンス免責事項を見る.
コンプライアンスに関する注意
本製品はHTS classification researcherです。結果は一般的な参照、教育、および計画目的のみを対象としており、貿易コンプライアンスチーム、輸入者、ライセンスを持つ通関業者の間のより良いコミュニケーションを可能にするために設計されています。CBP裁定HQ H290535によれば、特定の輸入品について6桁を超えるHTS分類を提供することは、19 U.S.C. § 1641に基づく「通関業務（customs business）」に該当します。これらの結果は、ライセンスを持つ通関業者による独立した確認なしに、輸入申告書類へ直接使用しないでください。
コンプライアンス免責事項の全文を読む →