楽天のnormal-item.csvとは？SKU対応版CSVの行構造と必須項目

楽天のnormal-item.csvは、商品・商品オプション・SKUの新規登録と更新を、同じファイルで行うCSVです。商品レベル行・商品オプションレベル行・SKUレベル行を使い分け、SKU対応版ではコントロールカラムを使用しません。

本記事は、2026年9月に確認した各マニュアルの記載に基づきます。登録・更新時は、公式マニュアルで最新の仕様をご確認ください。

楽天のnormal-item.csvとは？新規登録と更新に使うファイル

normal-item.csvは、商品情報・SKU・商品オプションの登録と更新に使います。削除や店舗内カテゴリとの紐付けには、別のCSVが必要です。

normal-item.csvは1ファイルで登録・更新の両方ができるため、既存商品を上書きしてしまう可能性があります。 入力を誤ると、他商品の更新や新規登録につながるおそれがあります。

また、CSVの一括編集処理中にも、RMSやAPIから同じ商品を編集できます。複数の経路で同時に編集すると、最後に保存されたデータが反映されます。

normal-item.csvの行構造｜3種類の判定条件とシングルSKU

normal-item.csvの行種別は、商品管理番号・選択肢タイプ・SKU管理番号の入力有無で判定されます。

判定に使用する商品管理番号の正式な項目名は「商品管理番号（商品URL）」です。以下の表では、読みやすさのため「商品管理番号」と表記します。

有効なのは最初の3パターンだけで、ほかはエラーです。 入力内容も別途確認してください。

行の判定条件と項目の必須属性は別です。選択肢タイプ（2-1）と商品オプション項目名（2-2）は、登録・更新とも「項目省略可能」です。

商品管理番号は、商品と商品オプション・SKUを紐付ける役割を持ちます。そのため、同じ番号が続く場合でも、すべてのレベル行に入力します。

各レベル行に入力する情報

商品オプションの選択肢タイプは、sがセレクトボックス、cがチェックボックス、fがフリーテキストです。選択肢タイプを設定した場合は、商品オプション項目名も必須になります。

シングルSKUでも商品行とSKU行が必要

シングルSKUでも、商品レベル行とSKUレベル行の両方が必要です。

この表は行構造の説明用であり、そのままアップロードできる全項目のサンプルではありません。新規登録時には、商品種別やジャンルに応じた必須項目も入力します。

マルチSKUでは、商品レベル行でバリエーションの項目と選択肢を定義します。その定義に対応するキーと選択肢を、各SKUレベル行に入力してください。

normal-item.csvのコントロールカラムは廃止｜n・u・dはitem-cat.csvのみ

SKU対応版以降、normal-item.csvではコントロールカラムが廃止され、n・u・dは使用できません。

コントロールカラムは、新規登録・更新・削除を指定する項目です。

item-cat.csvのuで更新できるのは、優先度、つまり店舗内カテゴリでの表示順位だけです。既存のカテゴリとの紐付けを別のカテゴリへ変更する場合は、dで削除し、nで新しい紐付けを登録します。

normal-item.csvの商品レベル必須項目と主要カラム

商品レベルでは、商品管理番号を登録・更新時に必ず入力し、新規登録時には商品名やジャンルIDも必要です。

以下では、商品レベル12項目と、次節のSKUレベル13項目を紹介します。「列番号」はマニュアルの項目番号であり、CSV上の固定された列位置を示すものではありません。

「省略可」は列そのものを省略できるという意味です。列を残してセルを空欄にする操作とは、扱いが異なります。

Byte欄にはマニュアルの値を記載しています。

入力例は項目定義にある例であり、実際には対象商品の情報を入力します。ジャンルIDなども、例の値をそのまま使用しないでください。

商品管理番号は全角・大文字が半角に自動変換され、CSVの文字列と登録結果が変わります。商品番号とは別項目で、文字種も異なります。

