2026 年 Shopify 關稅稅金計算器 API 整合指南

如何在 Shopify 商店加入關稅稅金計算器 API？

在 Shopify 加入關稅稅金計算器 API，有三種做法：使用 Shopify 內建的關稅與進口稅功能（各方案皆可使用，會對啟用關稅計算的訂單收取 0.5% 的交易手續費）；透過第三方 Shopify App，在結帳頁面串接供應商的 API；或是透過自訂整合，在結帳擴充功能（checkout extensibility）事件中直接呼叫關稅稅金 API。

為什麼 Shopify 的關稅稅金計算在 2026 年變得更重要？

自2026 年 2 月 28 日 Section 321 全球暫停之後，每一件寄往美國的跨境包裹，都必須經過正式的 HTS 歸類與從價關稅核定。過去可以在 800 美元以下免稅出貨的 Shopify 商家，現在需要準確的逐筆訂單關稅計算，才能避免讓客戶意外收到帳單，並降低退款爭議的風險。

重點摘要

要快速跑通一套可用的 Shopify 關稅計算器 API，最快的路徑是 Shopify 內建的 Markets 關稅計算功能，現已開放所有 Shopify 方案使用，對計算關稅的訂單收取 0.5% 交易手續費。若商家希望在歸類準確度與關稅疊加透明度上握有更多主控權，適合的路徑則是第三方 API 整合。GingerControl 提供的關稅稅金 API，回傳的是以 GRI 為依據、反覆推演的 HTS 歸類結果、完整拆解的美國關稅疊加項目，以及作為判斷依據的 CROSS 裁示研究，適合 Shopify Plus 商店，以及自行打造客製結帳流程的品牌使用。

最後更新：2026 年 5 月

Shopify 原生支援哪些功能

Shopify Markets 的關稅與進口稅功能，現已開放給所有 Shopify 方案使用，不再限於 Plus。此功能會依商品詳情頁指定的 HS 碼，在結帳頁面顯示關稅估算，並依原產國或地區計算目的地國家的關稅。若商家希望客戶看到的總價直接吸收關稅、不另外列出，也支援含稅定價。

要讓這項內建功能正常運作，有兩個必要條件：

每項商品的商品詳情頁，都需要填入國際商品統一分類代碼（HS 碼）。Shopify 會針對國際訂單驗證 HS 碼是否已填寫。
一旦在結帳頁面啟用關稅計算，商家就必須使用關稅已付交貨（DDP）出貨標籤，而不是目的地交貨（DAP）標籤，否則貨運公司會在送達時再次向客戶收取關稅，形成重複收費。

每筆計算關稅的訂單，都會收取 0.5% 交易手續費。符合資格、使用 Managed Markets 的美國商家，可享有 Shopify 提供的關稅保證，也就是已收取的關稅金額，由 Shopify 保證不會發生短收。

這項內建功能啟用速度快，但關稅計算是跑在 Shopify 內建的稅務引擎上，會把底層的關稅疊加簡化成單一數字。若商家希望對 Section 232、Section 301、第 99 章與 Section 122 各層關稅有逐項透明度，或希望取得歸類推理過程而不只是輸入 HS 碼，就需要客製整合。

商家為什麼要自建客製整合

驅動 Shopify Plus 與成長期品牌走向客製關稅稅金 API 的原因，主要有三個：

目錄規模下的歸類準確度。 一份包含一萬個 SKU 的目錄，無法只靠 CSV 匯入直接套用單次判定的 HS 碼，否則會有稽核風險。品牌需要 API 能提出候選碼、在描述模糊時提出澄清問題，並針對每個 SKU 產出歸類理由。

逐項透明的關稅可視性。 當一件來自中國的電子產品同時背負 10% 的 Section 122 加上 25% 的 Section 301，商家該怎麼決策（自行吸收關稅、轉嫁給客戶，或是改變採購來源），取決於能否清楚知道每一層關稅各自從何而來。一個彙總後的到岸成本數字，無法呈現這個資訊。

出口端歸類。 Shopify 商家從美國出口時，若單筆出貨對單一 Schedule B 號別的貨值超過 2,500 美元，就需要Schedule B 分類以供 AES 申報之用。對任何可能具軍民兩用特性的產品，出口管理條例（EAR）項下的 ECCN 分類也同樣重要。

GingerControl 的 API 同時涵蓋這三項。

客製 Shopify 整合的運作方式

典型的整合做法，是透過 Shopify 的結帳擴充功能，在關稅計算事件中呼叫 GingerControl API。流程如下：

客戶將商品加入購物車並進入結帳頁面
結帳擴充功能讀取購物車品項、目的地國家，以及每項商品已儲存的原產國資料
擴充功能將商品描述、製造國、目的地與報關日期，一併傳給 GingerControl API
GingerControl 回傳 HTS 歸類結果（或針對模糊 SKU 提出澄清問題）、逐項關稅疊加，以及總到岸成本
擴充功能依 Shopify 結帳畫面規範向客戶顯示關稅，並將明細寫入訂單元數據（metadata），供後續報關行申報使用

一個請求範例如下：

curl -X POST https://api.gingercontrol.com/v1/classify-and-calculate \
  -H "Authorization: Bearer $GINGERCONTROL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "product": {
      "description": "Bluetooth wireless earbuds with charging case, lithium battery",
      "country_of_manufacture": "CN"
    },
    "destination": "US",
    "entry_date": "2026-05-15",
    "value_usd": 49.99
  }'

