DOCS

項目分類

項目分類

了解如何在儀表板中要求分類,以及透過 API 要求分類。

下方您將找到示範,說明如何透過儀表板或 API 要求通用和國家特定分類。對於尋求更全面技術細節和廣泛文檔的用戶,請造訪我們的 Zonos GraphQL API 參考開發者網站。此全面資源提供了關於 API 端點、GraphQL 突變和廣泛技術資訊的詳細見解。

輸入欄位 

雖然只需要描述即可生成分類,但您提供的產品詳細資訊越多,您的分類就越準確。或者,您可以簡單地提供產品 URL,Classify 將自動提取所有相關項目詳細資訊供您使用。下方是 Classify 接受的每個輸入欄位的全面說明。通過了解這些輸入欄位,您可以最大化其用途並生成高度準確的分類。

欄位說明
名稱(必要)產品的名稱
產品 URL(選擇性)貼上產品 URL,Classify 將自動擷取頁面並提取相關項目詳細資訊(名稱、描述、類別等)以進行分類。在儀表板中可通過點擊 + 圖示或直接在主文字欄位中新增。對於 API 整合,請聯繫您的 Zonos 代表。雖然對於演示和測試很理想,但生產實施透過直接從後端系統傳遞項目資料可達到最佳效能和成本效率。
描述(選擇性)產品的詳細、長篇幅說明
影像 URL(選擇性)產品影像的連結。注意:確保您使用實際影像 URL 的連結,而不是產品頁面 URL
類別(選擇性)一般子產品類別,例如 服裝及配飾、寵物用品、辦公產品嬰兒服裝、寵物床、黏合劑及膠帶
材料(選擇性)產品的製成材料,例如 塑膠、木材、鋼鐵
原產地(選擇性)製造或生產產品之國家的 雙字母縮寫 (ISO 代碼)
提供的 HS 代碼(選擇性)在分類要求中包含現有 HS 代碼以指導您的要求。根據您的偏好和所提供 HS 代碼的來源,Classify 可驗證 HS 代碼並根據項目的描述詳細資訊檢查其一致性。深入了解
目的地國家(選擇性)識別將分類產品的國家。目的地國家必須使用各國的 雙字母縮寫 (ISO 代碼) 顯示,而不是實際國家名稱,例如 AU(而不是 Australia)。包含此欄位將使 Classify 返回 8+ 位數國家特定 HS 代碼,而不是通用 6 位數代碼。深入了解 通用和國家特定 HS 代碼之間的差異
產品 ID(選擇性)您的產品 ID 或任何可用於唯一識別每個產品的數字。如未提供產品 ID,Classify 將從 1 開始指派產品 ID

注意: 如果您在儀表板中上傳大量要求 CSV,目的地國家將不會成為範本的一部分;相反,您將在上傳大量要求 CSV 後選擇您的目的地國家。

要求分類 

若要在儀表板中或透過 API 要求分類,請遵循下方步驟和突變。

下方的示範顯示通用 (6 位數) 要求。若要要求分類至特定國家,請在 Classify 要求中新增國家的 ISO 代碼,如下方示範所示。若要要求通用 HS 代碼,請在 Classify 要求中將送達國家留空 null

輸入接收清單,因此您可以一次要求多項或單項分類。

注意: 若要透過 API 生成 稽核軌跡,請在您的查詢中包含 auditTrail 欄位。聯繫您的 Zonos 代表以了解存取權限和實施詳細資訊。

1mutation ClassifyItems($input: [ClassificationCalculateInput!]!) {
2 classificationsCalculate(input: $input) {
3 id
4 name
5 categories
6 imageUrl
7 hsCode {
8 code
9 description {
10 full
11 }
12 }
13 }
14}

可能的 API 回應

當 Classify 接收分類要求時,它會嘗試根據最高信心分數將要求中包含的輸入項目資料與 Classify 資料庫中的相符項目進行比對。根據找到的內容,Classify 將返回以下其中一項回應:

  1. hsCode 以 6 至 8+ 位數 HS 代碼返回時,取決於要求中是否包含了送達國家,您的分類要求已成功。
  2. 當返回 {"errors": [ { "message": "No adequate response"}]} 時,表示 Classify 因輸入資訊不足而無法找到分類。
GraphQL API ReferenceTypes, inputs, and operations used in this guide
Book a demo

Was this page helpful?


在此頁面: