輸入欄位
雖然只需要描述即可生成分類，但您提供的產品詳情越多，您的分類就會越準確。或者，您可以只提供產品 URL，Classify 會自動為您提取所有相關項目詳情。以下是 Classify 接受的每個輸入欄位的綜合說明。透過瞭解這些輸入欄位，您可以最大化其使用方式，並生成高度準確的分類。
輸入欄位說明
| 欄位↕ | 說明↕ |
|---|---|
| 名稱（必需） | 產品的名稱 |
| 產品 URL（選用） | 貼上產品 URL，Classify 會自動抓取頁面並提取相關項目詳情（名稱、描述、類別等）以進行分類。在 Dashboard 中，點擊 + 圖標或直接在主文字欄位中新增時可用。如需 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 |
附註： 如果您在 Dashboard 中上傳批量要求 CSV，目的地國家將不會包含在範本中；相反，您將在上傳批量要求 CSV 後選擇目的地國家。
請求分類
如要在 Dashboard 或透過 API 請求分類，請遵循下面的步驟和變更。
下面的示例顯示通用（6 位數）請求。如要請求對特定國家的分類，請在 Classify 請求中新增這些國家的 ISO 代碼，如下面的示例所示。如要請求通用 HS 代碼，請在 Classify 請求中將目的地國家設為 null。
輸入採用列表，因此您可以同時請求許多或單個分類。
附註： 如要透過 API 生成 稽核軌跡，請在查詢中包含
auditTrail欄位。聯絡您的 Zonos 代表以取得存取權限和實作詳情。
1
mutation ClassifyItems($input: [ClassificationCalculateInput!]!) {2
classificationsCalculate(input: $input) {3
id4
name5
categories6
imageUrl7
hsCode {8
code9
description {10
full11
}12
}13
}14
}可能的 API 回應
當 Classify 收到分類請求時，它會根據最高信心分數，嘗試將請求中包含的輸入項目資料與 Classify 資料庫中的相符項進行匹配。根據找到的內容，Classify 將傳回下列其中一個回應：
- 當傳回
hsCode與 6 到 8+ 位數 HS 代碼時（取決於請求中是否包含目的地國家），您的分類請求已成功。 - 當傳回
{"errors": [ { "message": "No adequate response"}]}時，這表示 Classify 因輸入資訊不足而無法找到分類。
GraphQL API ReferenceTypes, inputs, and operations used in this guide
MUTATIONS
分類商品
瞭解如何在 Dashboard 和透過 API 請求分類。
以下是示例，說明如何透過 Dashboard 或 API 請求通用和國別特定分類。對於尋求更全面的技術詳情和詳盡文檔的人，請訪問我們的 Zonos GraphQL API 參考開發者網站。此綜合資源提供有關 API 端點、GraphQL 變更和詳盡技術資訊的詳細見解。