一括登録更新 - 商品情報
公開日：2024 年 10 月 1 日／更新日：2024 年 10 月 1 日
1. ファイルの概要
当サービスの管理に必要なデータは、サイドメニュー＞設定＞一括登録更新より、CSV ファイルで一括登録更新できます。
ここでは、商品情報を登録更新する CSV ファイルについてご紹介します。
2. ファイルの作成
商品情報を登録更新する CSV ファイルの作成方法をご紹介します。
作成方法
-
登録更新する CSV ファイルを作成するため、もととなる CSV ファイ ルをダウンロードします。
＜はじめて商品情報を登録する場合＞ （既存の商品のレコードが 0 の場合）
【一括登録更新】ページにテンプレートファイルがあるので、「商品情報」をダウンロードしてください。
＜既に商品情報が登録されている場合＞
商品一覧の「商品ダウンロード」ボタンを押下してダウンロードしてください。
詳しい操作方法については、【商品一覧】 4. ダウンロード(在庫/商品) をご覧ください。
-
ダウンロードしたテンプレートファイルを、登録更新したい内容に修正します。
3. ファイルの仕様
商品情報を登録更新する 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 ファイルの項目定義をご紹介します。
| 項目名 | データ型 | 項目長 | 新規登録時必須 | 更新時必須 | 形式 ※注釈 1 | 備考 |
|---|---|---|---|---|---|---|
| Index | 数値 | 6 | ○ | ○ | CSV ファイルの各レコードの先頭（ステータスの前）に、そのレコードが特定できる数値（1,2,3…）を指定してください。 | アップロードの際に、取込エラーとなるレコードがあった場合、Index を含めてエラーメッセージを表示します。 |
| ステータス | 文字列 | 255 | ○ | 任意の文字列 | ||
| 商品 ID | 文字列 | 11 | ※注釈 2 参照 | ○ ※注釈 3 参照 | 任意の文字列（商品 ID） | ＜商品 ID とは？＞ ・システムが商品を特定・識別するための、商品単位でユニークな ID です。 ・EC サイトには表示されません。 ・一度登録したら変更できません。 |
| 商品番号 | 文字列 | 255 | ○ | 任意の文字列 | ＜商品番号とは？＞ ・ユーザー（会員・管理者） が商品を特定・識別するための、商品単位でユニークな番号です。 ・EC サイトに表示されます。 ・登録後も変更できます。 | |
| JAN コード | 文字列 | 14 | 任意の文字列 | |||
| 商品名 | 文字列 | 255 | Key:Value 形式 【Key】 言語コード："ja","en"など 【Value】 商品名："任意の文字列" 【フォーマット】 {"言語コード":"商品名","言語コード":"商品名",・・・} | 指定の形式に従って、言語コードごとに指定してください。 ＜指定例＞ {"ja":"マイクロSD","en":"Micro SD"}【注意】 ① 実際には、エスケープ処理を行った状態で指定してください。 ② 下記の記号は、商品名に使用できません。 ・:（半角コロン） ・"（半角ダブルクォーテーション） | ||
| 型番 | 文字列 | 255 | Key:Value 形式 【Key】 言語コード："ja","en"など 【Value】 型番："任意の文字列" 【フォーマット】 {"言語コード":"型番","言語コード":"型番",・・・} | 指定の形式に従って、言語コードごとに指定してください。 ＜指定例＞ {"ja":"A-123","en":"A-123"}【注意】 ① 実際には、エスケープ処理を行った状態で指定してください。 ② 下記の記号は、型番に使用できません。 ・:（半角コロン） ・"（半角ダブルクォーテーション） | ||
| 入り数 | 文字列 | 255 | Key:Value 形式 【Key】 言語コード："ja","en"など 【Value】 入り数："任意の文字列" 【フォーマット】 {"言語コード":"入り数","言語コード":"入り数",・・・} | 指定の形式に従って、言語コードごとに指定してください。 ＜指定例＞ {"ja":"1箱（12個入）","en":"box (12 pieces)"}【注意】 ① 実際には、エスケープ処理を行った状態で指定してください。 ② 下記の記号は、入り数に使用できません。 ・:（半角コロン） ・"（半角ダブルクォーテーション） | ||
| カテゴリ ID（メイン） | 文字列 | ○ | 任意の文字列（カテゴリ ID） | |||
| カテゴリ ID（サブ） | 文字列 | 任意の文字列（親カテゴリに紐づくカテゴリのカテゴリ ID） | 複数カテゴリを指定する場合は、カテゴリ ID をカンマ区切りで並べて指定してください。 ＜指定例＞ 1,2,3,4 | |||
| 高さ | 数値 | 整数 7 桁+小数第 2 位 | 任意の数値 | |||
| 幅 | 数値 | 整数 7 桁+小数第 2 位 | 任意の数値 | |||
| 長さ | 数値 | 整数 7 桁+小数第 2 位 | 任意の数値 | |||
| 重さ | 数値 | 整数 7 桁+小数第 2 位 | 任意の数値 | |||
| 仕様詳細 | 文字列 | 65535 | Key:Value 形式 【Key】 言語コード："ja","en"など 【Value】 仕様詳細："任意の文字列" 【フォーマット】 {"言語コード":"仕様詳細","言語コード":"仕様詳細",・・・} | 指定の 形式に従って、言語コードごとに指定してください。 ＜指定例＞ {"ja":"\<h1>商品仕様\</h1>\<h2>最新技術を搭載したワイヤレスイヤホンです。\</h2>","en":"\<h1>Product Description\</h1>\<h2>These wireless earbuds feature the latest technology.\</h2>"}【注意】 ① 実際には、エスケープ処理を行った状態で指定してください。 ② 下記の記号は、仕様詳細に使用できません。 ・:（半角コロン） ・"（半角ダブルクォーテーション） | ||
| 取扱リスク | 文字列 | 65535 | Key:Value 形式 【Key】 言語コード："ja","en"など 【Value】 取扱リスク："任意の文字列" 【フォーマット】 {"言語コード":"取扱リスク","言語コード":"取扱リスク",・・・} | 指定の形式に従って、言語コードごとに指定してください。 ＜指定例＞ {"ja":"\<h2>ワイヤレスイヤホンを高温環境（直射日光下や車内など）で使用しないでください。\</h2>","en":"\<h2>Do not use the wireless earbuds in high-temperature environments such as under direct sunlight or inside a car.\</h2>"}【注意】 ① 実際には、エスケープ処理を行った状態で指定してください。 ② 下記の記号は、取扱リスクに使用できません。 ・:（半角コロン） ・"（半角ダブルクォーテーション） | ||
| 備考情報 | 文字列 | 65535 | Key:Value 形式 【Key】 言語コード："ja","en"など 【Value】 備考情報："任意の文字列" 【フォーマット】 {"言語コード":"備考情報","言語コード":"備考情報",・・・} | 指定の形式に従って、言語コードごとに指定してください。 ＜指定例＞ {"ja":"\<h2>本製品は充電式です。\</h2>","en":"\<h2>This product is rechargeable.\</h2>"}【注意】 ① 実際には、エスケープ処理を行った状態で指定してください。 ② 下記の記号は、備考情報に使用できません。 ・:（半角コロン） ・"（半角ダブルクォーテーション） | ||
| バックオーダー可否 | 真偽値 | ○ | 下記のいずれかの数字 1 桁を指定してください。 【バックオーダー可否】 1：バックオーダー可 0：バックオーダー不可 | |||
| バックオーダーコメント要否 | 真偽値 | 下記のいずれかの数字 1 桁を指定してください。 【バックオーダーコメント要否】 1：バックオーダー可コメント要 0：バックオーダーコメント不要 | ||||
| バックオーダーコメント | 文字列 | 255 | Key:Value 形式 【Key】 言語コード："ja","en"など 【Value】 バックオーダーコメント："任意の文字列" 【フォーマット】 {"言語コード":"バックオーダーコメント","言語コード":"バックオーダーコメント",・・・} | ・バックオーダーコメント要否に「要」を指定した場合に、指定してください。 ・指定の形式に従って、言語コードごとに指定してください。 ＜指定例＞ {"ja":"在庫が入り次第、出荷いたします。","en":"We will ship as soon as the stock is available."}【注意】 ① 実際には、エスケープ処理を行った状態で指定してください。 ② 下記の記号は、バックオーダーコメントに使用できません。 ・:（半角コロン） ・"（半角ダブルクォーテーション） | ||
| 表示商品グループ ID | 文字列 | 255 | 任意の文字列（表示商品グループ ID） | |||
| 国内配送可フラグ | 真偽値 | ○ | 下記のいずれかの数字 1 桁を指定してください。 【国内配送可フラグ】 1：国内配送可 0：国内配送不可 | |||
| 海外配送可フラグ | 真偽値 | ○ | 下記のいずれかの数字 1 桁を指定してください。 【海外配送可フラグ】 1：海外配送可 0：海外配送不可 | |||
| 確認/承認要否_見積 | 文字列 | ○ | 下記のいずれかの数字 2 桁を指定してください。 【確認/承認要否区分】 01：承認のみ要 02：確認・承認 03：不要（店舗設定に従う） | |||
| 確認/承認要否_注文 | 文字列 | ○ | 下記のいずれかの数字 2 桁を指定してください。 【配送料計算区分】 01：無料 02：固定 03：受注後調整 | |||
| 危険物取扱ありフラグ | 真偽値 | ○ | 下記のいずれかの数字 1 桁を指定してください。 【危険物取扱ありフラグ】 1：あり 0：なし | |||
| リチウムイオン電池取扱ありフラグ | 真偽値 | ○ | 下記のいずれかの数字 1 桁を指定してください。 【リチウムイオン電池取扱ありフラグ】 1：あり 0：なし | |||
| 微量危険物取扱ありフラグ | 真偽値 | ○ | 下記のいずれかの数字 1 桁を指定してください。 【微量危険物取扱ありフラグ】 1：あり 0：なし | |||
| 検索キーワード | 文字列 | 3000 | 任意の文字列 | |||
| 価格 ①_有効期間（FROM） | 日付 | YYYY-MM-DD（年月日） | ・フォーマット形式で指定してください。 ＜指定例＞ 2024-09-20 ・日本時間で指定してください。 | |||
| 価格 ①_有効期間（TO） | 日付 | YYYY-MM-DD（年月日） | ・フォーマット形式で指定してください。 ＜指定例＞ 2024-09-20 ・日本時間で指定してください。 | |||
| 価格 ①グループ単価 ID:価格 ①グループ単価 | 数値 | 整数 13 桁+小数第 2 位 | Key:Value 形式 【Key】 グループ単価 ID："任意の数値" 【Value】 単価："任意の数値" 【フォーマット】 {"グループ単価ID":"単価","グループ単価ID":"単価",・・・} | ・指定の形式に従って、グループ単価 ID ごとに指定してください。 ＜指定例＞ {"1":"10000","2":"12000"}【注意】 ① 実際には、エスケープ処理を行った状態で指定してください。 ② グルー プに対して単価を指定しない（標準単価を使う）場合は、指定不要です。 ③ グループ単価 ID は、グループ単価一覧画面でご確認ください。 | ||
| 価格 ②_有効期間（FROM） | 日付 | YYYY-MM-DD（年月日） | ・フォーマット形式で指定してください。 ＜指定例＞ 2024-09-20 ・日本時間で指定してください。 | |||
| 価格 ②_有効期間（TO） | 日付 | YYYY-MM-DD（年月日） | ・フォーマット形式で指定してください。 ＜指定例＞ 2024-09-20 ・日本時間で指定してください。 | |||
| 価格 ②グループ単価 ID:価格 ②グループ単価 | 数値 | 整数 13 桁+小数第 2 位 | Key:Value 形式 【Key】 グループ単価 ID："任意の数値" 【Value】 単価："任意の数値" 【フォーマット】 {"グループ単価ID":"単価","グループ単価ID":"単価",・・・} | ・指定の形式に従って、グループ単価 ID ごとに指定してください。 ＜指定例＞ {"1":"10000","2":"12000"}【注意】 ① 実際には、エスケープ処理を行った状態で指定してください。 ② グループに対して単価を指定しない（標準単価を使う）場合は、指定不要です。 ③ グループ単価 ID は、グループ単価一覧画面でご確認ください。 | ||
| 税率 ①税率有効期間（自） | 日付 | YYYY-MM-DD（年月日） | ・フォーマット形式で指定してください。 ＜指定例＞ 2024-09-20 ・日本時間で指定してください。 | |||
| 税率 ①税率有効期間（至） | 日付 | YYYY-MM-DD（年月日） | ・フォーマット形式で指定してください。 ＜指定例＞ 2024-09-20 ・日本時間で指定してください。 | |||
| 税率 ①_税率 ID | 数値 | 任意の文字列（税率 ID） | 税率 ID は、店舗設定（商品）で確認できます。 | |||
| 税率 ①_税率 | 数値 | 整数 1 桁+小数第 2 位 | 任意の数値 | |||
| 税率 ②税率有効期間（自） | 日付 | YYYY-MM-DD（年月日） | ||||
| 税率 ②税率有効期間（至） | 日付 | YYYY-MM-DD（年月日） | ||||
| 税率 ②_税率 ID | 数値 | 任意の文字列（税率 ID） | ||||
| 税率 ②_税率 | 数値 | 整数 1 桁+小数第 2 位 | 任意の数値 | |||
| 単価販売のみフラグ | 真偽値 | ○ | 下記のいずれかの数字 1 桁を指定してください。 【単価販売のみフラグ】 1：単価販売のみを許容する 0：通常販売 | |||
| 注文数（ボリュームディスカウント条件） | 数値 | 6 | Key:Value 形式 【Key】 条件番号："1","2","3"のいずれか 【Value】 注文数："任意の数値" 【フォーマット】 {"条件番号:"注文数","条件番号":"注文数,"条件番号:"注文数",・・・} | 指定の形式に従って、条件番号ごとに指定してください。 ＜指定例＞ {"1":"100","2":"200","3":"300"}① 実際には、エスケープ処理を実施した状態で指定してください。 ② 条件番号と注文数は、商品詳細画面の赤枠の部分です。  | ||
| 値引き割合（ボリュームディスカウント条件） | 数値 | 3 | Key:Value 形式 【Key】 条件番号："1","2","3"のいずれか 【Value】 値引き割合："任意の数値" 【フォーマット】 {"条件番号:"値引き割合","条件番号":"値引き割合,"条件番号:"値引き割合",・・・} | 指定の形式に従って、条件番号ごとに指定してください。 ＜指定例＞ {"1":"10","2":"20","3":"30"}① 実際には、エスケープ処理を実施した状態で指定してください。 ② 条件番号と値引き割合は、商品詳細画面の赤枠の部分です。  | ||
| 在庫表示切替閾値 | 数値 | 6 | 任意の数値 | |||
| 国内標準倉庫指定なし納期数字 | 数値 | 2 | ○ | 任意の数値 | ||
| 国内標準倉庫指定なし納期単位 | 文字列 | ○ | 下記のいずれかの数字 2 桁を指定してください。 【納期単位】 01：日 02：週 03：月 04：年 | |||
| 国内標準倉庫指定なし納期以内/超 | 文字列 | ○ | 下記のいずれかの数字 2 桁を指定してください。 【納期以内/超区分】 01：以内 02：超 | |||
| 国内標準倉庫指定あり在庫あり_納期数字 | 数値 | 2 | ○ | 任意の数値 | ||
| 国内標準倉庫指定あり在庫あり_納期単位 | 文字列 | ○ | 下記のいずれかの数字 2 桁を指定してください。 【納期単位】 01：日 02：週 03：月 04：年 | |||
| 国内標準倉庫指定あり在庫あり_納期以内/超 | 文字列 | ○ | 下記のいずれかの数字 2 桁を指定してください。 【納期以内/超区分】 01：以内 02：超 | |||
| 国内標準倉庫指定あり在庫なし_納期数字 | 数値 | 2 | ○ | 任意の数値 | ||
| 国内標準倉庫指定あり在庫なし_納期単位 | 文字列 | ○ | 下記のいずれかの数字 2 桁を指定してください。 【納期単位】 01：日 02：週 03：月 04：年 | |||
| 国内標準倉庫指定あり在庫なし_納期以内/超 | 文字列 | ○ | 下記のいずれかの数字 2 桁を指定してください。 【納期以内/ 超区分】 01：以内 02：超 | |||
| 国内共通在庫なし_納期数字 | 数値 | 2 | ○ | 任意の数値 | ||
| 国内共通在庫なし_納期単位 | 文字列 | ○ | 下記のいずれかの数字 2 桁を指定してください。 【納期単位】 01：日 02：週 03：月 04：年 | |||
| 国内共通在庫なし_納期以内/超 | 文字列 | ○ | 下記のいずれかの数字 2 桁を指定してください。 【納期以内/超区分】 01：以内 02：超 | |||
| 海外標準倉庫指定なし納期数字 | 数値 | 2 | ○ | 任意の数値 | ||
| 海外標準倉庫指定なし納期単位 | 文字列 | ○ | 下記のいずれかの数字 2 桁を指定してください。 【納期単位】 01：日 02：週 03：月 04：年 | |||
| 海外標準倉庫指定なし納期以内/超 | 文字列 | ○ | 下記のいずれかの数字 2 桁を指定してください。 【納期以内/超区分】 01：以内 02：超 | |||
| 海外標準倉庫指定あり在庫あり_納期数字 | 数値 | 2 | ○ | 任意の数値 | ||
| 海外標準倉庫指定あり在庫あり_納期単位 | 文字列 | ○ | 下記のいずれかの数字 2 桁を指定してください。 【納期単位】 01：日 02：週 03：月 04：年 | |||
| 海外標準倉庫指定あり在庫あり_納期以内/超 | 文字列 | ○ | 下記のいずれかの数字 2 桁を指定してください。 【納期以内/超区分】 01：以内 02：超 | |||
| 海外標準倉庫指定あり在庫なし_納期数字 | 数値 | 2 | ○ | 任意の数値 | ||
| 海外標準倉庫指定あり在庫なし_納期単位 | 文字列 | ○ | 下記のいずれかの数字 2 桁を指定してください。 【納期単位】 01：日 02：週 03：月 04：年 | |||
| 海外標準倉庫指定あり在庫なし_納期以内/超 | 文字列 | ○ | 下記のいずれかの数字 2 桁を指定してください。 【納期以内/超区分】 01：以内 02：超 | |||
| 海外共通在庫なし_納期数字 | 数値 | 2 | ○ | 任意の数値 | ||
| 海外共通在庫なし_納期単位 | 文字列 | ○ | 下記のいずれかの数字 2 桁を指定してください。 【納期単位】 01：日 02：週 03：月 04：年 | |||
| 海外共通在庫なし_納期以内/超 | 文字列 | ○ | 下記のいずれかの数字 2 桁を指定してください。 【納期以内/超区分】 01：以内 02：超 | |||
| RoHS 区分 | 真偽値 | ○ | 下記のいずれかの数字 1 桁を指定してください。 【RoHS 区分】 1：準拠 0：非準拠 | |||
| WEEE 区分 | 真偽値 | ○ | 下記のいずれかの数字 1 桁を指定してください。 【WEEE 区分】 1：準拠 0：非準拠 | |||
| REACH 区分 | 真偽値 | ○ | 下記のいずれかの数字 1 桁を指定してください。 【REACH 区分】 1：準拠 0：非準拠 | |||
| SDS 安全データシート | ー | ー | ー | CSV ファイルでの登録・更新はできません。 値を入れた状態でアップロードしても無視され、登録・更新はされません。 一括登録更新画面より直接ファイルをアップロードしてください。 | ||
| その他添付ファイル | ー | ー | ー | CSV ファイルでの登録・更新はできません。 値を入れた状態でアップロードしても無視され、登録・更新はされません。 一括登録更新画面より直接ファイルをアップロードしてください。 | ||
| 原産国 | 文字列 | 下記リンクのページにある国コードのうちいずれかを指定してください。 【国コード一覧】 | ||||
| HS コード | 文字列 | 30 | 任意の文字列 | |||
| 最終更新日 | ー | ー | ー | CSV ファイルでの登録・更新はできません。 値を入れた状態でアップロードしても無視され、登録・更新はされません。 | ||
| 最終更新者 | ー | ー | ー | CSV ファイルでの登録・更新はできません。 値を入れた状態でアップロードしても無視され、登録・更新はされません。 |
※注釈 1
実際には、記載の形式をダブルクォーテーションで囲って指定してください。
囲っている値にダブルクォーテーションが含まれている場合は、エスケープ処理を行った状態で指定してください。
※注釈 2
商品 ID は、任意の文字列を指定するほか、未指定で登録することもできます。
未指定の場合は、下記の形式で自動採番されます。
| 項目名 | 形式 | 例 |
|---|---|---|
| 商品 ID | P+整数 10 桁 0 埋め | P0000000001 |
※注釈 3
更新する商品の商品 ID を指定してください。商品 ID は、商品一覧の CSV ファイルをダウンロードすることで確認できます。
ダウンロード方法と CSV ファイルの詳細については、【ダウンロード CSV（商品一覧）】をご覧ください。
4. 例
【一括登録更新】ページに、商品情報を登録更新する CSV ファイルのサンプルファイルを掲載しています。
CSV ファイル作成時にご参考ください。