DOCS

管理產品

首頁全球電商 Catalog 管理產品

管理 Catalog

建立和修改產品。

了解如何在 Dashboard 或通過 API 新增、修改和刪除您的 Zonos Catalog 產品。如果您想避免寫程式或進行小幅修改，請使用 Dashboard 中的 Catalog。如果您想直接與 Catalog 整合以進行生產環境實施，請使用 API。

在 Catalog 中建立產品：

  1. 前往 Catalog，然後按一下右上角的 新增產品。
  2. 新增您的產品詳細資料。建立產品唯一需要的欄位是 SKU 和/或產品 ID 欄位。這些欄位將用於參考您的 Catalog 產品。深入了解 Catalog 的識別符。
  3. 選填—新增您的 HS 代碼。
  4. 選填—新增您的運輸資訊 (重量、尺寸、計量單位等)。
  5. 選填—新增受限制國家。
  6. 按一下 儲存產品。

在 Catalog 中建立多個產品：

一次上傳多個產品或您整個產品 Catalog。

重要： 如果您嘗試建立已存在的產品，Catalog 將根據 SKU 和/或產品 ID 識別該產品，並以新詳細資料覆蓋原始產品的詳細資料。

對於 DHL 貨運，您可以將產品標記為危險品，這樣每次為該產品建立標籤時，都會自動套用正確的 DHL 增值服務。這涵蓋了「低風險」或豁免類別的受管制商品——即技術上受管制，但根據特殊條款或數量豁免出貨的物品。

危險品標籤是以 Catalog 項目屬性的形式儲存：即產品上的 key/value 配對。屬性是通過 API (catalogItemsCreate 或 catalogItemsUpdate) 設定的——沒有 Dashboard 欄位或 CSV 欄可供使用。

僅限 DHL

危險品標籤只會影響 DHL 貨運。該標籤對其他承運商會被忽略。

支援的屬性金鑰

DANGEROUS_GOODS 是 DHL 危險品標籤的受支援屬性金鑰。它尚未列在 ItemAttributeInput 參考中已批准的金鑰清單裡，但 API 會接受它。

若要標記產品，請新增金鑰為 DANGEROUS_GOODS 的屬性，以及以下其中一個受支援類別的值。

1mutation CatalogItemsCreate(
2$sku: String!
3$name: String
4$attributes: [ItemAttributeInput!]
5) {
6 catalogItemsCreate(
7 input: [{ sku: $sku, name: $name, attributes: $attributes }]
8 ) {
9 id
10 name
11 sku
12 attributes {
13 key
14 value
15 }
16 }
17}

支援的危險品值

Value↕Category↕
NOT_RESTRICTED_A70未受限制，特殊條款 A70——加壓物品，例如氣體支柱和避震器 (UN3164)。
NOT_RESTRICTED_A67未受限制，特殊條款 A67——由易燃液體驅動的引擎或機械 (UN3528)。
NOT_RESTRICTED_A02未受限制，特殊條款 A02——根據 ADR 道路運輸小批量條款豁免。
LIMITED_QUANTITY限量 (ADR)——在監管限額內包裝的少量危險品。
EXCEPTED_QUANTITY豁免數量 (IATA)——數量極少，豁免大多數空運危險品規則。
CONSUMER_COMMODITY消費品 ID8000——具有輕微危險成分的現成日常產品，例如噴霧罐和香水。
MAGNETIZED_MATERIAL磁化物料 (UN2807)——磁場強度足以影響飛機儀器的物品。
BIOLOGICAL_SUBSTANCE生物物質 (UN3373)——B 類生物物質，例如診斷或臨床標本。
在標籤上自動套用標籤

標記產品只是第一步。若要讓 Zonos 自動將該類別套用於您的 DHL 標籤，請在 標籤設定中開啟運輸危險品。您也可以在 單個標籤上手動選擇類別——請參閱 申報危險品。

編輯產品讓您可以有效率地為現有產品更新額外或最新的資訊。您無需刪除並重新上傳產品，而是可以上傳更新後的資訊，Catalog 會根據您的 SKU 或產品 ID (取決於您的項目金鑰偏好) 將其與現有產品配對。這樣一來，無論您是使用 Dashboard 還是 API 來建立新產品或編輯現有產品，都可以輕鬆讓 Catalog 保持最新。

如果您建立/編輯的 Catalog 產品已存在，請預期以下情況：

Catalog 會以新值覆寫現有項目的空白欄位。

  • 例如，如果現有產品 SKU 321 沒有重量值，而同一產品 SKU 321 在新上傳中重量為 1.3 磅，則 1.3 磅的重量會覆寫先前的空白欄位。

Catalog 會以新欄位值覆寫現有欄位。

  • 例如，如果現有產品 SKU 123 的價格為 18.99 美元，而同一產品 SKU 123 有更新後的價格 22.99 美元，則新的 22.99 美元價格會覆寫先前的價格。

Catalog 不會以空白欄位覆寫現有值。

  • 例如，如果現有產品 SKU 456 有 HS 代碼 6109.10，但更新後產品 SKU 456 的 HS 代碼為空白，現有的 HS 代碼會保持不變。

