バリエーション詳細更新(CSV仕様)
こちらは 「商品管理(upgrade版)」 ご利用店舗様用の新仕様(upgrade版)のCSVマニュアルになります。(「商品管理(upgrade版)」とは?)
商品メニューを利用する「商品管理(upgrade版)」で利用可能なCSVは、「標準CSV(従来項目版)」と「標準CSV」の2種類があります。
詳しくは、 商品CSVデータの仕様刷新と制限をご覧ください。
本マニュアルは、「商品管理(upgrade版)」ご利用時に標準となる 「標準CSV」 に関して解説しています。
「標準CSV(従来項目版)」を利用中(「標準CSV」切替え前)の場合は、各セクションの「標準CSV(従来項目版)」用のモーダルを開いてご確認ください。
<目次>
ご利用前の重要ご留意事項
登録済み商品バリエーションの「代表バリエーション」「在庫閾値」「在庫切れメール閾値」「JANコード」「商品リードタイム」「梱包重量」などを一括更新できるファイルです。
- 事前に商品登録が必須です。CSVの場合は、商品一括登録を利用してください。
- 事前に、「バリエーション選択肢」や「バリエーション枝番号」の登録が必須です。CSVの場合は、バリエーション選択肢一括登録を利用してください。
- バリエーション商品の登録に利用するCSVファイルは、項目ごとに異なりますので、本ファイルと併せて以下をご利用ください。
- バリエーション枝番号の登録:バリエーション選択肢一括登録(前述の事前登録必須ファイル)
- 代表バリエーションやJANコードなどの登録:バリエーション詳細一括登録(本ファイル)
- バリエーション価格の登録:価格(バリエーション)登録用ファイル
- バリエーション在庫の登録:在庫数(バリエーション)一括登録
- 予約商品のバリエーションの場合は、一部利用するCSVファイルが異なります。
- 予約設定一括更新(CSV仕様)- ご利用前の重要ご留意事項をご覧ください。
一括更新手順
CSVのご利用は、以下の手順にておすすめください。
CSVの形式エラーをなくすために、まずはじめにCSVデータの編集時に注意することはありますか?をご覧ください。
- まず、登録したい項目をセットしたCSVテンプレートを、商品>一括出力>一括出力(テンプレート)にて設定します。(登録済みの場合は不要)
- 商品>一括出力の「バリエーション」セクション内「バリエーション詳細」行のプルダウンから、利用したいテンプレートを選択し[ファイル出力]を押下します。
- ダウンロードされたCSVファイルのヘッダー(1行目)の項目を元に、基本仕様・CSV入力仕様に従って必要な情報を入力し、アップロード用のCSVファイルを作成します。ファイル名は、末尾の「yyyyMMddHHmmss(年日時)」部分以外は変更しないでください。
- 商品>一括追加・変更の「バリエーション」セクション内「バリエーション詳細」行の[ファイルを選択する]を押下します。
- 表示されたモーダル上で、CSVファイルをアップロードし、[アップロード]ボタンを押下します。
- アップロードのエラー・成功のステータス確認は、商品>一括追加・変更履歴>一括追加・変更履歴(CSV)をご覧ください。
基本仕様について
基本的なCSV仕様・制限事項など
| 項目 | 仕様・制限事項など | 備考 |
|---|---|---|
| 文字コード | UTF-8(BOMあり) | |
| 区切り文字 | カンマ | |
| 改行コード | CRLF | |
| ヘッダ行 | 有 | |
| ファイル制限(容量) | 30MB | 超過する場合は、複数回に分けて登録してください。 |
| レコード数制限 | 50,000レコード(※ヘッダー除く) | 超過する場合は、複数回に分けて登録してください。 |
| 商品制限 | 1,000商品(※ヘッダー除く) | 超過する場合は、複数回に分けて登録してください。 |
| ファイル命名規則 | productVariationDetail-{テンプレートコード}_yyyyMMddHHmmss.csv | <テンプレートコードとは> 商品>一括出力にてテンプレートを作成する際に、指定したコードです。 本コードをもって、登録項目を識別しますので、変更しないでください。 ※初期テンプレートには、本コードはありません。 ファイル名は500文字以内にしてください。 |
「標準CSV(従来項目版)」を利用中(「標準CSV」切替え前)の店舗様の場合
文字コードやファイル命名規則が異なります。こちら(モーダルが開きます)をご覧ください。
- ファイル名の命名規則は、必ず順守してください。
- 機種依存文字はご利用いただけません。
- お使いのPCがMacの場合、改行コードのエラーがでる場合があります。作成後のCSVファイルをテキストエディタなどで再度開き、改行コードを 「CR」から「CR+LF」に変更してください。
- 設定>メール>メール設定一覧>商品データ一括登録完了メール設定で設定されたメールアドレスへ登録状況をお知らせするメールを送付できます。
CSV入力仕様
CSV仕様表
※本CSVにはコントロールカラムはありません。
<基本的なエラー>
- 指定された「商品URLコード」が存在しない場合、エラー
- 指定された「商品URLコード」がバリエーション商品ではない(バリエーション軸が未登録の)場合、エラー
- CSVファイル内に、同じ組み合わせの「商品URLコード」と「バリエーション別枝番(横軸)」あるいは、「商品URLコード」と「バリエーション別枝番(縦軸)」が複数存在している場合、エラー
- 「バリエーション別枝番(横軸)」「バリエーション別枝番(縦軸)」がいずれも指定されていない場合、エラー
- 指定された「バリエーション別枝番(縦軸)」もしくは「バリエーション別枝番(横軸)」にバリエーション登録がない場合、エラー
<エラーとならないが更新されないケース>
- 実在しないバリエーション別枝番(横軸)(縦軸)の組合せの場合、エラーになりません。
- 「成功」ステータスとなりますが、入力値では更新されません。
- (例)両軸バリエーションであるのに、片軸のみの指定である など
- (例)両軸バリエーションであるが、入力されているバリエーション別枝番(横軸)(縦軸)の組み合わせが存在しない など
- バリエーション別枝番(横軸)(縦軸)は正しいが、在庫データがない(更新する情報がない)場合、エラーになりません。
- 「成功」ステータスとなりますが、入力値では更新されません。
| 項目名 | 形式 | 文字数 | 許容値と 区分説明 |
必須 | 更新しない (既定値のまま) |
削除する (「空」にする) |
補足・注意事項参照 |
|---|---|---|---|---|---|---|---|
| 商品URLコード | 32 | 〇 | 更新不可 既定値入力 |
削除不可 | ※基本的なエラー参照 | ||
| バリエーション別選択肢(横軸) | 文字列 | 100 | ー | ー | ー | ー | アップロード時には利用しない項目 |
| バリエーション別枝番(横軸) | 文字列 | 100 | ※補足・注意事項参照 | ※補足・注意事項参照 | 削除不可 | ※基本的なエラー参照 - 両軸バリエーション商品で片方しか枝番を入力していない場合 更新されず - 両軸バリエーション商品で枝番の組み合わせが存在しない場合 更新されず - 枝番は正しいが既存の在庫データがない場合 更新されず - 以下のフォーム関連のHTMLタグを含んでいる場合、エラー FORMタグ INPUTタグ TEXTAREAタグ SELECTタグ OPTIONタグ BUTTONタグ SCRIPTタグ |
|
| バリエーション別選択肢(縦軸) | 文字列 | 100 | ー | ー | ー | ー | アップロード時には利用しない項目 |
| バリエーション別枝番(縦軸) | 文字列 | 100 | ※補足・注意事項参照 | ※補足・注意事項参照 | 削除不可 | ※基本的なエラー参照 - 両軸バリエーション商品で片方しか枝番を入力していない場合 更新されず - 枝番は正しいが既存の在庫データがない場合 更新されず - 以下のフォーム関連のHTMLタグを含んでいる場合、エラー FORMタグ INPUTタグ TEXTAREAタグ SELECTタグ OPTIONタグ BUTTONタグ SCRIPTタグ |
|
| 代表バリエーション | 半角数字 | 1 | 1:代表バリエーション指定 | ※補足・注意事項参照 | 「空欄」指定 | 削除不可 | ※代表バリエーションとは? - CSVファイル内において、一つの「商品URLコード」に複数の「代表バリエーション」が指定されている場合、エラー - 既定値を含め、一つの「商品URLコード」に一つも「1:代表バリエーション指定」が指定されていない場合、最も小さいバリエーションNOのものを、自動的に代表バリエーションとする |
| 在庫閾値 | 半角数字 | 9 | 0~999999999 | 「空欄」指定 | -1指定 | ||
| 在庫切れメール閾値 | 半角数字 | 9 | 0~999999999 | 「空欄」指定 | -1指定 | ||
| 商品番号 | ー | ー | ー | ー | ー | ー | アップロード時には利用しない項目 |
| 商品管理番号 | ー | ー | ー | ー | ー | ー | アップロード時には利用しない項目 |
| 商品名 | ー | ー | ー | ー | ー | ー | アップロード時には利用しない項目 |
| JANコード | 文字列 | 30 | 「空欄」指定 | -1指定 | |||
| 商品リードタイム(★) | 半角数字 | 2 | ※補足・注意事項参照 | 「空欄」指定 | -1指定 | - 通常商品(バリエーションあり)の場合 「0~30」もしくは「-1」以外が指定されている場合、エラー - 定期・頒布会商品(バリエーションあり)の場合 「0~9」もしくは「-1」以外が指定されている場合、エラー |
|
| 梱包重量 | 半角数字 | 6 | 0~999999 | 「空欄」指定 | -1指定 | ||
| 最終更新日時 | ー | ー | ー | ー | ー | ー | アップロード時には利用しない項目 |
