商品グループ一括登録・更新・削除(CSV仕様)
こちらは 「商品管理(upgrade版)」 ご利用店舗様用の新仕様(upgrade版)のCSVマニュアルになります。(「商品管理(upgrade版)」とは?)
商品メニューを利用する「商品管理(upgrade版)」で利用可能なCSVは、「標準CSV(従来項目版)」と「標準CSV」の2種類があります。
詳しくは、 商品CSVデータの仕様刷新と制限をご覧ください。
本マニュアルは、「商品管理(upgrade版)」ご利用時に標準となる 「標準CSV」 に関して解説しています。
「標準CSV(従来項目版)」を利用中(「標準CSV」切替え前)の場合は、各セクションの「標準CSV(従来項目版)」用のモーダルを開いてご確認ください。
<目次>
ご利用前の重要ご留意事項
商品グループを一括で登録・更新・削除できるファイルです。
- 本CSVでは、商品グループ情報の登録・更新・削除ができますが、「グループ名」「グループURLコード」「グループの階層」の変更はできません。
- 「グループ名」「グループURLコード」の削除は、商品グループ自体の削除となります。個別の削除はできません。
- 親グループに登録されている場合や、商品のメイングループに登録されている商品グループは削除できません。
削除したい場合は、状況に応じて以下のいずれかの方法をとってください。- 階層が下のグループ(子グループ)から順に削除してください。
- 商品に設定されているグループを変更・削除し、メイングループ・サブグループに、該当グループが登録されていない状態にしてください。
- サブグループとしてのみ使用中のグループは削除可能です。
- 操作予定のグループの、上位階層の商品グループは既に登録されている、もしくは、同一CSVにて登録予定である必要があります(存在しない場合はエラーになります)。
一括更新手順
CSVのご利用は、以下の手順にておすすめください。
CSVの形式エラーをなくすために、まずはじめにCSVデータの編集時に注意することはありますか?をご覧ください。
- まず、登録したい項目をセットしたCSVテンプレートを、商品>一括出力>一括出力(テンプレート)にて設定します。(登録済みの場合は不要)
- 商品>一括出力の「商品グループ」セクション内「商品グループ一括」行のプルダウンから、利用したいテンプレートを選択し[ファイル出力]を押下します。
- ダウンロードされたCSVファイルのヘッダー(1行目)の項目を元に、基本仕様・CSV入力仕様に従って必要な情報を入力し、アップロード用のCSVファイルを作成します。ファイル名は、末尾の「yyyyMMddHHmmss(年日時)」部分以外は変更しないでください。
- 商品>一括追加・変更の「商品グループ」セクション内「商品グループ一括」行の[ファイルを選択する]を押下します。
- 表示されたモーダル上で、CSVファイルをアップロードし、[アップロード]ボタンを押下します。
- アップロードのエラー・成功のステータス確認は、商品>一括追加・変更履歴>一括追加・変更履歴(CSV)をご覧ください。
基本仕様について
基本的なCSV仕様・制限事項など
| 項目 | 仕様・制限事項など | 備考 |
|---|---|---|
| 文字コード | UTF-8(BOMあり) | |
| 区切り文字 | カンマ | |
| 改行コード | CRLF | |
| ヘッダ行 | 有 | |
| ファイル制限(容量) | 30MB | 超過する場合は、複数回に分けて登録してください。 |
| レコード数制限 | 5,000レコード(※ヘッダー除く) | 超過する場合は、複数回に分けて登録してください。 |
| 商品制限 | ー | |
| ファイル命名規則 | categoryBasic-{テンプレートコード}_yyyyMMddHHmmss.csv | <テンプレートコードとは> 商品>一括出力にてテンプレートを作成する際に、指定したコードです。 本コードをもって、登録項目を識別しますので、変更しないでください。 ※初期テンプレートには、本コードはありません。 ファイル名は500文字以内にしてください。 |
「標準CSV(従来項目版)」を利用中(「標準CSV」切替え前)の店舗様の場合
文字コードやファイル命名規則が異なります。こちら(モーダルが開きます)をご覧ください。
- ファイル名の命名規則は、必ず順守してください。
- 機種依存文字はご利用いただけません。
- お使いのPCがMacの場合、改行コードのエラーがでる場合があります。作成後のCSVファイルをテキストエディタなどで再度開き、改行コードを 「CR」から「CR+LF」に変更してください。
- 設定>メール>メール設定一覧>商品データ一括登録完了メール設定で設定されたメールアドレスへ登録状況をお知らせするメールを送付できます。
CSV入力仕様
基本的な入力仕様について
各行の1列目「コントロールカラム」に入力する値に従って更新・削除が行われます。
CSV仕様表とあわせてご確認ください。
新規登録(追加)する場合
コントロールカラムの入力
「空欄」 とします。
<ご注意事項>
他のCSVと異なり 「n」ではありません 。
必須 項目の入力
登録する値を入力します。
「任意」項目の入力
- 値を入力すると、指定値で登録されます。
- 許容値欄をご参照ください。
- 「空欄」指定すると、基本的に「空」で登録されますが、一部の項目では「初期値」が登録されます。
- コントロールカラム「n」-「空欄」設定時欄をご覧ください。
- 一部の項目では、「空欄」指定不可です。
更新する場合
すでに登録済みの項目値を削除(空)できる項目(「-1」指定可能項目)と、でできない項目がありますのでご注意ください。
コントロールカラムの入力
「空欄」 とします。
<ご注意事項>
他のCSVと異なり 「u」ではありません 。
必須 項目の入力
既定値入力を入力します。
入力された値により、いずれのデータを更新するかを判定します。
「任意」項目の入力
- 値を入力すると、指定値で登録されます。
- 許容値欄をご参照ください。
- 「空欄」指定すると、基本的に既存の登録値のままとなります(更新されません)。
- 一部の項目では、「空欄」指定不可です。
- 「-1」を指定すると、既存の登録値を解除(「空」にする)ことができる項目が、一部あります。
- コントロールカラム「u」-「設定解除(-1)」設定時欄をご覧ください。
削除する場合
「商品グループ」の登録自体の削除となります。
グループ内の、特定の項目設定値の削除ではありません。
コントロールカラムの入力
「d」 を入力します。一度削除されたデータは、復元できません。
必須 項目の入力
既定値を入力します。
「任意」項目の入力
「商品グループ」の登録自体が削除となるので、入力の必要はありません。
CSV仕様表
<基本的なエラー>
- CSVファイル内において、コントロールカラム(「空欄」「d」)が混在している場合、エラー
- 「グループURLコード」の指定がない場合は、システムが自動的に発番します。発番の形式は、「gr+数字連番」となります。
- エラーを避けるため、CSVに入力する場合は、「gr+数字」は指定しないてください。
- 商品グループ名には「
<br>」を利用できます。それ以外のタグ、「/(半角スラッシュ)」は利用不可です。 - 「グループURLコード」は重複できません。
- 同じ階層でグループ名の重複はできません。同じ階層でグループ名が同じ場合は1グループとなります。
「標準CSV(従来項目版)」を利用中(「標準CSV」切替え前)の店舗様の場合
CSV項目についてはこちら(モーダルが開きます)をご覧ください。
| 項目名 | 形式 | 文字数 | 許容値と 区分説明 |
コントロールカラム入力値別 制御仕様 | 補足・注意事項 | |||||
|---|---|---|---|---|---|---|---|---|---|---|
| 空欄(新規登録) ※「n」ではありません。 |
空欄(更新) ※「u」ではありません。 |
d(削除) | ||||||||
| 必須 | 「空欄」指定 | 必須 | 更新しない (既定値のまま) |
削除する(「空」に更新) | 必須 | |||||
| コントロールカラム | 半角英字 | 1 | 空欄:登録 or 更新 d:削除 |
◯(空欄指定) | 空欄必須 | ◯(空欄指定) | 空欄必須 | 〇 | ※基本的なエラー参照 - 商品グループデータが存在しない場合 新規登録として処理 - 商品グループデータが存在する場合 更新として処理 |
|
| 第1階層グループ名 | 文字列 | 80 | 〇 | 「空欄」指定不可 | 〇 | 既定値入力 | 削除(「空」更新)不可 | 〇 | - htmlタグの「開始タグ(<)」、あるいは「終了タグ(>)」が不足している場合、エラー - <br>以外のhtmlタグが入力されている場合、エラー - 「/ 」が設定されている場合、エラー - 「第1階層グループ名~第5階層グループ名」において、同一の組合せがCSVファイル内に存在している場合、エラー |
|
| 第2階層グループ名 | 文字列 | 80 | ※補足・注意事項参照 | 「空」で登録 | ※補足・注意事項参照 | 既定値入力 | 削除(「空」更新)不可 | - htmlタグの「開始タグ(<)」、あるいは「終了タグ(>)」が不足している場合、エラー - <br>以外のhtmlタグが入力されている場合、エラー - 「/ 」が設定されている場合、エラー - 第3階層グループ名が設定されている場合 値が設定されていない場合、エラー - 「第1階層グループ名~第5階層グループ名」において、同一の組合せがCSVファイル内に存在している場合、エラー - 新規登録時の注意事項 |
||
| 第3階層グループ名 | 文字列 | 80 | ※補足・注意事項参照 | 「空」で登録 | ※補足・注意事項参照 | 既定値入力 | 削除(「空」更新)不可 | - htmlタグの「開始タグ(<)」、あるいは「終了タグ(>)」が不足している場合、エラー - <br>以外のhtmlタグが入力されている場合、エラー - 「/ 」が設定されている場合、エラー - 第4階層グループ名が設定されている場合 値が設定されていない場合、エラー - 「第1階層グループ名~第5階層グループ名」において、同一の組合せがCSVファイル内に存在している場合、エラー - 新規登録時の注意事項 |
||
| 第4階層グループ名 | 文字列 | 80 | ※補足・注意事項参照 | 「空」で登録 | ※補足・注意事項参照 | 既定値入力 | 削除(「空」更新)不可 | - htmlタグの「開始タグ(<)」、あるいは「終了タグ(>)」が不足している場合、エラー - <br>以外のhtmlタグが入力されている場合、エラー - 「/ 」が設定されている場合、エラー - 第5階層グループ名が設定されている場合 値が設定されていない場合、エラー - 「第1階層グループ名~第5階層グループ名」において、同一の組合せがCSVファイル内に存在している場合、エラー - 新規登録時の注意事項 |
||
| 第5階層グループ名 | 文字列 | 80 | 「空」で登録 | 既定値入力 | 削除(「空」更新)不可 | - htmlタグの「開始タグ(<)」、あるいは「終了タグ(>)」が不足している場合、エラー - <br>以外のhtmlタグが入力されている場合、エラー - 「/ 」が設定されている場合、エラー - 新規登録時の注意事項 |
||||
| グループURLコード | 半角文字列 | 2~32 | 指定がない場合は「gr + 自動採番される数値」でシステムが自動発番 ※指定時には、「gr+数値」入力不可 |
既定値入力 | 削除(「空」更新)不可 | ◯ | ※基本的なエラー参照 - 同一グループURLコードがCSVファイル内に存在している場合、エラー - 新規登録・更新の場合 親グループに所属する商品の「商品URLコード」と同じ文字列がある場合、エラー - 新規登録の場合 すでに登録済みの場合、エラー - 更新の場合 存在しない場合、エラー - 削除時の注意事項 |
|||
| 表示順位 | 半角数字 | 9 | 0~999999999 | 「999999999」で登録 | 空欄指定 | 削除(「空」更新)不可 | ||||
| ステータス | 半角数字 | 1 | 0:公開 1:非公開 |
「公開(0)」で登録 | 空欄指定 | 削除(「空」更新)不可 | ||||
| 表示区分(商品グループ) | 半角数字 | 1 | 0:登録の遅い順(新着順) 1:登録の早い順 2:表示順 |
「02」で登録 | 空欄指定 | 削除(「空」更新)不可 | ||||
| 表示区分(商品) | 半角数字 | 1 | 0:登録の遅い順(新着順) 1:登録の早い順 2:価格の安い順 3:価格の高い順 4:優先度 |
「02」で登録 | 空欄指定 | 削除(「空」更新)不可 | ||||
| レコメンドカテゴリID | 半角数字 | 2 | レコメンドのカテゴリID(1〜20) | 「空」で登録 | 空欄指定 | -1指定 | - 新規登録・更新の場合 指定された「レコメンドカテゴリID」が存在しない場合、エラー |
|||
| 闇市グループパスワード | 半角英数字 | 20 | 「空」で登録 | 空欄指定 | -1指定 | - 新規登録時の注意事項 - 更新時の注意事項 |
||||
| レイアウト割当名 | 文字列 | 100 | 「空」で登録 | 空欄指定 | -1指定 | - 新規登録・更新の場合 指定された「レイアウト割当名」が存在しない場合、エラー |
||||
| ページ名(コマースクリエイター) | 文字列 | 100 | 「空」で登録 | 空欄指定 | -1指定 | |||||
| ページ名表示方法(コマースクリエイター) | 半角数字 | 1 | 0:ページ設定 1:所属グループ設定を継承 2:個別設定 |
「ページ設定(0)」で登録 | 空欄指定 | 削除(「空」更新)不可 | - 「第2階層グループ名~第5階層グループ名」が未設定の場合 「1」指定の場合、エラー - 更新時の注意事項 |
|||
| キーワード(コマースクリエイター) | 文字列 | 500 | 「空」で登録 | 空欄指定 | -1指定 | |||||
| キーワード表示方法(コマースクリエイター) | 半角数字 | 1 | 0:ページ設定を採用 1:所属グループのものを継承 2:個別設定採用 |
「ページ設定(0)」で登録 | 空欄指定 | 削除(「空」更新)不可 | - 「第2階層グループ名~第5階層グループ名」が未設定の場合 「1」指定の場合、エラー - 更新時の注意事項 |
|||
| Description(コマースクリエイター) | 文字列 | 250 | 「空」で登録 | 空欄指定 | -1指定 | |||||
| Description表示方法(コマースクリエイター) | 半角数字 | 1 | 0:ページ設定 1:所属グループ設定を継承 2:個別設定 |
「ページ設定(0)」で登録 | 空欄指定 | 削除(「空」更新)不可 | - 「第2階層グループ名~第5階層グループ名」が未設定の場合 「1」指定の場合、エラー - 更新時の注意事項 |
|||
| 商品グループコメント | 文字列 | 16000 | 「空」で登録 | 空欄指定 | -1指定 | - htmlタグの「開始タグ(<)」、あるいは「終了タグ(>)」が不足している場合、エラー | ||||
| 独自コメント(1) | 文字列 | 32000 | 「空」で登録 | 空欄指定 | -1指定 | |||||
| 独自コメント(2) | 文字列 | 32000 | 「空」で登録 | 空欄指定 | -1指定 | |||||
| 独自コメント(3) | 文字列 | 32000 | 「空」で登録 | 空欄指定 | -1指定 | |||||
| 独自コメント(4) | 文字列 | 32000 | 「空」で登録 | 空欄指定 | -1指定 | |||||
| 独自コメント(5) | 文字列 | 32000 | 「空」で登録 | 空欄指定 | -1指定 | |||||
| 独自コメント(6) | 文字列 | 32000 | 「空」で登録 | 空欄指定 | -1指定 | |||||
| 独自コメント(7) | 文字列 | 32000 | 「空」で登録 | 空欄指定 | -1指定 | |||||
| 独自コメント(8) | 文字列 | 32000 | 「空」で登録 | 空欄指定 | -1指定 | |||||
| 独自コメント(9) | 文字列 | 32000 | 「空」で登録 | 空欄指定 | -1指定 | |||||
| 独自コメント(10) | 文字列 | 32000 | 「空」で登録 | 空欄指定 | -1指定 | |||||
| 画像ALT | 文字列 | 100 | 空欄指定 ※補足・注意事項参照 |
空欄指定 ※補足・注意事項参照 |
-「画像削除フラグ」が「空欄」の場合 ⇒ 更新しない - 「画像削除フラグ」が「Delete」の場合 ⇒ 「空」で更新 |
削除(「空」更新)不可 | - 新規登録の場合 値が設定されている場合、エラー |
|||
| 画像削除フラグ | 半角文字列 | 6 | 空白:処理を行わない delete:画像を消す |
空欄指定 ※補足・注意事項参照 |
空欄指定 ※補足・注意事項参照 |
空欄指定 | delete | - 新規登録の場合 値が設定されている場合、エラー - 更新の場合 「delete」指定時、画像未登録の場合、エラー |
||
| 登録日時 | ー | ー | ー | ー | ー | ー | ー | ー | ー | アップロード時には利用しない項目 |
| 最終更新日時 | ー | ー | ー | ー | ー | ー | ー | ー | ー | アップロード時には利用しない項目 |
【新規登録時の注意事項】特定項目の補足
※表内の「補足・注意事項」欄に入りきらない補足を記載しています(特定項目のみ)。必ず表とあわせてご確認ください。
コントロールカラム【空欄(新規登録)】時に注意を要する項目です。
| 項目名 | 説明 |
|---|---|
| 第2階層グループ名 | 「第1階層グループ名」が既存データに存在しない、もしくは同一CSVファイル内で登録されていない場合、エラー |
| 第3階層グループ名 | 「第1階層グループ名~第2階層グループ名」が既存データに存在しない、もしくは同一CSVファイル内で登録されていない場合、エラー |
| 第4階層グループ名 | 「第1階層グループ名~第3階層グループ名」が既存データに存在しない、もしくは同一CSVファイル内で登録されていない場合、エラー |
| 第5階層グループ名 | 「第1階層グループ名~第4階層グループ名」が既存データに存在しない、もしくは同一CSVファイル内で登録されていない場合、エラー |
| 闇市グループパスワード | 「闇市グループパスワード」が設定されていない場合、親グループが「闇市グループパスワードが設定されているグループ」の場合、エラー |
【更新時の注意事項】特定項目の補足
※表内の「補足・注意事項」欄に入りきらない補足を記載しています(特定項目のみ)。必ず表とあわせてご確認ください。
コントロールカラム【空欄(更新)】を時に注意を要する項目です。
| 項目名 | 説明 |
|---|---|
| 闇市グループパスワード | - 子グループに「闇市グループパスワードが設定されていないグループ」が1つ以上ある場合、エラー - グループに所属している商品にサブグループが設定されている場合、エラー |
| ページ名表示方法(コマースクリエイター) | 「ページ名(コマースクリエイター)」に「設定解除(-1)」を設定する場合、「0:ページ設定」以外(空欄指定を含む)を指定すると、エラー |
| キーワード表示方法(コマースクリエイター) | 「キーワード(コマースクリエイター)」に「設定解除(-1)」を設定する場合、「0:ページ設定」以外(空欄指定を含む)を指定すると、エラー |
| Description表示方法(コマースクリエイター) | 「Description表示方法(コマースクリエイター)」に「設定解除(-1)」を設定する場合、「0:ページ設定」以外(空欄指定を含む)を指定すると、エラー |
【削除時の注意事項】特定項目の補足
※表内の「補足・注意事項」欄に入りきらない補足を記載しています(特定項目のみ)。必ず表とあわせてご確認ください。
コントロールカラム【d】を入力時に注意を要する項目です。
| 項目名 | 説明 |
|---|---|
| グループURLコード | - 「グループURLコード」「第1階層グループ名~第5階層グループ名」のグループ情報が既存データにない場合、エラー - 指定された「グループURLコード」の商品グループ情報が親グループとして既存データにある場合、もしくは同一CSVファイル内で削除処理が行われていない場合、エラー - 指定された「グループURLコード」の商品グループ情報がメイングループの商品として既存データにある場合、エラー |
