予定在庫設定一括登録・更新・削除(CSV仕様)
こちらは 「商品管理(upgrade版)」 ご利用店舗様用の新仕様(upgrade版)のCSVマニュアルになります。(「商品管理(upgrade版)」とは?)
商品メニューを利用する「商品管理(upgrade版)」で利用可能なCSVは、「標準CSV(従来項目版)」と「標準CSV」の2種類があります。
詳しくは、 商品CSVデータの仕様刷新と制限をご覧ください。
本マニュアルは、「商品管理(upgrade版)」ご利用時に標準となる 「標準CSV」 に関して解説しています。
「標準CSV(従来項目版)」を利用中(「標準CSV」切替え前)の場合は、各セクションの「標準CSV(従来項目版)」用のモーダルを開いてご確認ください。
<目次>
ご利用前の重要ご留意事項
登録済みの商品の「予定在庫」の各種情報を一括で登録・更新・削除できるファイルです。
- 事前に商品登録が必須です。CSVの場合は、商品一括登録を利用してください。
- バリエーション商品の場合は、予定在庫数(バリエーション)一括更新(CSV仕様)を利用してください。
一括登録・更新・削除手順
CSVのご利用は、以下の手順にておすすめください。
CSVの形式エラーをなくすために、まずはじめにCSVデータの編集時に注意することはありますか?をご覧ください。
- まず、商品>一括出力の「予定在庫」セクション内「予定在庫設定」行の[ファイル出力]を押下し、CSV登録用ファイルをダウンロードします。
- ダウンロードされたCSVファイルのヘッダー(1行目)の項目を元に、基本仕様・CSV入力仕様に従って必要な情報を入力し、アップロード用のCSVファイルを作成します。ファイル名は、末尾の「yyyyMMddHHmmss(年日時)」部分以外は変更しないでください。
- 商品>一括追加・変更の「予定在庫」セクション内「予定在庫設定」行の[ファイルを選択する]を押下します。
- 表示されたモーダル上で、CSVファイルをアップロードし、[アップロード]ボタンを押下します。
- アップロードのエラー・成功のステータス確認は、商品>一括追加・変更履歴>一括追加・変更履歴(CSV)をご覧ください。
基本仕様について
基本的なCSV仕様・制限事項など
| 項目 | 仕様・制限事項など | 備考 |
|---|---|---|
| 文字コード | UTF-8(BOMあり) | |
| 区切り文字 | カンマ | |
| 改行コード | CRLF | |
| ヘッダ行 | 有 | |
| ファイル制限(容量) | 30MB | 超過する場合は、複数回に分けて登録してください。 |
| レコード数制限 | 50,000レコード(※ヘッダー除く) | 超過する場合は、複数回に分けて登録してください。 |
| 商品制限 | 5,000商品(※ヘッダー除く) | 超過する場合は、複数回に分けて登録してください。 |
| ファイル命名規則 | productPlanStockBasic_yyyyMMddHHmmss.csv | ファイル名は500文字以内にしてください。 |
「標準CSV(従来項目版)」を利用中(「標準CSV」切替え前)の店舗様の場合
文字コードやファイル命名規則が異なります。こちら(モーダルが開きます)をご覧ください。
- ファイル名の命名規則は、必ず順守してください。
- 機種依存文字はご利用いただけません。
- お使いのPCがMacの場合、改行コードのエラーがでる場合があります。作成後のCSVファイルをテキストエディタなどで再度開き、改行コードを 「CR」から「CR+LF」に変更してください。
- 設定>メール>メール設定一覧>商品データ一括登録完了メール設定で設定されたメールアドレスへ登録状況をお知らせするメールを送付できます。
CSV入力仕様
基本的な入力仕様について
各行の1列目「コントロールカラム」に入力する値に従って登録・更新・削除が行われます。
CSV仕様表とあわせてご確認ください。
新規登録(追加)する場合
コントロールカラムの入力
「空欄」 とします。
商品の「商品URLコード」と「入出荷予定日」で入力した日付が、未登録の(存在しない)場合に新規登録(追加)処理を行います。
<ご注意事項>
他のCSVと異なり 「n」ではありません 。
必須 項目の入力
「商品URLコード」と「入出荷予定日」の日付けで、新規登録(追加)処理を行うか、更新処理を行うかを決定しますので、入力値にご注意ください。
「任意」項目の入力
- 値を入力すると、指定値で登録されます。
- 許容値欄をご参照ください。
- 「空欄」指定すると、「初期値」が登録されます。
- コントロールカラム「空欄(新規登録)」-「空欄」指定欄をご覧ください。
在庫数を更新する場合
コントロールカラムの入力
「空欄」 とします。
商品の「商品URLコード」と「入出荷予定日」で入力した日付が、すでに登録済みの(存在する)場合に更新処理を行います。
<ご注意事項>
他のCSVと異なり 「u」ではありません 。
必須 項目の入力
「商品URLコード」と「入出荷予定日」の日付けで、新規登録(追加)処理を行うか、更新処理を行うかを決定しますので、入力値にご注意ください。
「任意」項目の入力
- 値を入力すると、指定値で登録されます。
- 許容値欄をご参照ください。
- 「空欄」指定すると、基本的に既存の登録値のままとなります(更新されません)。
- 「-1」を指定すると、既存の登録値を解除(「空」にする)ことができる項目が、一部あります。
- コントロールカラム「空欄(更新)」-「削除する(「空」にする)欄をご覧ください。
削除する場合
「予定在庫」の登録自体の削除となります。
予定在庫数を「0」にするなどの、項目設定値の削除ではありません。
コントロールカラムの入力
「d」 を入力します。一度削除されたデータは、復元できません。
必須 項目の入力
既定値を入力します。
「任意」項目の入力
「予定在庫」の登録自体が削除となるので、入力の必要はありません。
CSV仕様表
<基本的なエラー>
- 同一「商品URLコード」のコントロールカラムで、「空欄」「d」が混在している場合、エラー
- 指定された「商品URLコード」が存在しない場合、エラー
- 1商品あたり予定在庫の登録数は最大10件まで。
| 項目名 | 形式 | 文字数 | 許容値と 区分説明 |
コントロールカラム入力値別 制御仕様 | 補足・注意事項 | |||||
|---|---|---|---|---|---|---|---|---|---|---|
| 空欄(新規登録) ※「n」ではありません。 |
空欄(更新) ※「u」ではありません。 |
d(削除) | ||||||||
| 必須 | 「空欄」指定 | 必須 | 更新しない(既定値のまま) | 削除する(「空」にする) | 必須 | |||||
| コントロールカラム | 半角英字 | 1 | 空欄:登録 or 更新 d:削除 |
◯(空欄指定) | 空欄必須 | ◯(空欄指定) | 空欄必須 | 空欄必須 | 〇 | - 【重要】コントロールカラム「空欄」指定時の注意事項 ※基本的なエラー参照 |
| 商品URLコード | 32 | 〇 | 空欄指定不可 | 〇 | 既定値入力 更新不可 |
削除(「空」更新)不可 | 〇 | ※基本的なエラー参照 - 同一「商品URLコード」「入出荷予定日」の組み合わせがCSVファイル内に存在している場合、エラー - 「商品URLコード」「入出荷予定日」に基づき、データ更新後に「予定在庫」の登録数が10を超える場合、エラー |
||
| 商品名 | ー | ー | ー | ー | ー | ー | ー | ー | ー | アップロードには使用しない項目 |
| 入出荷予定日 | 半角数字 | 8 | [YYYYMMDDhh:mm] | 〇 | 空欄指定不可 | 〇 | 既定値入力 更新不可 |
削除(「空」更新)不可 | 〇 | - 新規登録・更新の場合 指定された「入出荷予定日」が、対象商品の「予約受付期間終了」より前の日付を指定している場合、エラー - 削除の場合 「商品URLコード」に基づき、指定された入出荷予定日の予定在庫が存在しない場合、エラー |
| 入出荷予定日(表記名) | 文字列 | 50 | 〇 | 空欄指定不可 | 〇 | 既定値入力 | 削除(「空」更新)不可 | |||
| 予定在庫設定フラグ | 半角数字 | 1 | 0:利用しない 1:利用する |
「0:利用しない」で登録 | 空欄指定 | 削除(「空」更新)不可 | ||||
| 入出荷予定日表示フラグ | 半角数字 | 1 | 0:商品詳細ページに表示しない 1:商品詳細ページに表示する |
「1:商品詳細ページに表示する」で登録 | 空欄指定 | 削除(「空」更新)不可 | ||||
| 予定在庫数 | ー | ー | ー | ー | ー | ー | ー | ー | ー | アップロードには使用しない項目 |
| 調整予定在庫数 | 半角数字 | 9 | 0~999999999 先頭に符号(-/+)あり可 |
「0」で登録 | 空欄指定 | 削除(「空」更新)不可 ※在庫数「0」にする場合は「0」指定 |
- 調整後の数値が「-999999999~999999999」の範囲内でない場合、エラー - 新規登録・更新時の入力例 |
|||
| 予定在庫僅少表示閾値 | 半角数字 | 9 | 0~999999999 | 「空」で登録 | 空欄指定 | -1指定 | ||||
| 予定在庫切れメール閾値 | 半角数字 | 9 | 0~999999999 | 「空」で登録 | 空欄指定 | -1指定 | ||||
| 登録日付 | ー | ー | ー | ー | ー | ー | ー | ー | ー | アップロードには使用しない項目 |
| 最終更新日時 | ー | ー | ー | ー | ー | ー | ー | ー | ー | アップロードには使用しない項目 |
コントロールカラム「空欄」指定時の注意事項
商品の「商品URLコード」と「入出荷予定日」で入力した日付により、新規登録(追加)処理を行うか、更新処理を行うかを決定します。
「入出荷予定日」の入力した日付が、未登録の(存在しない)場合
新規登録処理となります。
「入出荷予定日」の入力した日付が、すでに登録済みの(存在する)場合
更新処理となります。
新規登録・更新時の入力例
| 項目名 | 説明 |
|---|---|
| 調整予定在庫数 | 符号が入力されている場合は、現在の在庫数に加算・減算となります。 <入力例> - 在庫を追加する場合 ⇒ プラス(+)で追加数を入力 - 在庫を減らす場合 ⇒ マイナス(-)で減数を入力 - 在庫数を更新する場合 ⇒ 在庫数(整数)を入力 |
