DOCS

Manage products

ホームグローバルeコマース Catalog Manage products

Catalog管理

商品の作成と変更。

DashboardまたはAPIでZonos Catalog商品の追加、変更、削除方法を学びます。コードを書きたくない場合や小規模な変更にはDashboardのCatalogを使用してください。本番実装でCatalogと直接統合する場合はAPIを使用します。

Catalogで商品を作成：

  1. Catalog に移動し、右上の Add product をクリックします。
  2. 商品詳細を追加します。商品作成に必須のフィールドはSKUおよび/またはproduct IDフィールドのみです。これらのフィールドはCatalog商品を参照するために使用されます。Catalog識別子の詳細を学びます。
  3. 任意—HS codeを追加します。
  4. 任意—配送情報（重量、寸法、計量単位など）を追加します。
  5. 任意—制限国を追加します。
  6. save product をクリックします。

Catalogで複数の商品を作成：

複数の商品またはカタログ全体を一度にアップロード。

重要： 既存の商品を作成しようとすると、CatalogはSKUおよび/またはproduct IDに基づいて商品を認識し、元の商品の詳細を新しい詳細で上書きします。

DHL配送では、商品を危険物としてタグ付けすると、その商品のlabelを作成するたびに正しいDHL付加価値サービスが自動適用されます。これは規制商品の「低リスク」または免除クラス—技術的に規制されるが特例または数量免除の下で配送される商品—をカバーします。

危険物タグはCatalog商品attributeとして保存されます：商品のkey/valueペアです。attributeはAPI（catalogItemsCreateまたはcatalogItemsUpdate）経由で設定され、DashboardフィールドやCSV列はありません。

DHLのみ

危険物タグ付けはDHL配送にのみ影響します。他のキャリアではタグは無視されます。

サポートされるattribute key

DANGEROUS_GOODSはDHL危険物タグ付けでサポートされるattribute keyです。ItemAttributeInputリファレンスの承認済みkey一覧にはまだ記載されていませんが、APIで受け付けられます。

商品にタグ付けするには、key DANGEROUS_GOODS と以下のサポートされるカテゴリのいずれかのvalueを持つattributeを追加します。

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 

Value↕Category↕
NOT_RESTRICTED_A70Not Restricted, Special Provision A70—ガスストラットやショックアブソーバーなどの加圧物品（UN3164）。
NOT_RESTRICTED_A67Not Restricted, Special Provision A67—可燃性液体で動作するエンジンまたは機械（UN3528）。
NOT_RESTRICTED_A02Not Restricted, Special Provision A02—ADR道路輸送小口貨物規定の免除。
LIMITED_QUANTITYLimited Quantity (ADR)—規制限度内の少量に包装された危険物。
EXCEPTED_QUANTITYExcepted Quantity (IATA)—大多数の航空輸送危険物規則から免除される極少量。
CONSUMER_COMMODITYConsumer commodity ID8000—エアゾールや香水など、少量の危険物を含む小売向け日用品。
MAGNETIZED_MATERIALMagnetized material (UN2807)—航空機計器に影響するほど強い磁場を持つ物品。
BIOLOGICAL_SUBSTANCEBiological substance (UN3373)—診断または臨床検体などのCategory B生物物質。
labelにタグを自動適用

商品のタグ付けが最初のステップです。ZonosがDHL labelにカテゴリを自動適用するには、label settingsで Ship dangerous goods を有効にします。単一labelで手動選択も可能—declare dangerous goodsを参照。

商品の編集により、既存商品を追加または更新情報で効率的に更新できます。商品を削除して再アップロードする代わりに、更新情報をアップロードすると、Catalogはitem key preferenceに応じたSKUまたはproduct IDで既存商品と照合します。DashboardまたはAPIで新規商品を作成または既存商品を編集する場合も、最小限の労力でカタログを最新に保てます。

