DOCS

Manage products

/

カタログの管理

製品を作成および変更します。

ダッシュボードまたはAPIを介して、Zonosカタログ製品を追加、変更、削除する方法を学びます。ダッシュボードのカタログを使用すると、コードを書くことなく、または小さな変更を行う場合に便利です。生産実装のためにカタログと直接統合したい場合は、APIを使用してください。

製品を作成する

ダッシュボード
API

カタログに製品を作成します:

  1. カタログに移動し、右上隅の製品を追加をクリックします。
  2. 製品の詳細を追加します。製品を作成するために必要な唯一のフィールドはSKUおよび/または製品IDフィールドです。これらのフィールドは、カタログ製品を参照するために使用されますカタログの識別子について詳しく学びましょう。
  3. オプション—HSコードを追加します。
  4. オプション—配送情報(重量、寸法、単位など)を追加します。
  5. オプション—制限国を追加します。
  6. 製品を保存をクリックします。

カタログに複数の製品を作成します:

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

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

製品の編集

製品の編集により、既存の製品を追加または更新された情報で効率的に更新できます。製品を削除して再アップロードする代わりに、更新された情報をアップロードすることで、CatalogはSKUまたは製品IDを使用して既存の製品と照合します。これによりダッシュボードまたAPIを使用して新しい製品を作成したり既存の製品を編集したりする際に、最小限の労力でカタログを最新の状態に保つことができます。

Catalogに既に存在するカタログ製品を作成/編集した場合、次のことを期待してください:

Catalogは既存のアイテムの空白フィールドを上書きします。

  • 例えば、既存の製品SKU 321に重量の値がなかった場合、同じ製品SKU 321が新しいアップロードで1.3ポンドの重量を持っていると、1.3ポンドの重量が以前の空白フィールドを上書きします。

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

  • 例えば、既存の製品SKU 123が18.99 USDの価格を持っていて、同じ製品SKU 123が22.99 USDの更新された価格を持っている場合、新しい価格22.99 USDが以前の価格を上書きします。

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

  • 例えば、既存の製品SKU 456が6109.10のHSコードを持っているが、更新された製品SKU 456のHSコードが空白の場合、既存のHSコードはそのまま残ります。
ダッシュボード
API

製品を編集するには:

  1. 製品タブをクリックします。
  2. 編集したい製品を選択します。
  3. 変更を加えます。
  4. 製品を保存をクリックします。

複数またはすべての製品を一度に編集するには、SKU/製品IDの組み合わせを含む更新されたCSVファイルをCatalogにアップロードするだけです。これにより、既存のアイテムが自動的に更新されます。

商品を削除する

ダッシュボード
API

商品を削除するには:

  1. ダッシュボードのProductsタブをクリックします。
  2. 削除したい商品を選択します。商品が選択されると、削除ボタンが表示されます。
  3. Deleteをクリックし、次にDelete allをクリックして削除を確認します。

すべての商品を削除するには:

  1. ダッシュボードのProductsタブを選択します。
  2. 右上のManage Catalogをクリックし、次にDelete allをクリックします。
  3. 削除を確認するために、もう一度Delete allをクリックします。

20,000商品以上の大量の商品を削除する場合、削除が進行中であることを示す通知が表示されます。この間、削除が完了するまでカタログと対話することはできません。ただし、通知を閉じて、削除プロセスを中断することなく他のページに移動することができます。

Restrict 商品を制限する

特定の国(または国々)への出荷を防ぎたい場合は、商品を作成または更新する際に制限を追加できます。

ダッシュボード
API

カタログで単一の商品をrestrictするには:

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

カタログで複数の商品をrestrictするには:

  1. インポート/エクスポートタブをクリックします。
  2. カタログテンプレートCSVをダウンロードします。
  3. SKU/商品IDや制限された国を含む商品詳細でテンプレートを記入します。2桁のISOコードを縦線で区切って入力します(例:AU|KR|MY|SG)。すべての国をrestrictしたい場合は、単にALLを値として入力します。一つまたは数カ国を除いてすべての国をrestrictしたい場合は、ALL-の後に制限を解除したい国を縦線で区切って入力します(例:ALL-CA|FR|US)。CSVフォーマットについて詳しく学びます。既存の制限された国をすべて削除したい場合は、値としてNONEを入力します。
  4. ファイルをCSVとして保存し、CSVをダウンロードしたのと同じページで参照をクリックしてファイルを選択するか、ドラッグアンドドロップしてカタログにアップロードします。
  5. アップロードした商品をプレビューscreenで確認し、アップロードをクリックします。

制限された商品のフィルタリング:

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

CSVに変更を加えた後にカタログを更新する必要がある場合は、ファイルを再アップロードすると、一致する商品が更新されたバージョンに置き換えられます。これはSKUおよび/または商品IDを特定して一致させることによって行われます。

Checkoutを使用している場合、顧客の国に制限された商品があると、あなたのcheckoutに制限メッセージが表示されます。デフォルトでは、「このアイテムはあなたの国への輸入が制限されています」と表示されますが、国の制限を追加する際にrestrictedCountriesMessageフィールドに提供することで、自分自身の制限メッセージをカスタマイズすることができます。

商品をフィルタリングする

ダッシュボードまたはAPIを使用して、SKUまたは商品IDでカタログ内の商品を検索できます。正確な一致のみが結果を返すことに注意してください。部分一致は認識されません。

ダッシュボード
API

SKUまたは商品IDでフィルタリングするには:

  1. 商品タブをクリックします。
  2. カタログの左上隅でSKUまたは商品IDを選択します。
  3. SKUまたは商品IDを入力します。
  4. 適用をクリックして、フィルタリングされた商品を表示します。
