DOCS

製品を管理する

カタログを管理する

製品を作成および修正する。

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

製品を作成する

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

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

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

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

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

製品の編集

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

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のHSコードが6109.10であった場合、更新された製品SKU 456のHSコードが空白であれば、既存のHSコードはそのまま残ります。

製品を編集するには:

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

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

商品を削除する

商品を削除するには:

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

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

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

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

Restrict 商品を制限する

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

カタログで単一の商品を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。既存の制限された国をすべて削除したい場合は、値としてNONEを入力します。
  4. ファイルをCSVとして保存し、CSVをダウンロードしたのと同じページで参照をクリックしてファイルを選択するか、ドラッグアンドドロップしてカタログにアップロードします。
  5. プレビューscreenでアップロードした商品を確認し、アップロードをクリックします。

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

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

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

Checkoutを使用している場合、顧客の国に制限されている商品については、あなたのcheckoutに制限メッセージが表示されます。デフォルトでは、メッセージは「このアイテムはあなたの国への輸入が制限されています。」と表示されます。

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

SKU、商品ID、または商品名を使用して、ダッシュボードまたはAPIを通じてカタログ内の商品を検索できます。SKUおよび商品IDの検索では、正確な一致のみが結果を返します。部分一致はサポートされていません。ただし、商品名で検索する場合は、部分一致がサポートされています。

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

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

商品名を検索するには:

  1. ダッシュボードの商品タブをクリックします。
  2. カタログの右上で、検索フィールドに商品名を入力します。
  3. フィルタリングされた商品を表示します。

製品をエクスポートする

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

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

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

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

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

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

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

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

Classify 商品を分類する

APIを使用して、ClassificationsCreateFromCatalogミューテーションでcatalogItemIdを使ってカタログから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エラーのみ

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