ERP整合用HTS稅則分類API：SAP、Oracle與NetSuite

Chen Cui Co-Founder of GingerControl 發布於2026年4月7日更新於2026年10月12日閱讀約13分鐘審閱：Michael Weick, LCB / CCS

這次更新：依已確認產品事實修正本篇流程與服務範圍，移除未經證實的輸出或自動化承諾。

先講結論

用於ERP整合的HTS稅則分類API運作方式，是透過REST端點接收來自SAP、Oracle或NetSuite的產品主檔資料，依USITC進口關稅稅則執行歸類邏輯，並將產出的HTS代碼、稅率與推理文件自動寫回ERP欄位。這套API消除了在歸類工具與企業系統之間手動重複輸入的作業。

下一步：用 Classification Researcher 判定一個產品的稅號

本文內容

哪些ERP系統支援HTS稅則分類API整合？
為什麼ERP系統需要外部歸類API
整合架構如何運作：ERP到API再回到ERP
對接SAP GTS的歸類API
HTS Oracle整合：對接Oracle GTM
NetSuite HTS歸類：建置客製整合
如何處理錯誤、備援與觸發重新歸類的情境
常見問題
打造你的ERP歸類整合
參考資料

哪些ERP系統支援HTS稅則分類API整合？

任何支援對外HTTP呼叫或中介軟體連接的ERP系統，都能與HTS稅則分類API整合。SAP S/4HANA可透過SAP CPI或RFC／BAPI呼叫，將商品稅則代碼填入GTS系統。Oracle ERP Cloud則使用Oracle Integration Cloud的REST轉接器，將資料餵入GTM。NetSuite則採用SuiteScript 2.0或RESTlet。GingerControl的Classification + Tariff Calculation API透過標準的JSON over HTTPS對接上述三個平台，沒有現成的連接器。

摘要

將HTS稅則分類API對接ERP系統，能消除在獨立歸類工具與產品主檔之間手動複製稅則代碼的流程，這種作業方式在規模擴大後，很容易產生謄寫錯誤並破壞稽核軌跡的完整性。SAP GTS、Oracle GTM與NetSuite都把稅則代碼儲存為靜態欄位，但都缺乏產生這些代碼所需的GRI推理邏輯。外部歸類API正好填補這個缺口：接收產品資料、套用結構化的法律推理，並回傳可供稽核的結果。GingerControl的Classification + Tariff Calculation API以JSON回傳10位HTS代碼與各層美國關稅，每次呼叫預設120筆；單一產品可以用GingerLite app裡的Classification Researcher（HTS 稅號判定研究工具），它會先問清楚、不靠猜測，GingerOS則在整份型錄上這樣做。

為什麼ERP系統需要外部歸類API

SAP、Oracle與NetSuite合計佔全球企業ERP市場逾60%的份額。這些平台是產品資料、採購單與供應商紀錄的正式紀錄系統，而這些資料正是驅動關務歸類決定的基礎。然而，這三套系統本身都無法自行完成產品歸類。

SAP Global Trade Services（GTS）負責管理報關申報、許可證判定與合規篩查，但它仰賴外部填入的稅則代碼，填入物料主檔外貿分頁中的欄位。Oracle GTM提供合規工作流程管理，並與Oracle E-Business Suite及Cloud SCM整合進行篩查與申報，但歸類資料同樣必須來自外部系統。NetSuite則將HTS代碼儲存在製造商稅則欄位中，本身完全不具備歸類邏輯。

這形成了一道結構性的缺口。產品資料存在於ERP系統中，歸類邏輯卻存在於系統之外。若沒有API橋接，合規分析人員只能匯出產品清單、在獨立工具中進行歸類，再手動把10碼HTS代碼一筆筆輸回ERP。產業數據顯示，誤歸列佔CBP全部關務裁罰案件的42%，是最常見的單一合規失誤類別，而其中相當一部分風險，正是來自不同系統之間的手動資料重複輸入。

「歸類的最終責任在於進口商。海關要求進口商在貨品歸類上善盡合理注意義務。」出自CBP歸類合規指引

在設計GingerControl的歸類API時，核心需求其實很單純：接收ERP系統原本就儲存的產品欄位，回傳ERP能直接使用的結果格式，每筆結果都帶上你自己的item_id，讓每個代碼都能對回原始紀錄。

