DOCS

海關商品描述驗證

檢查商品描述是否足夠完整,以便在分類前能自信地對其進行分類。

為什麼完整的海關商品描述很重要 

每批跨境貨物都需要一個HS編碼,而這個編碼的準確度取決於其所依據的描述。HS分類決定了海關清關以及關稅和稅費的計算,所以你的商業發票上的描述必須清楚地說明商品是什麼,以及它由什麼材料製成。

當描述模糊或有歧義時,分類必須填補空白並做出假設——一個假設的細節可能導致HS編碼錯誤。錯誤的編碼意味著關稅和稅費也錯誤,這會增加清關延遲、罰款和其他合規問題的風險。

海關商品描述驗證讓你能在資料輸入時及早發現薄弱的描述,而不是在商品已根據猜測進行分類後才發現問題。當某些內容缺失時,它會明確告訴你應向客戶詢問哪些細節——這樣你可以在描述進入分類流程前修正它。當你準備好生成描述本身時,請參考海關商品描述;要分配HS編碼,請參考分類。

工作原理 

你提交商品現有的描述性欄位——name、description、material和categories。驗證會判斷這些資訊是否足夠具體,能夠落在單一HS編碼上,無需假設任何未明確說明的事實,例如纖維成分、布料是針織還是梭織,或商品的預期用途。

它返回一個status,告訴你描述的準備程度,當某些內容缺失時,會返回一個clarifications列表,明確告訴你應詢問什麼。

驗證不會分類商品,也不會返回HS編碼。status是參考性的:你根據自己的政策決定如何處理——繼續分類、發出警告、向客戶詢問更多細節,或拒絕該商品。

三個可選輸入可擴展檢查:

  • existingItemId ——驗證你已存儲的商品,而不是內聯傳遞其欄位。你同時提供的任何欄位都會覆蓋存儲值。
  • shipToCountry ——提供此參數時,驗證也會檢查描述是否足夠具體,能夠選擇目的地國家特定的稅號,而不僅僅是六位數的HS小類。
  • sessionId ——連結同一商品的後續驗證,讓客戶不會被重複詢問同一個問題。請參閱會話。

準備就緒狀態 

status欄位返回四個值之一。

狀態↕含義↕推薦操作↕
READY資訊足夠充分,無需任何假設即可自信地確定HS編碼。clarifications為空。繼續進行分類。
INCOMPLETE商品可識別,但在可能的HS小類之間選擇需要假設某個未明確說明的細節。向客戶詢問clarifications中的細節,然後重新驗證或分類。
READY_TO_SUBHEADING六位數小類已可自信確定,但仍缺少細節來選擇正確的國家特定稅號。只在提供shipToCountry時才可能出現。可選擇收集額外細節以精確計算關稅,或在小類級別繼續處理。
UNRECOGNIZABLE文本未能確立商品的基本性質——例如空值、單純的SKU或內部代碼,或亂碼。要求客戶重新輸入商品。

澄清說明 

每當狀態不是READY時,clarifications列表會包含簡短、具體的短語,描述應添加到描述中的內容——例如,"state the primary fiber content"。這些短語是寫給客戶直接查看的,所以一個好的做法是在資料輸入時顯示它們,並在繼續之前提示輸入缺失的細節。

當狀態為READY時,clarifications為空。

會話 

每次驗證都會返回一個sessionId。當客戶根據澄清說明更新商品後,請再次驗證,並將該sessionId連同完整、更新後的商品資訊一併傳回——而不只是新增的細節。

在同一會話內,驗證會記住已經詢問過的問題。即使客戶跳過了某個問題或只回答了部分內容,該問題也不會重複出現,因此客戶不會陷入反覆回答同一提示的循環。如果所有剩餘問題都已詢問過,狀態會返回READY,讓商品可以繼續處理。

1{
2 "input": {
3 "name": "Women's blouse",
4 "description": "long-sleeve blouse, woven",
5 "sessionId": "customs_description_validation_0ryft0yp0f5fg"
6 }
7}

在這個襯衫示例的後續驗證中,客戶補充了襯衫是梭織的,但沒有說明其材料。材料問題在此會話中已經詢問過,所以不會再次詢問,商品以READY狀態繼續處理。

請留意以下規則:

  • 首次驗證某件商品時省略sessionId,以開始新會話。
  • 會話屬於發起調用的組織,並只使用一個目的地國家。更改shipToCountry會開始新會話,因此請始終使用最新回應中的sessionId。
  • 為每件不同的商品開始新會話。

驗證海關商品描述 

使用customsDescriptionValidate mutation。直接提供商品的欄位,或使用existingItemId引用一個已存儲的商品。至少包含一個描述性欄位。

1mutation CustomsDescriptionValidate(
2$input: CustomsDescriptionValidationInput!
3) {
4 customsDescriptionValidate(input: $input) {
5 status
6 clarifications
7 sessionId
8 content {
9 name
10 description
11 material
12 categories
13 }
14 }
15}

在上面的示例中,商品顯然可識別為女性襯衫,但服裝的分類部分取決於材料和製造方式——所以選擇正確的HS編碼需要做出假設。狀態為INCOMPLETE,clarifications明確告訴你應向客戶詢問什麼。一旦添加了這些細節,同一商品會驗證為READY。

GraphQL API ReferenceTypes, inputs, and operations used in this guide
預約演示

這個頁面有幫助嗎?


獲取支持·法律文件·© 2026 Zonos