価格(バリエーション)一括更新(CSV仕様)
こちらは 「商品管理(upgrade版)」 ご利用店舗様用の新仕様(upgrade版)のCSVマニュアルになります。(「商品管理(upgrade版)」とは?)
商品メニューを利用する「商品管理(upgrade版)」で利用可能なCSVは、「標準CSV(従来項目版)」と「標準CSV」の2種類があります。
詳しくは、 商品CSVデータの仕様刷新と制限をご覧ください。
本マニュアルは、「商品管理(upgrade版)」ご利用時に標準となる 「標準CSV」 に関して解説しています。
「標準CSV(従来項目版)」を利用中(「標準CSV」切替え前)の場合は、各セクションの「標準CSV(従来項目版)」用のモーダルを開いてご確認ください。
<目次>
ご利用前の重要ご留意事項
登録済み商品バリエーションの「バリエーションごとの価格(バリエーション価格)」を一括更新できるファイルです。
- 事前に商品登録が必須です。CSVの場合は、商品一括登録を利用してください。
- 事前に、「バリエーション選択肢」や「バリエーション枝番号」の登録が必須です。CSVの場合は、バリエーション選択肢一括登録を利用してください。
- バリエーション商品の登録に利用するCSVファイルは、項目ごとに異なりますので、本ファイルと併せて以下をご利用ください。
- バリエーション枝番号の登録:バリエーション選択肢一括登録(前述の事前登録必須ファイル)
- 代表バリエーションやJANコードなどの登録:バリエーション詳細一括登録
- バリエーション価格の登録:価格(バリエーション)登録用ファイル(本ファイル)
- バリエーション在庫の登録:在庫数(バリエーション)一括登録
- 予約商品のバリエーションの場合は、一部利用するCSVファイルが異なります。
- 予約設定一括更新(CSV仕様)- ご利用前の重要ご留意事項をご覧ください。
一括更新手順
CSVのご利用は、以下の手順にておすすめください。
CSVの形式エラーをなくすために、まずはじめにCSVデータの編集時に注意することはありますか?をご覧ください。
- まず、商品>一括出力の「バリエーション」セクション内「価格(バリエーション)」行のプルダウンから、利用したいテンプレートを選択し[ファイル出力]を押下します。
- ダウンロードされたCSVファイルのヘッダー(1行目)の項目を元に、基本仕様・CSV入力仕様に従って必要な情報を入力し、アップロード用のCSVファイルを作成します。ファイル名は、末尾の「yyyyMMddHHmmss(年日時)」部分以外は変更しないでください。
- 商品>一括追加・変更の「バリエーション」セクション内「価格(バリエーション)」行の[ファイルを選択する]を押下します。
- 表示されたモーダル上で、CSVファイルをアップロードします。
- 本CSVは、ファイル形式やデータのエラーについて「事前チェック」が可能です。登録時のエラーを防ぐためにご活用ください。
「チェックする」のチェックをONにして[アップロード]ボタンを押下します。

- 事前チェックのエラー・成功のステータス確認は、商品>一括追加・変更履歴>一括追加・変更履歴(CSV)をご覧ください。
事前チェックの場合、「種類」欄に「事前チェック」と表示されます。
エラーの場合はエラー内容(ログ)がダウンロードできます。チェックしてエラーがなければ、「完了」と表示されます。

- 事前チェックに問題がなければ、手順[3][4]を再度行い、「チェックする」のチェックをOFFにし、[アップロード]ボタンを押下します。
- アップロードのエラー・成功のステータス確認は、商品>一括追加・変更履歴>一括追加・変更履歴(CSV)をご覧ください。
基本仕様について
基本的なCSV仕様・制限事項など
| 項目 | 仕様・制限事項など | 備考 |
|---|---|---|
| 文字コード | UTF-8(BOMあり) | |
| 区切り文字 | カンマ | |
| 改行コード | CRLF | |
| ヘッダ行 | 有 | |
| ファイル制限(容量) | 30MB | 超過する場合は、複数回に分けて登録してください。 |
| レコード数制限 | 50,000レコード(※ヘッダー除く) | 超過する場合は、複数回に分けて登録してください。 |
| 商品制限 | 1,000商品(※ヘッダー除く) | 超過する場合は、複数回に分けて登録してください。 |
| ファイル命名規則 | productVariationPrice_yyyyMMddHHmmss.csv | ファイル名は500文字以内にしてください。 |
| 事前チェック機能 | CSVファイルをアップロードするモーダル上で「事前チェックをする」の設定をONにします。 登録時のエラーを防ぐためにご活用ください。 | 一括更新手順の手順[5]をご覧ください。 |
「標準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タグ ※基本的なエラー参照 |
|
| バリエーション販売価格 | 半角数字 | 9 | 0~999999999 | 「空欄」指定 | -1指定 | ||
| 商品番号 | ー | ー | ー | ー | ー | ー | アップロード時には利用しない項目 |
| 商品管理番号 | ー | ー | ー | ー | ー | ー | アップロード時には利用しない項目 |
| 商品名 | ー | ー | ー | ー | ー | ー | アップロード時には利用しない項目 |
| JANコード | ー | ー | ー | ー | ー | ー | アップロード時には利用しない項目 |
| 最終更新日時 | ー | ー | ー | ー | ー | ー | アップロード時には利用しない項目 |