整合架構如何運作：ERP到API再回到ERP

無論採用哪個平台，HTS稅則分類API的ERP整合流程都遵循一致的模式。在選擇實作方式之前，必須先理解這套架構。

第一步：ERP觸發歸類請求。 當ERP中建立或更新產品紀錄時，觸發器（SAP CPI iFlow、Oracle Integration Cloud流程，或NetSuite SuiteScript事件）會擷取產品欄位，並送至歸類API。

第二步：歸類API處理請求。 API接收產品描述與原產國（把材料、功能與成分寫進描述裡），回傳10碼層級的HTS代碼。

第三步：依歸類結果執行關稅試算。 稅率會依完整關稅結構計算：基本MFN稅率、Section 301、Section 232與第99章其他稅號。API回傳的是呼叫當下生效的各層關稅；要依支援的報關日期試算，請用Tariff Calculator。

第四步：結果寫回ERP。 API回應（包含HTS代碼、各層關稅與你的item_id）會對應至ERP欄位，更新產品主檔紀錄，並將回應以稽核附件形式儲存；在GingerOS裡，每個代碼都連同推理與核准紀錄一起保存。

整合架構文字示意圖：

ERP產品主檔                  歸類API                    關稅試算
（SAP／Oracle／NetSuite）    （GingerControl）           （完整關稅結構）

產品建立／更新                接收產品資料
  描述          ──────────►  套用GRI 1至6邏輯     ──►  MFN基本稅率
  材料          ──────────►  查核類注／章注              加Section 301
  用途          ──────────►  參考CROSS裁定               加Section 232
  原產國        ──────────►  解析分歧點                  加第99章
                             回傳HTS代碼
                                    │
                                    ▼
                             API回應（JSON）
                             - hts_code（10碼）
                             - duty_rate_breakdown
                             - item_id
                             - classification_date
                                    │
                                    ▼
                             ERP產品主檔已更新
                             - HTS代碼欄位已填入
                             - 稅率欄位已填入
                             - 回應已存為附件
                             - 已建立稽核紀錄

GingerControl的Classification Researcher依循GRI邏輯，會先提出釐清問題才進行歸類判定，產出以類注、章注與相關CROSS裁定為依據的可稽核報告。這套API回傳的結構化JSON，無須專屬轉接器即可直接對應ERP欄位。

對接SAP GTS的歸類API

SAP GTS是大型進口商中部署最廣泛的貿易合規模組，負責處理報關申報、許可證管理與合規篩查，但它要求稅則代碼由外部系統填入。整合目標為物料主檔外貿分頁上的STAWN欄位（稅則代碼）。

SAP歸類API請求的欄位對應：

SAP欄位（MAKT／MARA／MARC）	對應至	API請求欄位
MAKTX（物料說明）	產品描述	description
WRKST（基本材料）	材料組成	併入description
MATKL（物料群組）	產品類別	併入description
HERKL（原產國）	原產國	country_of_origin
MEINS（基本計量單位）	計量單位背景	併入description

整合機制： SAP Cloud Platform Integration（CPI）建立由物料主檔異動觸發的iFlow流程，擷取SAP欄位、組成對歸類端點的REST API請求、處理JSON回應，並將HTS代碼寫入STAWN欄位，再把回應連同item_id與X-Request-Id存檔，作為產品紀錄與歸類結果之間的稽核連結。

對擁有數千筆物料紀錄的大型SAP環境而言，GingerControl的批次端點每次呼叫預設120筆，依你的吞吐量調整，並依你的item_id順序回傳結果，CPI可以逐批處理整份型錄，再把每一批寫回物料主檔。

HTS Oracle整合：對接Oracle GTM

Oracle Global Trade Management提供合規工作流程管理、受限方篩查與報關文件準備功能。Oracle GTM運用機器學習輔助產品歸類，但仍能受惠於能完整編碼GRI法律推理架構的專用歸類API。

整合機制： Oracle Integration Cloud（OIC）建立由料件主檔異動觸發的流程。Oracle的REST轉接器讓直接API呼叫變得直觀，可將品項屬性對應至歸類請求欄位，並將結果寫回貿易合規屬性。API採用同步呼叫，可以一次一筆，也可以一批預設最多120筆；API手冊沒有記載webhook。

