Sign in
Book a demo

管理 Catalog

建立和修改產品。

了解如何透過 Dashboard 或 API 新增、修改及刪除您的 Zonos Catalog 產品。若只是進行小幅變更或想避免撰寫程式碼，請在 Dashboard 中使用 Catalog；若要為正式環境的實作直接與 Catalog 整合，請使用 API。

在 Catalog 中建立產品：

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

在 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 代碼會保留不變。

若要編輯產品：

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

若要一次編輯多項或全部產品，只要將更新後的 CSV 檔案（包含您的 SKU 或產品 ID）上傳至 Catalog 即可。這會觸發現有項目的自動更新。

若要刪除產品：

  1. 按一下 Dashboard 中的產品標籤。
  2. 選取您要刪除的一項或多項產品。選定產品後，畫面上會顯示刪除按鈕。
  3. 按一下刪除，然後按一下全部刪除以確認刪除。

若要刪除所有產品：

  1. 選取 Dashboard 中的產品標籤。
  2. 按一下右上角的管理 Catalog，然後按一下全部刪除。
  3. 再按一下全部刪除一次以確認刪除。

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

如果您想避免貨件運送至特定國家/地區，可以在建立或更新產品時新增限制。

Zonos 稅費應用程式不支援移除國際訂單中特定產品的品項層級限制。如果購物車中含有受限制的品項，則整個購物車都必須被封鎖、無法運送至該國家/地區。這是透過購物車層級的限制規則來處理，必須在導入初期預先設定完成。雖然 Catalog 與稅費應用程式相容，但品項層級限制僅在使用 Zonos Checkout 時才受支援。

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

  1. 按一下產品標籤。
  2. 選取您要新增限制的產品，這會開啟編輯頁面。
  3. 在編輯頁面底部找到限制國家/地區區段。
  4. 選取或輸入國家/地區名稱，新增您要限制此產品的國家/地區。
  5. 按一下儲存產品。

若要在 Catalog 中限制多項產品：

  1. 按一下匯入/匯出標籤。
  2. 下載 Catalog 範本 CSV。
  3. 在範本中填入您的產品詳細資訊，包括 SKU/產品 ID 及限制國家/地區。請輸入 2 碼 ISO 代碼，並以直線符號分隔，例如 AU|KR|MY|SG。若要限制所有國家/地區，只需將值輸入為 ALL。如果您想限制所有國家/地區、僅保留一個或少數幾個國家/地區不受限制，請輸入 ALL-，後面接上您想解除限制的國家/地區，並以直線符號分隔，例如 ALL-CA|FR|US。深入瞭解 CSV 格式。如果您想移除所有現有的限制國家/地區，請輸入 NONE 做為值。
  4. 將檔案另存為 CSV，並在您下載該 CSV 的同一頁面上，以拖放方式或按一下瀏覽選取檔案，上傳至 Catalog。
  5. 在預覽畫面中檢視您上傳的產品，然後按一下上傳。

篩選受限制的產品：

您可以直接在目錄中篩選受限制的產品，方法是從 Dashboard 以 CSV 格式下載整個目錄，然後在 Excel 或 Google 試算表中開啟。接著，您可以使用篩選功能只檢視受限制的產品，方便您輕鬆找出並管理目錄中的受限制產品。

如果您在變更 CSV 後需要更新您的目錄，請重新上傳檔案，系統會以更新後的版本取代任何相符的產品。此比對是依 SKU 和/或產品 ID 進行識別與配對。

If you're using Checkout，當您的產品受限運送至客戶所在國家/地區時，結帳頁面會顯示限制訊息。根據預設，此訊息內容為「此項目限制進口至您的國家/地區。」

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

若要依 SKU 或產品 ID 篩選：

  1. 按一下 Dashboard 中的產品標籤。
  2. 在 Catalog 左上角選取SKU或產品 ID。
  3. 輸入您的 SKU、產品 ID 或產品名稱。
  4. 按一下套用以檢視篩選後的產品。

若要搜尋產品名稱：

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

如果您在 Catalog 表格中選取 50 項或以下的項目，您的目錄會直接從 Dashboard 下載。不過，如果您選取全部匯出或超過 50 項的項目，您的 CSV 將透過電子郵件匯出。

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

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

匯出所有產品：

  1. 前往Dashboard -> 產品 -> Catalog。
  2. 按一下新增產品旁的管理 Catalog下拉式選單，然後按一下全部匯出。
  3. 在您的下載項目中找到您的目錄檔案。

從電子郵件下載時遇到問題？

如果您在從電子郵件連結下載 CSV 時遇到問題，可能是因為瀏覽器封鎖了下載。如果發生這種情況，請依照下列步驟操作：

  1. 在電子郵件中的「下載」按鈕上按一下滑鼠右鍵。
  2. 選取「複製連結網址」以複製下載 URL。
  3. 將複製的 URL 貼到您的瀏覽器中並按 Enter。
  4. 您的目錄即會直接從瀏覽器下載。

您可以使用 ClassificationsCreateFromCatalog 變更中的 catalogItemId，透過 API 對目錄中的產品進行分類。

請注意，若要從您的目錄分類產品，必須提供 name。如需完整的目錄與分類欄位清單，請參閱 GraphQL API 參考資料。

若要同時建立並分類 Catalog 產品，請將下方的 ClassificationsCreateFromCatalog 變更新增至您的 CatalogItemsCreate 變更。

將 Catalog 產品分類為 8 碼以上（特定國家/地區）的 HS 代碼 

當 shipToCountries 欄位已填寫時，分類結果將是 8 碼以上（特定國家/地區）的 HS 代碼；如果未提供 shipToCountries，分類結果將預設為 6 碼（通用）HS 代碼。深入瞭解通用 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建立、編輯或刪除目錄項目都需要識別碼（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

Copyright © 2026 Zonos

•

Privacy PolicyTerms of Service