Catalogに既存のCatalog商品を作成/編集する場合、以下が想定されます：

Catalogは既存商品の空白フィールドを上書きします。

  • 例：既存商品SKU 321に重量値がなく、同じSKU 321の新規アップロードに1.3 lbsの重量がある場合、1.3 lbsが以前の空白フィールドを上書きします。

Catalogは既存フィールドを新しい値で上書きします。

  • 例：既存商品SKU 123の価格が18.99 USDで、同じSKU 123の更新価格が22.99 USDの場合、22.99 USDが以前の価格を上書きします。

Catalogは空白フィールドで既存値を上書きしません。

  • 例：既存商品SKU 456のHS codeが6109.10で、更新商品SKU 456のHS codeが空白の場合、既存HS codeは維持されます。

商品を編集するには：

  1. Products タブをクリックします。
  2. 編集する商品を選択します。
  3. 変更を行います。
  4. save product をクリックします。

複数またはすべての商品を一度に編集するには、SKUまたはproduct IDを含む更新CSVをCatalogにアップロードするだけです。既存商品の自動更新がトリガーされます。

商品を削除するには：

  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 appは、国際注文から特定商品を除外する商品レベル制限をサポートしません。制限商品がカートにある場合、その国への配送はカート全体をブロックする必要があります。これはオンボーディング時に事前設定するカートレベル制限ルールで処理されます。CatalogはDuty & Tax appと互換性がありますが、商品レベル制限はZonos Checkout使用時のみサポートされます。

Catalogで単一商品を制限するには：

  1. Products タブをクリックします。
  2. 制限を追加する商品を選択すると、編集ページが開きます。
  3. 編集ページ下部の Restricted countries セクションを見つけます。
  4. 国名を選択または入力して、商品を制限する国を追加します。
  5. save product をクリックします。

Catalogで複数商品を制限するには：

  1. Import/export タブをクリックします。
  2. Catalog template CSV をダウンロードします。
  3. SKU/Product IDと制限国を含む商品詳細でテンプレートに記入します。2桁ISOコードを縦棒で区切って入力（例：AU|KR|MY|SG）。すべての国を制限する場合は ALL。特定の国を除く場合は ALL- の後に縦棒区切りで国を指定（例：ALL-CA|FR|US）。CSV formattingの詳細を学びます。既存の制限国をすべて削除する場合は NONE。
  4. ファイルをCSVとして保存し、CSVをダウンロードした同じページで browse をクリックしてファイルを選択するか、ドラッグ&ドロップでCatalogにアップロードします。
  5. プレビュー画面でアップロード商品を確認し、upload をクリックします。

制限商品のフィルタリング：

Dashboardからカタログ全体をCSV形式でダウンロードし、ExcelまたはGoogle Sheetsで開くことで、カタログ内で直接制限商品をフィルタリングできます。フィルター機能で制限商品のみ表示できます。カタログ内の制限商品を簡単に見つけて管理できます。

CSV変更後にカタログを更新する必要がある場合、ファイルを再アップロードすると、一致する商品は更新版に置き換えられます。SKUおよび/またはproduct IDの識別と照合により行われます。

Checkoutを使用している場合、商品が顧客の国に制限されているとき、Checkoutに制限メッセージが表示されます。デフォルトメッセージは「This item is restricted from import to your country.」です。

DashboardまたはAPIでSKU、product ID、商品名を使用してCatalog内の商品を検索できます。SKUとproduct ID検索は完全一致のみ、部分一致はサポートされません。商品名検索では部分一致がサポートされます。

SKUまたはproduct IDでフィルタリングするには：

  1. Dashboardで Products タブをクリックします。
  2. Catalog左上で SKU または Product ID を選択します。
  3. SKU、product ID、または商品名を入力します。
  4. Apply をクリックしてフィルター結果を表示します。

商品名を検索するには：

  1. Dashboardで Products タブをクリックします。
  2. Catalog右上の検索フィールドに商品名を入力します。
  3. フィルター結果を表示します。