整合方式	最適合對象	導入時程（我們對你的團隊自行建置所需時間的估計）
GingerControl REST API加Oracle OIC	已投資OIC的團隊	2至3週
GingerControl REST API加自訂PL/SQL	具備Oracle開發能力的團隊	3至5週
GingerControl REST API加中介軟體（MuleSoft／Boomi）	使用第三方iPaaS的團隊	2至4週

重點： Oracle GTM在合規工作流程管理上表現良好，但仍仰賴外部提供歸類資料。GingerControl的API能以GRI邏輯驅動的歸類方式補上這個缺口，並提供Oracle GTM本身未內建的完整關稅結構試算。

NetSuite HTS歸類：建置客製整合

NetSuite沒有內建貿易合規模組，這反而讓它成為歸類API整合中最單純、也最具彈性的平台。你可以在品項紀錄上建立自訂欄位，用來儲存HTS代碼、稅率、歸類日期與推理參照，再透過SuiteScript 2.0觸發歸類作業。

需建立的NetSuite自訂欄位：

自訂欄位ID	標籤	類型	用途
custitem_hts_code	HTS代碼	自由文字	10碼HTS歸類結果
custitem_duty_rate	稅率	百分比	適用稅率總額
custitem_classification_date	歸類日期	日期	最近一次歸類的時間戳記
custitem_reasoning_ref	歸類報告	URL	連結至已儲存的推理文件

SuiteScript 2.0整合模式： 在品項紀錄建立或更新的afterSubmit事件上，觸發使用者事件腳本，擷取品項描述、材料與原產國，向歸類API送出REST請求，並使用record.submitFields()將結果寫回自訂欄位。

在NetSuite關務管理情境下，歸類API能提供NetSuite內建稅則欄位本身無法產生的上游資料。GingerControl的關稅試算器涵蓋完整美國關稅結構，包括基本稅率、Section 232、Section 301與第99章其他稅號（該期間的報單另含Section 122），API則會連同HTS代碼一併回傳各層關稅。

如何處理錯誤、備援與觸發重新歸類的情境

正式營運的整合流程，必須考量無法自動完成歸類的各種情境。最常出現的失敗模式有三種。

需要人工處理的結果。 API回傳的是代碼與各層關稅，手冊沒有記載信心分數，所以要先定好哪些品項一律複核（新的產品系列、組合商品、高稅率稅號），把它們導入合規複核佇列。GingerOS會替你處理這一步：記錄每個代碼的推理，只把人工核准的結果寫回。

需要進一步釐清的疑義。 API依收到的描述進行歸類，所以一開始就把材料、功能與成分寫進描述。事實仍有缺漏時，GingerOS會在建議代碼之前先問清楚，GingerLite app裡的Classification Researcher對單一產品也是這樣做。

觸發重新歸類的情境。 HTS代碼並非一成不變，USITC會定期修訂進口關稅稅則，而關稅計畫的異動（Section 301調整、第99章新增項目）也可能在不變動HTS代碼本身的情況下，改變適用稅率。建議建立排程式重新歸類作業，定期（例如每季）將既有產品紀錄重新送交歸類API，或於關稅政策異動觸發警示時執行。GingerControl免費的Policy Briefings會在美國貿易規則異動時寄電子郵件給你，GingerOS則會把每個SKU對照新規則檢查一遍。

稽核軌跡的連續性。 每一次歸類事件，無論是初次歸類、重新歸類或人工覆核，都必須記錄時間戳記、輸入資料、API回應與覆核者身分。這份文件直接支持19 USC 1484所規定的合理注意義務標準。在CBP重點評估過程中，稽核人員評估的重點在於你的歸類流程是否系統化且有據可查，而不只是個別代碼是否正確。

截至2026年3月，CBP現代化後的ACE系統已能針對含多個HTSUS代碼的報單，計算並估算進口稅額，這也讓源自API的準確歸類資料，對下游申報作業的準確度更加關鍵。

常見問題

用於ERP整合的HTS稅則分類API，與獨立歸類工具有何不同？

