在庫数一括更新（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ファイル内にエラーが含まれている場合に、追加・変更・削除をどのように処理するかを設定できます。
＜チェックONの場合＞
エラーとなる行（商品）があった場合でも、エラーとならない行（商品）のみ処理を行うことができます。
ただし、スキップが適用されるのは 「商品の存在確認（商品が存在するか）」や「枝番照合（枝番が存在するか）」などの整合性チェックエラーのみ です。必須入力・文字数・書式などの入力エラーが1件でもある場合は、チェックONであっても全件の処理が中断されます。
＜チェックOFFの場合＞
1行（1商品）でもエラーがある場合、すべての商品の処理を行いません。
- 商品＞一括追加・変更の「商品」セクション内「在庫数」行の［ファイルを選択する］を押下します。
- 表示されたモーダル上で、CSVファイルをアップロードし、［アップロード］ボタンを押下します。
- アップロードのエラー・成功のステータス確認は、商品＞一括追加・変更履歴＞一括追加・変更履歴（CSV）をご覧ください。
先の手順［3］にて「エラー行スキップ」のチェックONに設定した際にエラーがある場合は、「完了（エラーあり）」と表示されます。
基本仕様について
基本的なCSV仕様・制限事項など
| 項目 | 仕様・制限事項など | 備考 |
|---|---|---|
| 文字コード | UTF-8（BOMあり） | |
| 区切り文字 | カンマ | |
| 改行コード | CRLF | |
| ヘッダ行 | 有 | |
| ファイル制限（容量） | 30MB | 超過する場合は、複数回に分けて登録してください。 |
| レコード数制限 | 50,000レコード（※ヘッダー除く） | 超過する場合は、複数回に分けて登録してください。 |
| 商品制限 | 5,000商品（※ヘッダー除く） | 超過する場合は、複数回に分けて登録してください。 |
| ファイル命名規則 | productStock_yyyyMMddHHmmss.csv | ファイル名は500文字以内にしてください。 |
| スキップモード | 商品＞一括追加・変更の「商品」セクション「在庫数」行にある 「エラー行スキップ」の設定でエラー行（商品）の登録・更新・削除の処理を設定できます。 ＜チェックONの場合＞ エラーとなる行（商品）があった場合でも、エラーとならない行（商品）のみ処理を行うことができます。 ※スキップ対象エラーは、「商品の存在確認（商品が存在するか）」や「枝番照合（枝番が存在するか）」などの整合性チェックのみ。必須や文字数などの入力エラーはスキップ対象外。。 ＜チェックOFFの場合＞ 1行（1商品）でもエラーがある場合、すべての商品の処理を行いません。 | 一括更新手順の手順［3］をご覧ください。 |
「標準CSV（従来項目版）」を利用中（「標準CSV」切替え前）の店舗様の場合
文字コードやファイル命名規則が異なります。こちら（モーダルが開きます）をご覧ください。
- ファイル名の命名規則は、必ず順守してください。
- 機種依存文字はご利用いただけません。
- お使いのPCがMacの場合、改行コードのエラーがでる場合があります。作成後のCSVファイルをテキストエディタなどで再度開き、改行コードを 「CR」から「CR+LF」に変更してください。
- 設定＞メール＞メール設定一覧＞商品データ一括登録完了メール設定で設定されたメールアドレスへ登録状況をお知らせするメールを送付できます。
一括更新手順の手順［3］にて「エラー行スキップ」のチェックONに設定した際にエラーがある場合は、「登録処理失敗」として通知され、エラー内容が添付されます。
CSV入力仕様
基本的な入力仕様について
各行の1列目「コントロールカラム」に入力する値に従って更新・削除が行われます。
CSV仕様表とあわせてご確認ください。
在庫数を更新する場合
コントロールカラムの入力
「空欄」 とします。
＜ご注意事項＞
他のCSVと異なり 「u」ではありません 。
必須 項目の入力
在庫の更新をする商品を「商品URLコード」で指定します。
「任意」項目の入力
- 値を入力すると、指定値で登録されます。
- 許容値欄をご参照ください。
- 「空欄」指定すると、基本的に既存の登録値のままとなります（更新されません）。
- 「-1」を指定すると、「在庫数切れメール閾値」のみ既存の登録値を解除（「空」にする）ことができます。
- 「調整在庫数」に「-1」指定すると、在庫数が1つ減算されますのでご注意ください。
在庫数を削除する場合
調整在庫数を「0」で更新する処理となります。
コントロールカラムの入力
「d」 を入力します。一度削除されたデータは、復元できません。
必須 項目の入力
在庫の更新をする商品を「商品URLコード」で指定します。
「任意」項目の入力
- 「調整在庫数」を「空欄」にすると、在庫数「0」で更新できます。
- 「-1」を指定すると、「在庫数切れメール閾値」のみ既存の登録値を解除（「空」にする）ことができます。
CSV仕様表
＜基本的なエラー＞
- CSVファイル内に同一「商品URLコード」が複数指定されている場合、エラー
- 同一「商品URLコード」のコントロールカラムで、「空欄」と「d」が混在している場合、エラー
- 指定された「商品URLコード」が存在しない場合、エラー
| 項目名 | 形式 | 文字数 | 許容値と 区分説明 |
コントロールカラム入力値別 制御仕様 | 補足・注意事項 | |||||
|---|---|---|---|---|---|---|---|---|---|---|
| 空欄（更新） ※「u」ではありません。 |
d（調整在庫数「0」で更新） | |||||||||
| 必須 | 更新しない（既定値のまま） | 削除する（「空」に更新） | 必須 | 更新しない（既定値のまま） | 削除する（「空」に更新） | |||||
| コントロールカラム | 半角英字 | 1 | 空欄：更新 d：削除 |
◯（空欄指定） | 空欄必須 | 空欄必須 | ◯ | d必須 | d必須 | ※基本的なエラー参照 |
| 商品URLコード | 32 | ◯ | 既定値入力 更新不可 |
削除（「空」更新）不可 | ◯ | 既定値入力 更新不可 |
削除（「空」更新）不可 | ※基本的なエラー参照 ※バリエーション商品の場合、エラー在庫数（バリエーション）一括更新（CSV仕様）を利用してください。 |
||
| 商品番号 | 文字列 | 32 | ー | ー | ー | ー | ー | ー | ー | アップロード時には利用しない項目 |
| 商品名 | 文字列 | 300 | ー | ー | ー | ー | ー | ー | ー | アップロード時には利用しない項目 |
| 現在在庫数 | 半角数字 | 9 | ー | ー | ー | ー | ー | ー | ー | アップロード時には利用しない項目 |
| 調整在庫数 | 半角数字 | 9 | 0~999999999 先頭に符号（-/+）あり可 |
空欄指定 | 削除（「空」更新）不可 ※在庫数「0」にする場合は「0」指定 |
既定値保持不可 ※必ず在庫数「0」で更新される |
削除（「空」更新）不可 ※必ず在庫数「0」で更新される |
- 在庫数増減時、-999999999～999999999の範囲外となる場合、エラー - 更新時の入力例 - 調整在庫数「0」に更新（在庫数削除）時の注意事項 ※本項目がエラーとなった場合、CSVファイル内の該当商品の行すべてをエラーとして処理しません。 |
||
| 在庫数切れメール閾値 | 半角数字 | 9 | 0~999999999 | 空欄指定 | -1指定 | 空欄指定 | -1指定 | |||
| 最終更新日時 | 文字列 | ー | ー | ー | ー | ー | ー | ー | ー | アップロード時には利用しない項目 |
更新時の入力例
コントロールカラム「空欄」を入力時に注意を要する項目です。
| 項目名 | 説明 |
|---|---|
| 調整在庫数 | 符号が入力されている場合は、現在の在庫数に加算・減算となります。 ＜入力例＞ - 在庫を追加する場合 ⇒ プラス(+)で追加数を入力 - 在庫を減らす場合 ⇒ マイナス(-)で減数を入力 - 在庫数を更新する場合 ⇒ 在庫数（整数）を入力 |
調整在庫数「0」に更新（在庫数削除）時の注意事項
コントロールカラム「d」を入力時に注意を要する項目です。
| 項目名 | 説明 |
|---|---|
| 調整在庫数 | 基本的に「空欄」にしてください。 ただし、入力値がある場合も無視され「0」にて更新されますのでご注意ください。 |