若要編輯產品：

  1. 按一下 Products 標籤。
  2. 選擇您要編輯的產品。
  3. 進行您的變更。
  4. 按一下 儲存產品。

若要一次編輯多個或全部產品，只需將更新後的 CSV 檔案上傳到 Catalog，包括您的 SKU 或產品 ID。這將觸發對現有項目的自動更新。

若要刪除產品：

  1. 在 Dashboard 中按一下 Products 標籤。
  2. 選擇您要刪除的產品。選擇產品後，會出現刪除按鈕。
  3. 按一下 Delete，然後按一下 Delete all 以確認您的刪除。

若要刪除所有產品：

  1. 選擇 Dashboard 中的 Products 標籤。
  2. 按一下右上角的 Manage Catalog，然後按一下 Delete all。
  3. 再按一下 Delete all 一次以確認您的刪除。

請注意，如果您要刪除大量項目 (超過約 20,000 件產品)，會出現通知，表示您的刪除正在進行中。在此期間，您將無法與 Catalog 互動，直到刪除完成為止。不過，您可以關閉通知並離開頁面，而不會中斷刪除程序。

如果您想防止產品運送到特定國家 (或多個國家)，可以在建立或更新產品時新增限制。

Zonos Duty & Tax 應用程式不支援可將特定產品從跨境訂單中移除的項目層級限制。如果購物車中有受限制的項目，則整個購物車都必須被封鎖，無法運送到該國家。這是透過購物車層級限制規則處理的，該規則必須在導入期間預先設定。雖然 Catalog 與 Duty & Tax 應用程式相容，但項目層級限制僅在使用 Zonos Checkout 時才受支援。

若要限制 Catalog 中的單一產品：

  1. 按一下 Products 標籤。
  2. 選擇您要新增限制的產品，這會打開編輯頁面。
  3. 在編輯頁面底部找到 Restricted countries 部分。
  4. 選擇或輸入國家名稱，新增您要限制產品運送到的國家。
  5. 按一下 儲存產品。

若要限制 Catalog 中的多個產品：

  1. 按一下 Import/export 標籤。
  2. 下載 Catalog template CSV。
  3. 在範本中填入您的產品詳細資料，包括您的 SKU/產品 ID 和受限制國家。輸入以直線分隔的 2 位數 ISO 代碼，例如 AU|KR|MY|SG。若要限制所有國家，只需輸入 ALL 作為值。如果您想限制除了一個或幾個國家以外的所有國家，請輸入 ALL-，後面接上您想解除限制的國家，並以直線分隔，例如 ALL-CA|FR|US。深入了解 CSV 格式化。如果您想移除所有現有的受限制國家，請輸入 NONE 作為值。
  4. 將您的檔案另存為 CSV，並在您下載該 CSV 的同一頁面上，透過拖放或按一下 browse 選擇檔案，將其上傳到 Catalog。
  5. 在預覽畫面中檢查您上傳的產品，然後按一下 upload。

篩選受限制產品：

您可以透過從 Dashboard 下載整個 Catalog 的 CSV 格式檔案，並在 Excel 或 Google Sheets 中開啟，直接在 Catalog 中篩選受限制產品。之後，您可以使用篩選功能只檢視受限制產品。這讓您可以輕鬆找到並管理 Catalog 中的受限制產品。

如果您需要在對 CSV 進行變更後更新 Catalog，請重新上傳該檔案，任何相符的產品都會以更新後的版本取代。這是透過辨識並比對 SKU 和/或產品 ID 完成的。

If you're using Checkout，當產品受限於客戶所在國家時，Checkout 中會顯示受限制訊息。預設情況下，訊息會顯示「此項目受限制，無法進口至您的國家。」

您可以在 Dashboard 或透過 API，使用 SKU、產品 ID 或產品名稱在 Catalog 中搜尋產品。對於 SKU 和產品 ID 搜尋，只有完全相符才會傳回結果；不支援部分相符。不過，按產品名稱搜尋時，則支援部分相符。

若要以 SKU 或產品 ID 篩選：

  1. 在 Dashboard 中按一下 Products 標籤。
  2. 在 Catalog 左上方選擇 SKU 或 Product ID。
  3. 輸入您的 SKU、產品 ID 或產品名稱。
  4. 按一下 Apply 以檢視您篩選的產品。

若要搜尋產品名稱：

  1. 在 Dashboard 中按一下 Products 標籤。
  2. 在 Catalog 右上方，於搜尋欄位中輸入產品名稱。
  3. 檢視您篩選的產品。

如果您在 Catalog 表格中選擇 50 個或以下的項目，您的 Catalog 會直接從 Dashboard 下載。不過，如果您選擇 Export all 或超過 50 個項目，您的 CSV 會以電郵方式匯出。

若要匯出 50 個或以下的項目，請按照以下步驟操作：

  1. 直接在 Catalog 表格中選擇 50 個或以下的項目。
  2. 按一下右上角的 Export。
  3. 在您的電郵收件匣中找到您的 CSV 檔案。

