輸入税試算API開発ドキュメント

何ができるか

• 税金の計算 — 製品 (CCC 税コードまたは製品説明) + 外貨金額を持ち込み、完全な税金詳細 (関税/営業税/プロモーション料金/物品税/タバコ税およびアルコール税) と税込みの導入総費用を返します。
• 税率を確認する — CCC 関税番号に従って関税率と物品税フラグを確認します。
• 自動関税 — CCC がない場合、product_description のみが提供され、システムは税関の AI モデルを使用して関税を自動的に推奨し、税を計算します。

Base URL

認証ヘッダー (1 つ選択)

Authorization: Bearer lk_live_xxxxxxxxxxxxxxxxxxxxxxxx
// または
X-API-Key: lk_live_xxxxxxxxxxxxxxxxxxxxxxxx

サーバー側から呼び出して、キーをフロントエンドに公開しないでください。レート制限はキー単位であり、応答ヘッダー X-RateLimit-Remaining が残りの制限を報告し、制限を超えると HTTP 429 が返されます。

GETPOST /api/v1/tax/estimate

POST + JSON を使用することをお勧めします。

リクエストパラメータ

リクエスト例（POST JSON）

curl -X POST https://0523.tw/api/v1/tax/estimate \
  -H "Authorization: Bearer lk_live_xxxxxxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"product_description":"コットン製のレディーストップス","currency_code":"CNY","price_foreign":300,"quantity":1}'

回答数 200（抜粋）

{
  "success": true,
  "data": {
    "input": { "hs_code": "61061000", "currency_code": "CNY", "price_foreign": 300 },
    "exchange": { "rate_to_twd": 4.612, "price_twd": 1383.6 },
    "tariff_info": { "duty_rate": 10.5, "duty_rate_text": "10.5%", "ecfa_applied": false },
    "tax_base": 1383.6,
    "tax_breakdown": {
      "is_tax_exempt": true,            // 課税標準 ≤ NT$2,000 → 少額免税
      "duty": 0, "promo_fee": 0, "vat": 0, "total_tax": 0,
      "if_over_limit": {           // 半年間に6回免税を使い果たした場合の支払額
        "duty": 145.28, "vat": 76.44, "total_tax": 221.72
      }
    },
    "antidumping": [],
    "total_landed_cost": 1453.6,
    "disclaimer": "..."
  }
}

GET /api/v1/tax/rate/{hsCode}

CCC関税番号（純正番号）に従って関税率と物品税フラグを確認してください。

curl https://0523.tw/api/v1/tax/rate/6109100000 \
  -H "Authorization: Bearer lk_live_xxxxxxxxxxxxxxxxxxxxxxxx"

{
  "success": true,
  "data": {
    "hs_code": "6109100000",
    "duty_rate": 10.5,
    "duty_rate_text": "10.5%",
    "is_commodity_tax": false,
    "name_zh": "コットンのTシャツ、アンダーシャツ…",
    "source": "tariffs_db"
  }
}

テクニカルサポート： howyunqisoftware@gmail.com

API バージョン: v1 (安定版)。

変更履歴: 2026-06-01 — 輸入税試算 API v1 がオンラインになりました。