販売期間の日時は、日付をハイフンまたはスラッシュで区切り、日付と時刻の間に半角スペースを入れます。秒単位まで指定するとエラーになるため、分までの形式で入力してください。

また、ジャンルIDを変更するときは、商品属性の設定も変更する必要があります。変更前の属性と変更後の必須属性について、RMSの商品一括編集マニュアルで設定方法を確認してください。

normal-item.csvのSKU必須項目｜価格・在庫・商品属性

SKU管理番号は、SKUレベル行を更新する場合にも必須です。マニュアルの更新欄に「項目省略可能」とあっても、SKUレベル行の更新時には省略できません。

SKU管理番号は大文字英字も使用可能で、商品管理番号とは扱いが異なります。同じ商品内の別SKUと重複できません。バリエーション項目キーと選択肢には、商品レベル行で定義した内容を入力します。

在庫数はByte欄が10でも、登録できる値は0～99999です。更新時にはプラス・マイナスによる指定も可能なので、絶対数の入力と増減の指定を区別してください。

通常購入販売価格は、通常購入のみの商品や予約商品では0～999999999の整数です。定期購入を設定している場合などは条件が異なるため、公式マニュアルで最新をご確認ください。

カタログIDとカタログIDなしの理由は、ともに「項目省略可能」ですが、登録時はどちらか一方が必須です。2018年10月2日から全ジャンルでカタログIDが必須となり、登録が困難な場合は理由を登録します。理由が1（セット商品）なら、セット商品用カタログIDも必須です。

商品属性には、必須商品属性・いずれか必須商品属性・任意商品属性があります。表だけで新規登録の全必須項目を判断せず、対象ジャンルの商品属性定義も確認してください。

倉庫指定とSKU倉庫指定によるページ表示

倉庫指定・SKU倉庫指定は、0が販売中、1が倉庫です。商品が倉庫にある場合と、販売中でも全SKUが倉庫にある場合は、商品ページが非表示になります。 マニュアルの組み合わせ表は次のとおりです。

RMSの商品個別編集で商品倉庫指定を「販売中」のまま更新すると、SKU倉庫指定も自動的に「販売中」に変わり、商品ページが表示される点にも注意してください。

normal-item.csvのファイル名｜dl-の削除とダウンロード仕様

アップロードする商品登録・更新用CSVは、ファイル名を必ずnormal-itemで始め、ダウンロード時のdl-を外します。

先頭の条件を満たせば、連番や日付を付けたファイル名も使用できます。

ファイル名に付加する文字には、半角英数字・ハイフン・アンダースコアを使用します。全角文字や、利用できない記号を含めないようにしてください。

ダウンロードしたCSVはアップロード仕様と同一ではない

データ形式マニュアルはアップロード向けの仕様であり、ダウンロード時には記載方法が異なる場合があります。特に次の繰り返し項目は、登録可能な最大列数でダウンロードされます。

楽天CSVで商品登録・更新する手順｜SKUの並び順と空欄を確認

公式マニュアルの流れ（手順1〜6）

1. CSV商品一括編集機能の利用を申し込む

RMSの「店舗様向け情報・サービス」から、利用状況を確認して申し込みます。

1. SFTPソフトを準備する

CSVファイルを専用サーバーへ転送するため、SFTPソフトを用意します。

1. 更新前のバックアップを取得する

既存商品を更新する場合は、編集前の商品情報をダウンロードして保存します。

1. 新規登録用または更新用の元ファイルを用意する

新規登録では公式サンプルを、更新では既存の商品情報をダウンロードして使用します。

1. 3種類のレベル行に情報を分けて入力する

商品名は商品レベル行、価格や在庫はSKUレベル行など、項目の所属を確認します。

1. 作成した商品情報をアップロードする

作成したCSVファイルをサーバーにアップロードします。

公式手順に加えて、実務で必ず行う確認

• 必須項目・空欄・文字・ファイル名を確認する

