一括登録更新 - 商品在庫
1. ファイルの概要
当サービスの管理に必要なデータは、サイドメニュー＞設定＞一括登録更新より、CSV ファイルで一括登録更新できます。
ここでは、商品の在庫情報を登録更新する CSV ファイルについてご紹介します。
2. ファイルの作成
商品の在庫情報を登録更新する CSV ファイルの作成方法をご紹介します。
作成方法
-
登録更新する CSV ファイルを作成するため、もととなる CSV ファイルをダウンロードします。
＜はじめて商品の在庫情報を登録する場合＞ （既存の商品在庫のレコードが 0 の場合）
【一括登録更新】ページにテンプレートファイルがあるので、「商品在庫」をダウンロードしてください。
＜既に商品の在庫情報が登録されている場合＞
商品一覧の「在庫ダウンロード」ボタンを押下してダウンロードしてください。
詳しい操作方法については、【商品一覧】 6. 在庫ダウンロード をご覧ください。
-
ダウンロードしたテンプレートファイルを、登録更新したい内容に修正します。
3. ファイルの仕様
商品の在庫情報を登録更新する CSV ファイルの仕様をご紹介します。
＊CSV のフォーマットはアップデート中です。最新版が必要な方は、お問い合わせいただければ提示させていただきます。
1. ファイル概要
CSV ファイルの概要をご紹介します。
| ファイル名 | 入力 / 出力 | 拡張子 | 文字コード | 囲み文字 | 区切り文字 | エスケープ文字 | 改行コード | ヘッダー有無 | 備考 |
|---|---|---|---|---|---|---|---|---|---|
| 任意のファイル名を指定してください。 | 入力 | .csv | UTF-8 BOM 付 | ダブルクォーテーション | , | ダブルクォーテーション | CRLF | あり | ー |
＜データの指定に関するルール＞
CSV ファイルをアップロードする際に、気を付けるべきルールが 2 点あります。
1. Null の設定方法とその扱い
・Null とは？: Null は「何もない状態」を意味します。データベースやプログラムで、値が存在しないことを示します。
・Null の設定方法: データの区切り文字（カンマ）の間に何も入力しないと、その部分は「Null」として扱われます。 例：,,
・Null の扱い: 既存のデータを更新する際に、Null が指定されている項目は、変更されず、元の値のまま残ります。
2. 空文字の設定方法
・空文字とは？: 空文字は「空の文字列」を意味します。つまり、値は存在するが、その中身が空であることを示します。
・空文字の設定方法: データの区切り文字（カンマ）の間をダブルクオーテーション（"）で囲むと、その部分は「空文字」として扱われます。 例：,"",
・空文字の扱い（新規登録）: CSV ファイルで空文字が指定されている項目は、そのまま空文字で登録されます。
・空文字の扱い（更新）: 空文字を指定して更新すると、既に登録済のデータは削除されます。
2. イメージ図
1 行目：ヘッダ領域
2 行目：データ領域
3. 項目定義
CSV ファイルの項目定義をご紹介します。
| 項目名 | データ型 | 項目長 | 新規登録時必須 | 更新時必須 | 形式 ※注釈参照 | 備考 |
|---|---|---|---|---|---|---|
| Index | 数値 | 6 | ○ | ○ | CSV ファイルの各レコードの先頭（商品番号の前）に、そのレコードが特定できる数値（1,2,3…）を指定してください。 | アップロードの際に、取込エラーとなるレコードがあった場合、Index を含めてエラーメッセージを表示します。 |
| 商品番号 | 文字列 | 100 | ○ | ○ | 任意の文字列（商品番号） | |
| 倉庫 ID | 数値 | 2 | ○ | ○ | 任意の数値 | 倉庫 ID は、店舗設定（倉庫）画面で確認できます。 ※左端に表示されている倉庫の番号です。  |
| 国内配送対象フラグ | 真偽値 | ○ | 「1」もしくは「0」を指定してください。 【国内配送対象フラグ】 1：対象 0：対象外 | |||
| 海外配送対象フラグ | 真偽値 | ○ | 「1」もしくは「0」を指定してください。 【海外配送対象フラグ】 1：対象 0：対象外 | |||
| 在庫数 | 数値 | 6 | ○ | 任意の数値 | ||
| 国内引当済数 | 数値 | 6 | ○ | 任意の数値 | ||
| 海外引当済数 | 数値 | 6 | ○ | 任意の数値 |
※注釈
実際には、記載の形式をダブルクォーテーションで囲って指定してください。
囲っている値にダブルクォーテーションが含まれている場合は、エスケープ処理を行った状態で指定してください。
4. 例
【一括登録更新】ページに、商品の在庫情報を登録更新する CSV ファイルのサンプルファイルを掲載しています。
CSV ファイル作成時にご参考ください。