一括登録更新 - 得意先別単価
1. フ ァイルの概要
当サービスの管理に必要なデータは、サイドメニュー＞設定＞一括登録更新より、CSV ファイルで一括登録更新できます。
ここでは、商品の得意先別単価を登録更新する CSV ファイルについてご紹介します。
＊得意先別単価は、店舗設定にある単価設定が「得意先別単価」の場合にのみご利用いただけます。
単価設定については、【店舗設定-商品】をご覧ください。
2. ファイルの作成
商品の得意先別単価を登録更新する CSV ファイルの作成方法をご紹介します。
作成方法
-
登録更新する CSV ファイルを作成するため、もととなる CSV ファイルをダウンロードします。
＜はじめて得意先別単価を登録する場合＞
【一括登録更新】ページにテンプレートファイルがあるので、「得意先別単価」をダウンロードしてください。
＜既に得意先別単価が登録されている場合＞
各商品の商品詳細ページにて、「 得意先別単価ダウンロード」ボタンを押下してダウンロードしてください。
詳しい操作方法については、【価格・税率】 2. 得意先別単価 をご覧ください。
-
ダウンロードしたテンプレートファイルを、登録更新したい内容に修正します。
3. ファイルの仕様
得意先別単価を登録更新する CSV ファイルの仕様をご紹介します。
＊CSV のフォーマットはアップデート中です。最新版が必要な方は、お問い合わせいただければ提示させていただきます。
1. ファイル概要
CSV ファイルの概要をご紹介します。
| ファイル名 | 入力 / 出力 | 拡張子 | 文字コード | 囲み文字 | 区切り文字 | エスケープ文字 | 改行コード | ヘッダー有無 | 1 ファイルあたりの上限 行数 | 備考 |
|---|---|---|---|---|---|---|---|---|---|---|
| 任意のファイル名を指定してください。 | 入力 | .csv | UTF-8 BOM 付 | ダブルクォーテーション | , | ダブルクォーテーション | CRLF ※「\r\n」を入力してください。それ以外はエラーとなります。 | あり | 1000 | ー |
＜データの指定に関するルール＞
CSV ファイルをアップロードする際に、気を付けるべきルールが 2 点あります。
1. Null の設定方法とその扱い
・Null とは？: Null は「何もない状態」を意味します。データベースやプログラムで、値が存在しないことを示します。
・Null の設定方法: データの区切り文字（カンマ）の間に何も入力しないと、その部分は「Null」として扱われます。 例：,,
・Null の扱い: 既存のデータを更新する際に、Null が指定されている項目は、変更されず、元の値のまま残ります。
2. 空文字の設定方法
・空文字とは？: 空文字は「空の文字列」を意味します。つまり、値は存在するが、その中身が空であることを示します。
・空文字の設定方法: データの区切り文字（カンマ）の間をダブルクオーテーション（"）で囲むと、その部分は「空文字」として扱われます。 例：,"",
・空文字の扱い（新規登録）: CSV ファイルで空文字が指定されている項目は、そのまま空文字で登録されます。
・空文字の扱い（更新）: 空文字を指定して更新すると、既に登録済のデータは削除されます。
2. イメージ図
1 行目：ヘッダ領域
2 行目：データ領域
3. 項目定義
CSV ファイルの項目定義をご紹介します。
| 項目名 | データ型 | 項目長 | 新規登録時必須 | 更新時必須 | 形式 ※注釈 1 参照 | 備考 |
|---|---|---|---|---|---|---|
| Index | 数値 | 6 | ○ | ○ | CSV ファイルの各レコードの先頭（削除フラグの前）に、そのレコードが特定できる数値（1,2,3…）を指定してください。 | アップロードの際に、取込エラーとなるレコードがあった場合、Index を含めてエラーメッセージを表示します。 |
| 削除フラグ | 真偽値 | ー | 下記のいずれかを指定してください。 【削除フラグ】 true：削除する false：削除しない | |||
| 商品番号 | 文字列 | 100 | ○ | ○ | 任意の文字列（商品番号） | |
| 得意先コード | 文字列 | 11 | ○ | ○ | 任意の文字列(得意先コード) | |
| 得意先別単価 | 数値 | 整数 9 桁 | ○ | 任意の数値 | ||
| 得意先別単価メモ | 文字列 | 50 ※Value の項目 | Key:Value 形式 【Key】 言語コード："ja","en"など 【Value】 得意先別単価メモ："任意の文字列" 【フォーマット】 {"言語コード":"得意先別単価メモ","言語コード":"得意先別単価メモ", ・・・} | 指定の形式に従って、言語コードごとに指定してください。 ＜指定例＞ {"ja":"掛率は 30%です","en":"The markup rate is 30%"}【注意】 ① 実際には、エスケープ処理を行った状態で指定してください。 ② 下記の記号は、得意先別単価メモに使用できません。 ・:（半角コロン） ・"（半角ダブルクォーテーション） | ||
| その他単価 | 数値 | 整数 9 桁 | 任意の数値 | |||
| その他単価メモ | 文字列 | 50 ※Value の項目 | Key:Value 形式 【Key】 言語コード："ja","en"など 【Value】 その他単価メモ："任意の文字列" 【フォーマット】 {"言語コード":"その他単価メモ","言語コード":"その他単価メモ",・・・} | 指定の形式に従って、言語コードごとに指定してください。 ＜指定例＞ {"ja":"メーカー希望小売価格を表示しています","en":"MSRP is displayed"}【注意】 ① 実際には、エスケープ処理を行った状態で指定してください。 ② 下記の記号は、その他単価メモに使用できません。 ・:（半角コロン） ・"（半角ダブルクォーテーション） |
※注釈
実際には、記載の形式をダブルクォーテーションで囲って指定してください。
囲っている値に、カンマ（,）、ダブ ルクォーテーション（"）、改行コード（\r\n）が含まれている場合は、エスケープ処理を行った状態で指定してください。
4. 例
【一括登録更新】ページに、得意先別単価を登録更新する CSV ファイルのサンプルファイルを掲載しています。
CSV ファイル作成時にご参考ください。