若要匯出所有產品：

  1. 前往 Dashboard -> Products -> Catalog。
  2. 按一下 Add product 旁邊的 Manage Catalog 下拉式選單，然後按一下 Export all。
  3. 在您的下載項目中找到您的 Catalog 檔案。

從電郵下載時遇到問題？

如果您在從電郵連結下載 CSV 時遇到問題，這可能是因為您的瀏覽器封鎖了下載。如果是這樣，請按照以下步驟操作：

  1. 在您電郵中的「Download」按鈕上按右鍵。
  2. 選擇「Copy link address」以複製下載網址。
  3. 將複製的網址貼到您的瀏覽器中並按 Enter。
  4. 您的 Catalog 隨後會直接從瀏覽器下載。

您可以在 ClassificationsCreateFromCatalog mutation 中使用 catalogItemId，透過 API 為您 Catalog 中的產品分類。

請注意，要為 Catalog 中的產品分類，需要提供 name。請參閱 GraphQL API 參考資料，以取得完整的 Catalog 和分類欄位清單。

若要同時建立並分類 Catalog 產品，請將以下的 ClassificationsCreateFromCatalog mutation 新增到您的 CatalogItemsCreate mutation。

將 Catalog 產品分類為 8 位數以上 (國家特定) 

當 shipToCountries 欄位有填入值時，分類結果將是 8 位數以上 (國家特定) 的 HS 代碼。如果未提供 shipToCountries，分類結果將預設為 6 位數 (通用) HS 代碼。深入了解通用與國家特定 HS 代碼之間的區別。

在以下範例中，提供了 shipToCountries 欄位，以產生加拿大的國家特定代碼。

1mutation ClassificationsCreateFromCatalog(
2$catalogItemToClassify: [ClassificationFromCatalogInput!]!
3) {
4 classificationsCalculateFromCatalog(input: $catalogItemToClassify) {
5 id
6 configuration {
7 shipToCountries
8 }
9 hsCode {
10 code
11 }
12 name
13 }
14}

以下是一個請求範例。雖然 Zonos Classify 僅需 name 即可產生分類，但我們強烈建議您新增盡可能多的詳細資料，以取得最佳分類結果。

1{
2 "catalogItemToClassify": [
3 {
4 "catalogItemId": "catalog_item_893jkdkllg03k9khjd9",
5 "configuration":

API 錯誤及解決方法 

Error↕Resolution↕
必須提供 SKU 或產品 ID 才能建立產品建立、編輯或刪除 Catalog 項目需要一個識別碼 (SKU/產品 ID)。若要解決此問題，請新增 SKU 和/或產品 ID。
您嘗試編輯的產品不存在*您無法編輯不存在的產品。若要解決此問題，請使用您想要的 SKU 和/或產品 ID 建立新產品。
海關說明超過 30 個字元的限制。根據預設，海關說明限制為 30 個字元，這符合商業發票最常見的字元限制。
產品類型無效。Catalog 支援以下產品類型：digital_good。若為實體商品，請留空。Catalog 僅支援以下產品類型：digital_good 和 physical_good。如果您的產品是實體商品 (最常見的情況)，請將此欄位留空。
包裝偏好無效。Catalog 支援以下包裝偏好：ships_alone 和 consolidated。如果您的產品可以與其他產品合併包裝，請留空。包裝偏好無效。Catalog 支援以下包裝偏好：ships_alone 和 consolidated。如果您的產品可以與其他產品合併包裝，可以將此欄位留空，因為預設值即為 consolidated。
提供 HS 代碼時必須指定國家如果您在建立項目時提供國家特定的 HS 代碼，則必須提供發貨國家。若要解決此問題，請新增發貨國家。
價格必須大於 0Catalog 不支援負數的價格值。若要解決此問題，請新增大於零的價格。
提供價格值時必須提供貨幣代碼如果您提供價格，則需要貨幣代碼。若要解決此問題，請新增貨幣代碼。
提供貨幣代碼時必須提供價格如果您提供貨幣代碼，則需要價格。若要解決此問題，請新增價格。
相應的尺寸欄位不能留空如果提供了一個尺寸欄位，則另外兩個也是必填的，例如，如果您提供的寬度為 8 英吋，則長度和高度也是必填的。
量測值必須大於 0Catalog 不支援負數或零的量測值。若要解決此問題，請新增大於零的值。
提供尺寸值時，尺寸單位不能留空如果您提供尺寸值，則需要尺寸單位。若要解決此問題，請新增尺寸單位。
提供重量值時，重量單位不能留空如果您提供重量值，則需要重量單位。若要解決此問題，請新增重量單位。

* 僅限 API 錯誤

GraphQL API ReferenceTypes, inputs, and operations used in this guide
INPUTS

ItemAttributeInput

預約演示

這個頁面有幫助嗎？

獲取支持·法律文件·© 2026 Zonos
在此頁面：
  • 管理 Catalog
  • 將產品標記為危險品 (DHL)