平日10:00~17:00
06-6485-6485
fshop-AI(研修中) AIチャットを開く

商品グループ一括登録・更新・削除(CSV仕様)

商品グループ一括登録・更新・削除(CSV仕様)

こちらは 「商品管理(upgrade版)」 ご利用店舗様用の新仕様(upgrade版)のCSVマニュアルになります。「商品管理(upgrade版)」とは?

商品メニューを利用する「商品管理(upgrade版)」で利用可能なCSVは、「標準CSV(従来項目版)」と「標準CSV」の2種類があります。

詳しくは、 商品CSVデータの仕様刷新と制限をご覧ください。

本マニュアルは、「商品管理(upgrade版)」ご利用時に標準となる 「標準CSV」 に関して解説しています。

「標準CSV(従来項目版)」を利用中(「標準CSV」切替え前)の場合は、各セクションの「標準CSV(従来項目版)」用のモーダルを開いてご確認ください。


<目次>

ご利用前の重要ご留意事項

商品グループを一括で登録・更新・削除できるファイルです。

  • 本CSVでは、商品グループ情報の登録・更新・削除ができますが、「グループ名」「グループURLコード」「グループの階層」の変更はできません
    • 「グループ名」「グループURLコード」の削除は、商品グループ自体の削除となります。個別の削除はできません
  • 親グループに登録されている場合や、商品のメイングループに登録されている商品グループは削除できません
    削除したい場合は、状況に応じて以下のいずれかの方法をとってください。
    • 階層が下のグループ(子グループ)から順に削除してください。
    • 商品に設定されているグループを変更・削除し、メイングループ・サブグループに、該当グループが登録されていない状態にしてください。
  • サブグループとしてのみ使用中のグループは削除可能です。
  • 操作予定のグループの、上位階層の商品グループは既に登録されている、もしくは、同一CSVにて登録予定である必要があります(存在しない場合はエラーになります)。

一括更新手順

CSVのご利用は、以下の手順にておすすめください。

CSVの形式エラーをなくすために、まずはじめにCSVデータの編集時に注意することはありますか?をご覧ください。


  1. まず、登録したい項目をセットしたCSVテンプレートを、商品>一括出力>一括出力(テンプレート)にて設定します。(登録済みの場合は不要)

  2. 商品>一括出力の「商品グループ」セクション内「商品グループ一括」行のプルダウンから、利用したいテンプレートを選択し[ファイル出力]を押下します。

  3. ダウンロードされたCSVファイルのヘッダー(1行目)の項目を元に、基本仕様CSV入力仕様に従って必要な情報を入力し、アップロード用のCSVファイルを作成します。ファイル名は、末尾の「yyyyMMddHHmmss(年日時)」部分以外は変更しないでください

  4. 商品>一括追加・変更の「商品グループ」セクション内「商品グループ一括」行の[ファイルを選択する]を押下します。

  5. 表示されたモーダル上で、CSVファイルをアップロードし、[アップロード]ボタンを押下します。

  6. アップロードのエラー・成功のステータス確認は、商品>一括追加・変更履歴>一括追加・変更履歴(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」ではありません

必須 項目の入力

登録する値を入力します。

「任意」項目の入力
  • 値を入力すると、指定値で登録されます。
  • 「空欄」指定すると、基本的に「空」で登録されますが、一部の項目では「初期値」が登録されます。

更新する場合

すでに登録済みの項目値を削除(空)できる項目(「-1」指定可能項目)と、でできない項目がありますのでご注意ください。

コントロールカラムの入力

「空欄」 とします。

<ご注意事項>

他のCSVと異なり 「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コード」の商品グループ情報がメイングループの商品として既存データにある場合、エラー