商品のインポート
- Dashboard -> Products -> Catalog に移動します。
- 右上の Manage Catalog をクリックし、ドロップダウンから Import products を選択します。
- sample CSV template をクリックしてCatalog CSVテンプレートをダウンロードします。
- 商品詳細をZonos CSVテンプレートフィールドに合わせます。下記の表を使用し、最適なフィールドに正しい値と情報を使用していることを確認してください。
- 使用しないフィールド/列は空白のままにできます。削除しても構いませんが、必須ではありません。
- ファイルをCSVとして保存します。
- 新しいCSVファイルをCatalogにドラッグ&ドロップするか、browse をクリックしてファイルを選択・アップロードします。Catalogアップロードの最大ファイルサイズは50 MBです。
- プロンプトに従い、アップロードした商品を確認し、エラーがある場合はフィールドを修正します。
- Import をクリックします。
CSVフィールドの説明
| 列↕ | 説明↕ |
|---|---|
| SKU | 事業内で商品を識別するコード。例：GRLS-GRPHC-BBT-T-S |
| Product ID | 商品識別子。通常はeコマースプラットフォームのID。例：254678901 |
| Name | 商品名。例：Girls' graphic baby t-shirt |
| Description | 商品の完全な詳細説明。 |
| Customs description | 商業インボイス用の簡潔な商品説明。30文字制限。例：Girls' Shirt, 100% Polyester |
| Weight unit | 商品の重量単位。単位が指定されない場合、デフォルトは pound。有効な値：gram、kilogram、pound、ounce。 |
| Weight | 商品の重量。重量値は正の数である必要があります。 |
| Dimensional unit | 商品の寸法単位。単位が指定されない場合、デフォルトは inch。有効な値：inch、foot、yard、millimeter、centimeter、meter。 |
| Length | 商品の長さ。長さ値は正の数である必要があります。 |
| Width | 商品の幅。幅値は正の数である必要があります。 |
| Height | 商品の高さ。高さ値は正の数である必要があります。 |
| Packing preference | 商品が単独配送 ships_alone か、まとめ配送 consolidated か。他の商品とまとめて配送できる場合（最も一般的）、このフィールドは空白にできます。 |
| Restricted countries | 特定の国への商品配送を制限します。値は2桁ISOコードを縦棒で区切ります。すべての国を制限する場合は ALL。特定の国を除くすべてを制限する場合は ALL- の後に縦棒区切りで国を指定（例：ALL-CA|AU|US）。特定の国のみ制限する場合は縦棒区切りで国を指定（例：AU|KR|MY|SG）。既存の制限国をすべて削除する場合は NONE。 |
| Product type | 商品の性質を決定します。値：physical_good、digital_good、service、subscription、bundle、partial_item。physical good（最も一般的）の場合、このフィールドは空白にできます。 |
| Country of origin | 商品の製造国。値は2桁ISOコード。例：JP, GB, KR。 |
| Universal HS code | 商品のユニバーサル6桁HS code。例：9506.62 |
| Country-specific HS codes | 商品の国別HS code。複数ある場合は縦棒で区切ります。例：IT=6109.10.0010|DE=6109.10.0010|GB=6109.10.0010|JP=6109.10.020 |
| Image URL | 商品の画像URL。 |
| Material | 商品の主要素材または構成。例：Polyester |
| Brand | 商品のブランド。例：Nike |
| Price | 商品の販売価格。 |
| Retail price | 割引前の元の価格。販売価格と並べて表示すると、顧客への割引が強調されます。小売価格は基本価格（上記）より高い必要があります。 |
| Currency | 価格の通貨。値は3桁通貨コード。例：USD、CAD、AUD。 |
アルコール飲料事業者向け： Harmonized System Chapter 22（アルコール飲料）の商品を販売する場合、酒税計算に追加計測フィールドが必要です。酒税ドキュメントを参照し、これらの商品には専用CSVテンプレートを使用してください。
| 列↕ | 説明↕ |
|---|---|
| Volumetric unit | 体積の計量単位（アルコール飲料に必須）。有効な値：milliliter、liter、fluid_ounceなど。 |
| Volume | 商品の体積（アルコール飲料および酒税計算に必須）。 |
| Alcohol by volume | アルコール含有率（アルコール飲料に必須）。パーセンテージで入力。例：12% ABVの場合は12。 |
CSVインポートエラー
カタログ商品のインポート時にエラーが発生する場合があります。以下のリストはインポートエラーと解決方法を説明します。エラーを解決した後、CSVを再インポートできます。
インポートエラー
| エラー↕ | 説明↕ |
|---|---|
| File must be under 1 GB. | ファイルが大きすぎます。1 GB未満である必要があります。 |
| File must be in CSV format. | CatalogはCSV形式のみサポートします。ファイル形式がCSVであることを確認してください。 |
| Missing column header(s). | CatalogはCatalogテンプレートと完全に一致する形式のファイルのみサポートします。CSVヘッダーがCSVテンプレートのヘッダーと一致していることを確認してください。 |
| Unrecognized column header(s). | 認識できない列ヘッダーがあります。CatalogはCatalogテンプレートと完全に一致するヘッダーのみサポートします。認識できない列ヘッダーを削除し、CSVヘッダーがテンプレートと一致していることを再確認してください。 |
| You are missing a SKU or product ID. Ensure all of your products have a SKU or product ID. | SKU/product ID識別子はCatalog商品の作成に必須です。各商品にSKUまたはproduct IDを追加してください。 |
| Customs description exceeds character limit of 30 characters. | デフォルトでは、customs descriptionは30文字に制限され、商業インボイスの最も一般的な文字制限に合致します。 |
| Product type invalid. | 値：physical_good、digital_good、service、subscription、bundle、partial_item。 |
| 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）。 |
| Weight unit invalid. Catalog only supports the following weight units: gram, kilogram, pound, and ounce. | Catalogは以下の省略なし単位のみサポート：gram、kilogram、pound、ounce。 |
| Weight must be greater than zero and cannot include letters or symbols. | 重量値は記号や文字を含まない有効な正の数であることを確認してください。Catalogは小数点以下2桁までサポート（例：5.85）。 |
| Dimensional unit invalid. Catalog supports the following dimensional units: inch, foot, yard, millimeter, centimeter, and meter. | Catalogは以下の省略なし単位のみサポート：inch、foot、yard、millimeter、centimeter、meter。 |
| Length must be greater than zero and cannot include letters or symbols. | 長さは記号や文字を含まない有効な正の数であることを確認してください。Catalogは小数点以下2桁までサポート（例：5.29）。 |
| Width must be greater than zero and cannot include letters or symbols. | 幅は記号や文字を含まない有効な正の数であることを確認してください。Catalogは小数点以下2桁までサポート（例：2.44）。 |
| Height must be greater than zero and cannot include letters or symbols. | 高さは記号や文字を含まない有効な正の数であることを確認してください。Catalogは小数点以下2桁までサポート（例：8.02）。 |
| A weight unit is required when you provide a weight value. | 重量値がある商品には重量単位を指定してください。Catalogは gram、kilogram、pound、ounce をサポートします。 |
| A dimensional unit is required if you provide dimensional values. | 寸法値がある商品には寸法単位を指定してください。Catalogは inch、foot、yard、millimeter、centimeter、meter をサポートします。 |
| HS code must be between 6 and 16 characters. | HS codeは6〜16文字である必要があります。ユニバーサルHS codeは6桁、最長の国別HS codeは16桁です。 |
| Country-specific HS codes must be in the format of 'Country code=HS Code` | 国別HS codeは Country code=HS Code 形式（例：KR=8518.30.9000）。複数ある場合は縦棒で区切り（例：KR=8518.30.9000|CA=8518.30.9010）。 |
| [Country code] is not a valid country code. | 配送先国はISO形式（例：KR または BR）である必要があります。2桁ISO形式を確認してください。 |
| Country of origin values must be in ISO format. | 原産国は2桁ISO形式であることを確認してください。 |
| Price cannot include negative values, letters, or symbols. | 価格は正の有効な値であることを確認してください。Catalogは小数点以下3桁までサポート（例：104.399）。 |
| If you supply a price, a currency code is required. | 価格を指定する場合、通貨コードが必要です。 |
| Currency codes must be in ISO format, e.g., AUD or THB. | 通貨コードは3桁ISO形式であることを確認してください。 |
| If one dimensional field is provided, all three are required. | 寸法値がある商品には3つの寸法フィールドすべてを指定してください。 |
インポート失敗の例
Catalog CSVインポート
商品をCatalogに一括インポートします。Zonos Catalogの一括インポートにより、カタログ全体を一度にインポートできます。Catalog CSVテンプレートに記入する際、各商品に必須のフィールドはSKUまたはproduct IDのみです。SKUとproduct IDに基づき同一商品の重複がある場合、Catalogは初回に商品を作成し、関連する場合は重複商品の新規または追加情報で更新します。