獨立歸類工具需要手動輸入資料，也需要手動把結果轉回ERP。用於ERP整合的HTS稅則分類API則消除了這兩道步驟，以程式化方式接收產品資料，並回傳能直接寫入ERP欄位的結構化結果。GingerControl的REST API回傳的JSON包含HTS代碼與各層關稅，依item_id對回你的紀錄，可直接對應至SAP、Oracle或NetSuite欄位，無須人工介入。

不寫客製ABAP程式，也能整合SAP GTS的歸類API嗎？

可以。SAP Cloud Platform Integration（CPI）提供預建的REST連接器，能呼叫外部API並將回應對應至SAP欄位，無須撰寫ABAP程式碼。GingerControl的SAP歸類API整合採用標準JSON over HTTPS，CPI原生即可處理。若團隊未使用CPI，MuleSoft與Boomi等中介軟體平台同樣提供經SAP認證、可對接GingerControl端點的連接器。

API需要ERP提供哪些資料才能完成歸類？

最基本需要產品描述與原產國。輸入的資料越豐富，準確度越高：材料組成、用途、功能規格與產品類別，都有助於解決歸類疑義。請把這些都寫進描述：API依收到的內容歸類；在GingerOS裡，缺漏的事實會在建議代碼之前先問清楚。

HTS Oracle整合如何在歸類的同時處理稅率試算？

Oracle GTM負責管理合規工作流程，但不會計算完整的美國關稅結構。GingerControl的API能在單次回應中同時回傳HTS代碼與完整稅率細目，包括呼叫當下生效的General與Special稅率、Section 301、Section 232與第99章其他稅號，讓Oracle ERP團隊能透過單次API呼叫，同時填入歸類與稅率欄位，不必另外維護稅率對照表。

沒有內建貿易合規模組，NetSuite HTS歸類還可行嗎？

可行。NetSuite透過自訂欄位與SuiteScript 2.0提供的彈性，非常適合用於歸類API整合。GingerControl的API可透過SuiteScript使用者事件腳本或RESTlet對接NetSuite，將HTS代碼、稅率與歸類日期填入品項紀錄的自訂欄位。正因為沒有內建模組，整合過程反而更單純，不需要處理與既有合規工作流程之間的衝突。

API如何維持符合CBP合理注意義務要求的稽核軌跡？

在GingerOS裡，每個代碼都連同推理一起保存：套用了哪些GRI規則、參考了哪些類注與章注、引用了哪些CROSS裁定，以及從4碼到10碼HTS層級的階段性判定過程；API本身只回傳代碼與各層關稅。當這些內容以附件或連結式稽核資料表的形式，隨ERP產品紀錄一併保存時，能直接支持19 USC 1484所規定的合理注意義務標準，正是CBP稽核人員在重點評估中會檢視的證據。

一般ERP關務歸類API整合大約需要多久時間？

依我們的估計，以中介軟體為基礎的整合（MuleSoft、Boomi，或ERP原生iPaaS），從探索階段到正式上線需要2至4週；採用客製連接器的直接API整合，則依ERP複雜度不同，需要4至8週。GingerControl沒有公布API的整合時程。GingerControl提供API手冊與範例請求內容。如果不想自己建置和維護整合，GingerOS依專案建置，從第一次通話到上線通常8到16週，包括既有產品型錄的批次歸類。

打造你的ERP歸類整合

在歸類工具與ERP系統之間手動重複輸入HTS代碼，是一項合規隱憂，不僅會產生謄寫錯誤、破壞稽核軌跡，還會消耗本該投入策略性工作的分析人員時間。以API為基礎的整合，能在產品異動時自動觸發歸類，並將可供稽核的結果直接寫入ERP紀錄，徹底消除這道缺口。

GingerControl的Classification + Tariff Calculation API可對接SAP、Oracle、NetSuite，以及任何能發出HTTPS請求的系統，每次呼叫預設120筆；它給企業系統使用，先通話再開通。如果不想自己做連接器，GingerOS依專案建置，唯讀接入，只在你核准的地方寫回ERP。

GingerControl打造GingerOS，一套照你的流程、用現有的資料運作的AI貿易合規平台，有沒有 ERP 都可以。專案從報價前的Prototype Week開始。聯繫我們的整合團隊