Catalogテーブルから50件以下を選択すると、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. ダウンロードフォルダでカタログファイルを確認します。

メールからのダウンロードで問題が発生した場合

メールリンクからCSVをダウンロードできない場合、ブラウザがダウンロードをブロックしている可能性があります。その場合：

  1. メールの「Download」ボタンを右クリックします。
  2. 「Copy link address」を選択してダウンロードURLをコピーします。
  3. コピーしたURLをブラウザに貼り付けてEnterを押します。
  4. ブラウザから直接カタログがダウンロードされます。

APIでClassificationsCreateFromCatalog mutationのcatalogItemIdを使用して、カタログから商品をClassifyできます。

カタログから商品をClassifyするにはnameが必須です。CatalogおよびClassifyフィールドの完全なリストはGraphQL API referenceを参照してください。

Catalog商品を同時に作成・Classifyするには、以下のClassificationsCreateFromCatalog mutationをCatalogItemsCreate mutationに追加します。

Catalog商品を8桁以上（国別）にClassify 

shipToCountriesフィールドが入力されている場合、Classifyは8桁以上（国別）HS codeになります。shipToCountriesがない場合、6桁（ユニバーサル）HS codeがデフォルトです。ユニバーサルと国別HS codeの違いの詳細を学びます。

以下の例では、カナダ向け国別codeを生成するため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のみでClassifyを生成しますが、最良のClassify結果のため可能な限り詳細を追加することを強く推奨します。

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

APIエラーと解決方法 

エラー↕解決方法↕
A SKU or product ID is required to create a productSKU/product ID識別子はCatalog商品の作成、編集、削除に必須です。SKUおよび/またはproduct IDを追加してください。
The product you are trying to edit does not exist*存在しない商品は編集できません。希望するSKUおよび/またはproduct IDで新規商品を作成してください。
Customs description exceeds character limit of 30 characters.デフォルトでは、customs descriptionは商業インボイスの最も一般的な文字制限に合わせ30文字に制限されます。
Product type invalid. Catalog supports the following product types: digital_good. For physical goods, leave it blank.Catalogは digital_good と physical_good のみサポートします。physical good（最も一般的）の場合、このフィールドは空白にしてください。
Packing preference invalid. Catalog supports the following packing preferences: ships_alone and consolidated. If your product can be consolidated with other products, leave blank.無効なpacking preference。Catalogは ships_alone と consolidated をサポートします。他の商品とまとめられる場合、空白のままにできます（デフォルトは consolidated）。
Country must be specified when providing an HS code商品作成時に国別HS codeを指定する場合、配送先国が必要です。配送先国を追加してください。
Price must be greater than 0Catalogは負の価格値をサポートしません。ゼロより大きい価格を追加してください。
Currency code must be provided when a price value is supplied価格を指定する場合、通貨コードが必要です。通貨コードを追加してください。
Price must be provided when a currency code is supplied通貨コードを指定する場合、価格が必要です。価格を追加してください。
The accompanying dimensional field cannot be left blank1つの寸法フィールドを指定する場合、他2つが必要です。例：幅 8 inches を指定する場合、高さと長さが必要です。
Measurement value must be greater than 0Catalogは負またはゼロの計測値をサポートしません。ゼロより大きい値を追加してください。
When providing a dimensional value, dimensional units cannot be left empty寸法値を指定する場合、寸法単位が必要です。寸法単位を追加してください。
When providing a weight value, the weight unit cannot be left empty重量値を指定する場合、重量単位が必要です。重量単位を追加してください。

* API errorのみ

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

ItemAttributeInput

デモを予約する

このページは役に立ちましたか？

サポートを受ける·法的文書·© 2026 Zonos
このページでは：
  • Catalog管理
  • 商品を危険物としてタグ付け（DHL）
  • 商品のClassify