回應內容包含分階段推導出的 HTS 判定結果、套用的 GRI 規則、參考過的 CROSS 裁示，以及逐層關稅拆解。整合流程會把 HTS 碼與原產國寫入 Shopify 商品元欄位（metafield），讓同一 SKU 之後的訂單可以略過歸類步驟，直接進入關稅計算。

GingerControl 的 HTS 稅則分類研究員依循 GRI 邏輯運作，在指定歸類前會先提出澄清問題，產出的可供稽核報告，理據來自類注、章注與相關的 CROSS 裁示。

Shopify 原生功能 vs GingerControl 客製整合

能力	GingerControl 客製整合	Shopify 原生關稅計算
建置成本	透過結帳擴充功能進行工程整合	後台開關即可，每筆訂單 0.5%
HS 碼要求	未提供時可自動推導	商品詳情頁須填寫
歸類準確度	反覆推演的 GRI，並參考 CROSS 裁示	依賴輸入的 HS 碼
逐項美國關稅疊加	有，基本稅率加 S.232 加 S.301 加第 99 章加 S.122	彙總到岸成本
出口端歸類	支援 Schedule B 與 ECCN	非其重點功能
每 SKU 稽核軌跡	完整 GRI 推理鏈	計算紀錄
關稅保證	透過商家政策提供	Managed Markets 可提供
定價	依請求量計費的 API 定價	每筆符合資格訂單 0.5%

重點結論： 對想要零工程投入即可啟用、並享有 Managed Markets 關稅保證的商家而言，Shopify 原生關稅計算是較好的選擇。對需要歸類推理、逐項關稅透明度與出口端涵蓋範圍的 Shopify Plus 與成長期品牌而言，選擇 GingerControl 客製整合較為合適。

啟用關稅計算後，DDP 出貨標籤如何運作

無論使用 Shopify 原生功能或客製整合，一旦在結帳時已收取關稅，商家就必須為該筆訂單使用 DDP 出貨標籤。DDP 標籤會告知貨運公司關稅已經付清，貨運公司便不會在送達時再向客戶請款。多數國際訂單預設使用的 DAP 標籤，則代表關稅是在送達時收取，若結帳時已收過一次關稅，就會造成客戶重複被收費。

Shopify Markets 與多數貨運系統整合（Shippo、ShipStation、EasyPost）都支援 DDP 標籤。商家的設定方式：在結帳時啟用關稅收取，接著將 DDP 設為國際貨運的預設服務類型。

常見問題

國際訂單最適合的 Shopify 關稅計算器 API 是哪一個？ 對多數年訂單量在 5 萬筆以下的商家而言，Shopify 原生關稅計算最快啟用，每筆訂單收取 0.5% 交易手續費。若需要逐項關稅疊加透明度、歸類推理，或出口端涵蓋範圍，GingerControl 的 API 可透過 Shopify 結帳擴充功能整合，並在同一次呼叫中回傳以 GRI 為依據的完整 HTS 歸類、Section 232、301、第 99 章與 Section 122 拆解，以及 Schedule B／ECCN 分類。

GingerControl API 如何與 Shopify Markets 整合？ 整合方式是透過 Shopify 結帳擴充功能，在關稅計算事件中呼叫 GingerControl API。擴充功能讀取購物車品項與商品元欄位，將目的地與報關日期一併傳給 API，並把回應寫回訂單元數據，供後續報關行或第三方物流申報使用。

在 Shopify 使用客製關稅 API，仍需要 DDP 標籤嗎？ 需要。無論關稅是透過 Shopify 原生功能或客製 API 收取，一旦已收取關稅，該筆訂單就必須依 DDP 條件出貨，否則貨運公司會在送達時對客戶重複收費。GingerControl 的回應內容包含可寫入訂單元數據的關稅拆解明細，供貨運公司使用。

GingerControl 如何處理 Shopify 上描述模糊的商品？ 當商品描述無法收斂到單一 HTS 歸類時，API 會回傳與候選碼分歧點對應的澄清問題。商家可透過後台介面將這些問題交由商品人員解答，再把答案存入商品元欄位，讓後續訂單直接套用已收斂的歸類結果。

GingerControl 能處理 2026 年 2 月後的 de minimis 歸類量能需求嗎？ 可以。這套 API 是為每日 1,000 到超過 10 萬次請求的目錄規模作業所打造。在2026 年 2 月 Section 321 暫停後重新歸類整個目錄的 Shopify 商家，可使用批次端點，並將產出的 HTS 碼存入商品元欄位。

Shopify 商店的美國出口業務呢？ 若出貨貨值超過 AES 申報門檻，GingerControl 會回傳供AES 申報使用的美國出口 Schedule B 分類。對任何可能具軍民兩用特性的產品，也提供 ECCN 分類。兩者都在同一次 API 呼叫中回傳。

GingerControl 依 CBP HQ H290535 的規範，在法律定位上是否比其他歸類 API 更清楚？ GingerControl 的定位是 HTS 稅則分類研究員。它依循的推理流程，與持證報關行相同，但最終歸類決定仍受益於專業判斷。這個定位方式，與CBP 裁示 HQ H290535一致。