了解如何透過 Dashboard 或 API 新增、修改及刪除您的 Zonos Catalog 產品。若只是進行小幅變更或想避免撰寫程式碼，請在 Dashboard 中使用 Catalog；若要為正式環境的實作直接與 Catalog 整合，請使用 API。
在 Catalog 中建立產品：
在 Catalog 中建立多項產品：
一次上傳多項產品或整個產品目錄。
重要：如果您嘗試建立已存在的產品，Catalog 會根據 SKU 和/或產品 ID 辨識該產品，並以新的詳細資訊覆寫原始產品的詳細資訊。
編輯產品可讓您有效率地以新增或更新的資訊來更新現有產品。您不必刪除後重新上傳產品，只要上傳更新後的資訊，Catalog 就會依您設定的品項金鑰偏好，透過 SKU 或產品 ID 將其與現有產品配對。如此一來，不論您是透過 Dashboard 或 API 建立新產品或編輯現有產品，都能以最少的心力讓您的目錄保持最新。
如果您建立/編輯的 Catalog 產品已存在於 Catalog 中，會發生以下情況：
Catalog 會以新值覆寫現有項目的空白欄位。
Catalog 會以新的欄位值覆寫現有欄位。
Catalog 不會以空白欄位覆寫現有值。
若要編輯產品：
若要一次編輯多項或全部產品，只要將更新後的 CSV 檔案（包含您的 SKU 或產品 ID）上傳至 Catalog 即可。這會觸發現有項目的自動更新。
若要刪除產品：
若要刪除所有產品：
請注意，如果您要刪除大量項目（超過約 20,000 項產品），系統會顯示通知，告知您刪除作業正在進行中。在此期間，您將無法與 Catalog 互動，直到刪除完成為止。不過，您可以關閉此通知並離開頁面，而不會中斷刪除程序。
如果您想避免貨件運送至特定國家/地區，可以在建立或更新產品時新增限制。
Zonos Duty & Tax 應用程式不支援移除國際訂單中特定產品的品項層級限制。如果購物車中含有受限制的品項，則整個購物車都必須被封鎖、無法運送至該國家/地區。這是透過購物車層級的限制規則來處理，必須在導入初期預先設定完成。雖然 Catalog 與 Duty & Tax 應用程式相容，但品項層級限制僅在使用 Zonos Checkout 時才受支援。
若要在 Catalog 中限制單一產品：
若要在 Catalog 中限制多項產品：
AU|KR|MY|SG
ALL
ALL-
ALL-CA|FR|US
NONE
篩選受限制的產品：
您可以直接在目錄中篩選受限制的產品，方法是從 Dashboard 以 CSV 格式下載整個目錄，然後在 Excel 或 Google 試算表中開啟。接著，您可以使用篩選功能只檢視受限制的產品，方便您輕鬆找出並管理目錄中的受限制產品。
如果您在變更 CSV 後需要更新您的目錄，請重新上傳檔案，系統會以更新後的版本取代任何相符的產品。此比對是依 SKU 和/或產品 ID 進行識別與配對。
如果您使用 Checkout，當您的產品受限運送至客戶所在國家/地區時，結帳頁面會顯示限制訊息。根據預設，此訊息內容為「此項目限制進口至您的國家/地區。」
您可以透過 Dashboard 或 API，使用 SKU、產品 ID 或產品名稱搜尋 Catalog 中的產品。以 SKU 和產品 ID 搜尋時，僅完全相符才會傳回結果，不支援部分相符；但以產品名稱搜尋時，則支援部分相符。
若要依 SKU 或產品 ID 尋找產品：
若要依名稱尋找產品：
如果您在 Catalog 表格中選取 50 項或以下的項目，您的目錄會直接從 Dashboard 下載。不過，如果您選取全部匯出或超過 50 項的項目，您的 CSV 將透過電子郵件匯出。
若要匯出 50 項或以下的項目，請依照下列步驟操作：
如果您在從電子郵件連結下載 CSV 時遇到問題，可能是因為瀏覽器封鎖了下載。如果發生這種情況，請依照下列步驟操作：
您可以使用 ClassificationsCreateFromCatalog 變更中的 catalogItemId，透過 API 對目錄中的產品進行分類。
ClassificationsCreateFromCatalog
catalogItemId
請注意，若要從您的目錄分類產品，必須提供 name。如需完整的目錄與分類欄位清單，請參閱 GraphQL API 參考資料。
name
若要同時建立並分類 Catalog 產品，請將下方的 ClassificationsCreateFromCatalog 變更新增至您的 CatalogItemsCreate 變更。
CatalogItemsCreate
當 shipToCountries 欄位已填寫時，分類結果將是 8 碼以上（特定國家/地區）的 HS 代碼；如果未提供 shipToCountries，分類結果將預設為 6 碼（通用）HS 代碼。深入瞭解通用 HS 代碼與特定國家/地區 HS 代碼之間的差異。
shipToCountries
在下方範例中，已提供 shipToCountries 欄位，以產生加拿大的特定國家/地區代碼。
mutation ClassificationsCreateFromCatalog(
$catalogItemToClassify: [ClassificationFromCatalogInput!]!
) {
classificationsCalculateFromCatalog(input: $catalogItemToClassify) {
id
configuration {
}
hsCode {
code
以下是要求的範例。雖然 Zonos Classify 僅需 name 即可產生分類，但我們強烈建議您盡可能新增更多詳細資訊，以獲得最佳的分類結果。
{
"catalogItemToClassify": [
digital_good
physical_good
ships_alone
consolidated
* 僅 API 錯誤
針對 DHL 貨件，您可以將產品標記為危險品，讓系統在每次為該產品建立標籤時自動套用正確的 DHL 加值服務。此功能適用於「低風險」或豁免類別的管制商品，也就是技術上受管制、但依特殊規定或數量豁免出貨的商品。
危險品標籤是以 Catalog 項目屬性的形式儲存：也就是產品上的一組 key/value 配對。屬性透過 API（catalogItemsCreate 或 catalogItemsUpdate）設定——Dashboard 中沒有對應欄位，CSV 也沒有對應欄。
key
value
catalogItemsCreate
catalogItemsUpdate
危險品標記僅適用於 DHL 貨件，其他快遞商將會忽略此標記。
DANGEROUS_GOODS 是 DHL 危險品標記支援的屬性金鑰。此金鑰尚未列在 ItemAttributeInput 參考資料中已核准的金鑰清單裡，但 API 仍會接受此金鑰。
DANGEROUS_GOODS
ItemAttributeInput
若要標記產品，請新增一個金鑰為 DANGEROUS_GOODS 的屬性，並將值設為下列支援類別之一。
mutation CatalogItemsCreate(
$sku: String!
$name: String
$attributes: [ItemAttributeInput!]
catalogItemsCreate(
input: [{ sku: $sku, name: $name, attributes: $attributes }]
sku
attributes {
NOT_RESTRICTED_A70
NOT_RESTRICTED_A67
NOT_RESTRICTED_A02
LIMITED_QUANTITY
EXCEPTED_QUANTITY
CONSUMER_COMMODITY
MAGNETIZED_MATERIAL
BIOLOGICAL_SUBSTANCE
標記產品只是第一步。若要讓 Zonos 在您的 DHL 標籤上自動套用類別，請在標籤設定中開啟運送危險品。您也可以在單一標籤上手動選擇類別——請參閱申報危險品。
管理產品
管理 Catalog
建立和修改產品。了解如何透過 Dashboard 或 API 新增、修改及刪除您的 Zonos Catalog 產品。若只是進行小幅變更或想避免撰寫程式碼，請在 Dashboard 中使用 Catalog；若要為正式環境的實作直接與 Catalog 整合，請使用 API。
建立產品
在 Catalog 中建立產品：
在 Catalog 中建立多項產品：
一次上傳多項產品或整個產品目錄。
編輯產品
編輯產品可讓您有效率地以新增或更新的資訊來更新現有產品。您不必刪除後重新上傳產品，只要上傳更新後的資訊，Catalog 就會依您設定的品項金鑰偏好，透過 SKU 或產品 ID 將其與現有產品配對。如此一來，不論您是透過 Dashboard 或 API 建立新產品或編輯現有產品，都能以最少的心力讓您的目錄保持最新。
如果您建立/編輯的 Catalog 產品已存在於 Catalog 中，會發生以下情況：
Catalog 會以新值覆寫現有項目的空白欄位。
Catalog 會以新的欄位值覆寫現有欄位。
Catalog 不會以空白欄位覆寫現有值。
若要編輯產品：
若要一次編輯多項或全部產品，只要將更新後的 CSV 檔案（包含您的 SKU 或產品 ID）上傳至 Catalog 即可。這會觸發現有項目的自動更新。
刪除產品
若要刪除產品：
若要刪除所有產品：
請注意，如果您要刪除大量項目（超過約 20,000 項產品），系統會顯示通知，告知您刪除作業正在進行中。在此期間，您將無法與 Catalog 互動，直到刪除完成為止。不過，您可以關閉此通知並離開頁面，而不會中斷刪除程序。
限制產品
如果您想避免貨件運送至特定國家/地區，可以在建立或更新產品時新增限制。
Zonos Duty & Tax 應用程式不支援移除國際訂單中特定產品的品項層級限制。如果購物車中含有受限制的品項，則整個購物車都必須被封鎖、無法運送至該國家/地區。這是透過購物車層級的限制規則來處理，必須在導入初期預先設定完成。雖然 Catalog 與 Duty & Tax 應用程式相容，但品項層級限制僅在使用 Zonos Checkout 時才受支援。
若要在 Catalog 中限制單一產品：
若要在 Catalog 中限制多項產品：
AU|KR|MY|SG。若要限制所有國家/地區，只需將值輸入為ALL。如果您想限制所有國家/地區、僅保留一個或少數幾個國家/地區不受限制，請輸入ALL-，後面接上您想解除限制的國家/地區，並以直線符號分隔，例如ALL-CA|FR|US。深入瞭解 CSV 格式。如果您想移除所有現有的限制國家/地區，請輸入NONE做為值。篩選受限制的產品：
您可以直接在目錄中篩選受限制的產品，方法是從 Dashboard 以 CSV 格式下載整個目錄，然後在 Excel 或 Google 試算表中開啟。接著，您可以使用篩選功能只檢視受限制的產品，方便您輕鬆找出並管理目錄中的受限制產品。
如果您在變更 CSV 後需要更新您的目錄，請重新上傳檔案，系統會以更新後的版本取代任何相符的產品。此比對是依 SKU 和/或產品 ID 進行識別與配對。
如果您使用 Checkout，當您的產品受限運送至客戶所在國家/地區時，結帳頁面會顯示限制訊息。根據預設，此訊息內容為「此項目限制進口至您的國家/地區。」
尋找產品
您可以透過 Dashboard 或 API，使用 SKU、產品 ID 或產品名稱搜尋 Catalog 中的產品。以 SKU 和產品 ID 搜尋時，僅完全相符才會傳回結果，不支援部分相符；但以產品名稱搜尋時，則支援部分相符。
若要依 SKU 或產品 ID 尋找產品：
若要依名稱尋找產品：
匯出您的產品
如果您在 Catalog 表格中選取 50 項或以下的項目，您的目錄會直接從 Dashboard 下載。不過，如果您選取全部匯出或超過 50 項的項目，您的 CSV 將透過電子郵件匯出。
若要匯出 50 項或以下的項目，請依照下列步驟操作：
匯出所有產品：
從電子郵件下載時遇到問題？
如果您在從電子郵件連結下載 CSV 時遇到問題，可能是因為瀏覽器封鎖了下載。如果發生這種情況，請依照下列步驟操作：
分類產品
您可以使用
ClassificationsCreateFromCatalog變更中的catalogItemId，透過 API 對目錄中的產品進行分類。請注意，若要從您的目錄分類產品，必須提供
name。如需完整的目錄與分類欄位清單，請參閱 GraphQL API 參考資料。若要同時建立並分類 Catalog 產品，請將下方的
ClassificationsCreateFromCatalog變更新增至您的CatalogItemsCreate變更。將 Catalog 產品分類為 8 碼以上（特定國家/地區）的 HS 代碼
當
shipToCountries欄位已填寫時，分類結果將是 8 碼以上（特定國家/地區）的 HS 代碼；如果未提供shipToCountries，分類結果將預設為 6 碼（通用）HS 代碼。深入瞭解通用 HS 代碼與特定國家/地區 HS 代碼之間的差異。在下方範例中，已提供
shipToCountries欄位，以產生加拿大的特定國家/地區代碼。mutation ClassificationsCreateFromCatalog($catalogItemToClassify: [ClassificationFromCatalogInput!]!) {classificationsCalculateFromCatalog(input: $catalogItemToClassify) {idconfiguration {shipToCountries}hsCode {code}name}}以下是要求的範例。雖然 Zonos Classify 僅需
name即可產生分類，但我們強烈建議您盡可能新增更多詳細資訊，以獲得最佳的分類結果。{"catalogItemToClassify": [{API 錯誤與解決方式
digital_good和physical_good。如果您的產品是實體商品（最常見），請將此欄位留空。ships_alone和consolidated。如果您的產品可以與其他產品進行合併運送，您可以將其留空，因為consolidated是預設值。標記危險品 (DHL)
針對 DHL 貨件，您可以將產品標記為危險品，讓系統在每次為該產品建立標籤時自動套用正確的 DHL 加值服務。此功能適用於「低風險」或豁免類別的管制商品，也就是技術上受管制、但依特殊規定或數量豁免出貨的商品。
危險品標籤是以 Catalog 項目屬性的形式儲存：也就是產品上的一組
key/value配對。屬性透過 API（catalogItemsCreate或catalogItemsUpdate）設定——Dashboard 中沒有對應欄位，CSV 也沒有對應欄。危險品標記僅適用於 DHL 貨件，其他快遞商將會忽略此標記。
DANGEROUS_GOODS是 DHL 危險品標記支援的屬性金鑰。此金鑰尚未列在ItemAttributeInput參考資料中已核准的金鑰清單裡，但 API 仍會接受此金鑰。若要標記產品，請新增一個金鑰為
DANGEROUS_GOODS的屬性，並將值設為下列支援類別之一。mutation CatalogItemsCreate($sku: String!$name: String$attributes: [ItemAttributeInput!]) {catalogItemsCreate(input: [{ sku: $sku, name: $name, attributes: $attributes }]) {idnameskuattributes {keyvalue}}}支援的危險品值
NOT_RESTRICTED_A70NOT_RESTRICTED_A67NOT_RESTRICTED_A02LIMITED_QUANTITYEXCEPTED_QUANTITYCONSUMER_COMMODITYMAGNETIZED_MATERIALBIOLOGICAL_SUBSTANCE標記產品只是第一步。若要讓 Zonos 在您的 DHL 標籤上自動套用類別，請在標籤設定中開啟運送危險品。您也可以在單一標籤上手動選擇類別——請參閱申報危險品。
ItemAttributeInput
這個頁面有幫助嗎？