省略する列と空欄で更新する列を区別し、ファイル名の先頭も確認します。

• アップロード後にエラーログと反映結果を確認する

登録後の商品情報はCSVダウンロードでも確認し、意図した内容になっているか点検します。

同じ商品のSKUを途中で分断しない

同じ商品管理番号を持つSKUは、連続してひとかたまりにする必要があります。商品AのSKUの間に、商品Bの商品行やSKU行を挟まないでください。

バリエーションと商品オプションの並び替え

バリエーションの並び順はnormal-item.csvでは変更できません。 変更にはRMSの商品個別編集画面を使います。

商品オプション項目名の並び替えは、item-delete.csvで一度削除してから、normal-item.csvで希望する順番に登録します。normal-item.csvの行を並べ替えるだけでは変更できません。

オプション削除時は「商品管理番号（商品URL）」「選択肢タイプ」「商品オプション項目名」の3項目を指定します。商品管理番号だけの行にすると商品自体が削除されるため、注意してください。

空欄は「変更しない」という指定ではない

列が存在したまま空欄で更新すると、既存値の削除や初期値への変更が起こる項目があります。例えば、PC用商品説明文は削除され、倉庫指定は0の販売中へ更新されます。

更新しない項目については、項目省略が可能かを確認してください。ただし、マニュアルでは、省略した項目にエラーがある場合もエラーになることが示されています。

絵文字・機種依存文字を入力しない

絵文字をはじめとする機種依存文字は、正常な登録・更新を妨げるため、CSVに入力しないでください。該当文字は、取り除かれる・変換される・エラーで処理が終了する場合があります。

文字の問題がある箇所は、登録処理時のエラーログで確認します。また、半角カナはEUC換算で1文字2Byteとして計算されるため、見た目の文字数だけで上限を判断しないでください。

楽天CSV商品一括編集の料金｜月額11,000円と解約時の注意

CSV商品一括編集機能は月額11,000円（税込）で、利用しない月や月半ばからの利用開始でも満額が発生します。

解約は、すべてのページ反映が完了したことを確認してから行ってください。 アップロード完了とページ反映完了は区別してください。

再申し込み時の未反映データの扱いは、2つのマニュアルで食い違っています。

どちらが現行の扱いかは、資料だけでは判断できず、楽天市場に公式に確認する必要があります。 全ページの反映を確認してから解約してください。

normal-item.csv・楽天CSV商品登録のよくある質問

Q1. シングルSKUなら、商品情報を1行にまとめられますか？

まとめられません。シングルSKUでも、商品レベル行とSKUレベル行の両方が必要です。

商品名は商品レベル行に、SKU管理番号・価格・在庫数はSKUレベル行に入力します。商品管理番号は両方の行に入力してください。

Q2. 新規登録なので、コントロールカラムにnを入れますか？

normal-item.csvでは、SKU対応版以降、コントロールカラムは使用できません。n・u・dを使用するのはitem-cat.csvだけです。

商品・SKU・商品オプションを削除する場合は、item-delete.csvを使用します。

Q3. 商品管理番号が同じなら、2行目以降は空欄でよいですか？

空欄にはできません。商品管理番号は、商品レベル行・商品オプションレベル行・SKUレベル行のすべてで必須です。

Q4. 更新しない項目は、セルを空欄にすればよいですか？

空欄を「変更しない」という意味では使えません。項目によって、既存設定の削除や初期値への更新が起こります。

更新対象から外す場合は、その項目の列を省略できるか、データ形式の更新欄で確認してください。

Q5. ダウンロードしたCSVが取り込まれない原因は何ですか？

ファイル名にダウンロード時のdl-が残っていると、アップロードしても取り込まれません。先頭をnormal-itemに変更してください。

全角文字や利用できない記号がファイル名に含まれていないかも確認します。内容については、行構造・必須項目・エラーログを順に確認してください。