SKUでフィルタリング

製品をエクスポートする

カタログテーブルから50個以下のアイテムを選択した場合、カタログはダッシュボードから直接ダウンロードされます。ただし、すべてをエクスポートまたは50個を超えるアイテムを選択した場合、CSVはメールでエクスポートされます。

50個以下のアイテムをエクスポートするには、次の手順に従ってください:

  1. カタログテーブルから50個以下のアイテムを直接選択します。
  2. 右上隅のエクスポートをクリックします。
  3. メールの受信トレイでCSVファイルを見つけます。

すべての製品をエクスポートするには:

ダッシュボード
API
  1. ダッシュボード -> 製品 -> カタログに移動します。
  2. 製品を追加の隣にあるカタログを管理のドロップダウンをクリックし、すべてをエクスポートをクリックします。
  3. ダウンロードにカタログファイルを見つけます。

メールからのダウンロードに問題がありますか?

メールリンクからCSVをダウンロードする際に問題が発生している場合、これはブラウザがダウンロードをブロックしている可能性があります。その場合は、以下の手順に従ってください:

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

Classify 商品を分類する

APIを使用して、ClassificationsCreateFromCatalog ミューテーションでカタログから商品をclassifyすることができます。

カタログから商品をclassifyするには、nameが必要です。完全なカタログおよび分類フィールドのリストについてはGraphQL APIリファレンスを参照してください。

カタログ商品を同時に作成し、classifyするには、以下のClassificationsCreateFromCatalogミューテーションをCatalogItemsCreate ミューテーションに追加してください。

Classify カタログ商品を8桁以上の(国別)HSコードに

shipToCountriesフィールドが入力されている場合、分類は8桁以上の(国別)HSコードになります。shipToCountriesが提供されていない場合、分類は6桁の(普遍的)HSコードにデフォルト設定されます普遍的および国別HSコードの違いについて詳しく学んでください。

以下の例では、カナダの国別コードを生成するためにshipToCountriesフィールドが提供されています。

ミューテーション

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

以下はリクエストの例です。Zonos Classify は name だけで分類を生成しますが最良の分類結果 を得るために、できるだけ多くの詳細を追加することを強くお勧めします。

変数

1
2
3
4
5
6
7
8
9
10
{
  "catalogItemToClassify": [
    {
      "catalogItemId": "catalog_item_893jkdkllg03k9khjd9",
      "configuration": {
        "shipToCountries": ["CA"]
      }
    }
  ]
}

応答

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
{
  "data": {
    "classificationsCreateFromCatalog": [
      {
        "id": "classification_8C49fk2945jmm232CcQtHtXdu",
        "configuration": {
          "shipToCountries": ["CA"]
        },
        "countryOfOrigin": "US",
        "hsCode": {
          "code": "6116.10.0020"
        },
        "name": "Cozy Design Women's Knitted Gloves with Roll Up Cuffs for Winter"
      }
    ]
  }
}

APIエラーと解決策

エラー解決策
SKUまたは製品IDが必要です。製品を作成するには識別子(SKU/製品ID)が必要です。カタログアイテムを作成、編集、または削除するには、SKUおよび/または製品IDを追加してください。
編集しようとしている製品は存在しません*存在しない製品を編集することはできません。これを解決するには、希望するSKUおよび/または製品IDで新しい製品を作成してください。
税関の説明は30文字の制限を超えています。デフォルトでは、税関の説明は30文字に制限されており、これは商業請求書の最も一般的な文字制限に一致します。
製品タイプが無効です。カタログは次の製品タイプをサポートしています: digital_good。物理的な商品については、空白のままにしてください。カタログは次の製品タイプのみをサポートしています: digital_goodphysical_good。製品が物理的な商品(最も一般的)である場合、このフィールドは空白のままにしてください。
梱包の好みが無効です。カタログは次の梱包の好みをサポートしています: ships_alone と consolidated。製品が他の製品と統合できる場合は、空白のままにしてください。梱包の好みが無効です。カタログは次の梱包の好みをサポートしています: ships_aloneconsolidated。製品が他の製品と統合できる場合、consolidated がデフォルトであるため、空白のままにできます。
HSコードを提供する際には国を指定する必要がありますアイテムを作成する際国別HSコードを提供する場合、送付先国が必要です。これを解決するには、送付先国を追加してください。
価格は0より大きくなければなりませんカタログは負の価格値をサポートしていません。これを解決するには、ゼロより大きい価格を追加してください。
価格値が提供される場合は通貨コードを提供する必要があります価格を提供する場合、通貨コードが必要です。これを解決するには、通貨コードを追加してください。
通貨コードが提供される場合は価格を提供する必要があります通貨コードを提供する場合、価格が必要です。これを解決するには、価格を追加してください。
付随する寸法フィールドは空白のままにすることはできません一つの寸法フィールドが提供される場合、他の二つが必要です。例えば、「幅が8インチ」と提供する場合、高さと長さが必要です。
測定値は0より大きくなければなりませんカタログは負のまたはゼロの測定値をサポートしていません。これを解決するには、ゼロより大きい値を追加してください。
寸法値を提供する際には、寸法単位を空白のままにすることはできません寸法値を提供する場合、寸法単位が必要です。これを解決するには、寸法単位を追加してください。
重量値を提供する際には、重量単位を空白のままにすることはできません重量値を提供する場合、重量単位が必要です。これを解決するには、重量単位を追加してください。

* APIエラーのみ

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