商品レベル
商品管理番号、商品名、ジャンルID、商品説明、商品画像、販売期間など商品ページ全体の情報を扱います。
楽天RMS normal-item.csv 項目ガイド
楽天CSVの項目一覧｜normal-item.csvの必須項目と入力ルール
楽天の商品CSVにある項目名の意味が分からない方向けに、商品レベル・SKUレベル・商品オプションの項目と、入力条件・エラー時の確認方法をまとめました。
先に結論
normal-item.csvは商品レベル／SKUレベル／商品オプションレベルで使う項目が異なります。商品名や販売期間は主に商品レベル、通常購入販売価格や在庫数はSKUレベルです。新規登録時の必須項目、更新時の列省略・空欄の意味は、楽天RMSの最新項目定義で確認してください。
normal-item.csvは商品レベル／SKUレベル／商品オプションレベルで使う項目が異なります。商品名や販売期間は主に商品レベル、通常購入販売価格や在庫数はSKUレベルです。新規登録時の必須項目、更新時の列省略・空欄の意味は、楽天RMSの最新項目定義で確認してください。
この記事で分かること
楽天CSVの項目とは？3種類の行で構成される
楽天RMSで商品情報をCSVから登録・更新する場合、SKU対応後は主にnormal-item.csvを使用します。CSVの「項目」とは、商品管理番号、商品名、価格などを入れる列（カラム）の名前のことです。
重要なのは、すべての項目が同じ行に入るわけではない点です。現在の商品CSVでは、商品レベル・SKUレベル・商品オプションレベルの行を使い分けます。
SKUレベル
SKU管理番号、通常購入販売価格、在庫、カタログID、商品属性など販売単位ごとの情報を扱います。
商品オプションレベル
商品オプション項目名、選択肢タイプなど、追加の選択項目を扱います。利用しない場合は行を作らないケースもあります。
行を関連付ける識別子
商品管理番号（商品URL）で対象商品を特定し、SKU管理番号で販売単位を区別します。Excelで行を加工するときは対応関係を崩さないようにします。
CSVの基本構造やダウンロード・アップロードの流れはnormal-item.csvの基本ガイドで解説しています。この記事は項目の意味と入力条件の調べ方に絞ります。
normal-item.csvの主要項目一覧【早見表】
まず、楽天CSVで実際の運用頻度が高い項目を行の種類ごとにまとめます。以下は主要項目の抜粋であり、CSVの全カラムや必須項目を網羅したものではありません。
必須項目の判定には注意
「列が必要」「その行に値が必要」「更新時には省略できる」は別の条件です。新規登録／既存商品の更新、シングルSKU／マルチSKU、商品ジャンルで要件が異なります。最終的な判断は楽天RMS・店舗運営Naviの最新項目定義に従ってください。
「列が必要」「その行に値が必要」「更新時には省略できる」は別の条件です。新規登録／既存商品の更新、シングルSKU／マルチSKU、商品ジャンルで要件が異なります。最終的な判断は楽天RMS・店舗運営Naviの最新項目定義に従ってください。
商品レベルで使う項目
| 項目名 | 主な用途 | 確認のポイント |
|---|---|---|
| 商品管理番号（商品URL） | 商品を識別する番号。SKU行等でも対応関係の確認に使う | 識別の中心となる項目 |
| 商品番号 | 店舗の商品コード・社内管理用番号等 | 運用と登録条件を確認 |
| 商品名 | お客様に表示される商品の名称 | 新規登録で重要 |
| ジャンルID | 楽天市場の商品ジャンルを指定 | 新規登録で重要 |
| 倉庫指定 | 販売中／倉庫などの表示状態 | 公開前に確認 |
| 販売期間指定（開始日時） | 商品を販売する期間の開始 | 指定するとき確認 |
| 販売期間指定（終了日時） | 商品を販売する期間の終了 | 開始時刻との前後関係を確認 |
| ポイント変倍率 | 商品ごとのポイント変倍設定 | 施策時の設定条件を確認 |
| キャッチコピー | 商品訴求に使う短い説明 | 文字数・表示ルールを確認 |
| PC用商品説明文 | PC向け説明内容 | HTML等の入力規則を確認 |
| スマートフォン用商品説明文 | スマホ向け説明内容 | 表示と使用可能タグを確認 |
| 商品画像タイプ1／商品画像パス1 | 画像の参照形式と画像の保存先 | タイプとパスの組合せを確認 |
| 商品画像名（ALT）1 | 商品画像の説明テキスト | 画像の内容と一致させる |
| バリエーション項目キー定義 | サイズ／カラー等の識別キー | マルチSKUでは重要 |
| バリエーション項目名定義 | 選択軸の表示名 | マルチSKUでは重要 |
| バリエーション1選択肢定義など | サイズ／カラー等の選択肢 | SKU行の値と対応させる |
SKUレベルで使う項目
| 項目名 | 主な用途 | 確認のポイント |
|---|---|---|
| SKU管理番号 | SKUごとに区別するための番号 | 新規SKUでは重要 |
| バリエーション項目キー1など | 商品レベルで定義した選択軸のキー | マルチSKUで確認 |
| バリエーション項目選択肢1など | 例：ブラック、Mなどの選択肢 | マルチSKUで確認 |
| 通常購入販売価格 | 購入時のSKU別販売価格 | 新規登録で重要 |
| 在庫数 | SKUごとの在庫数量 | 販売方法・在庫の運用条件を確認 |
| カタログID | JANなどに関するIDの登録 | 対象商品の要件を確認 |
| カタログIDなしの理由 | カタログIDを設定しない理由 | IDを登録しない場合に確認 |
| SKU画像タイプ／SKU画像パス | SKU単位の画像を設定 | 設定する場合はペアで確認 |
| SKU倉庫指定 | SKUごとの表示状態 | 必要なときに確認 |
| 商品属性（項目）1など | ジャンルに応じた商品属性名 | 指定ジャンルでの入力要件を確認 |
| 商品属性（値）1など | 属性名に対応した具体的な値 | 値の形式・選択肢を確認 |
| 商品属性（単位）1など | 寸法・容量などの属性の単位 | 単位が必要な属性で確認 |
商品オプションレベルで使う項目
| 項目名 | 主な用途 |
|---|---|
| 選択肢タイプ | セレクトボックス／チェックボックス等の入力形式 |
| 商品オプション項目名 | 名入れ、ラッピングなどのオプション名 |
| 商品オプション選択肢1など | 選択できる内容（該当タイプで設定） |
| 商品オプション選択必須 | 選択を必須にするかの設定 |
※「商品画像タイプ1」「商品画像パス1」など数字が付く列は、画像や選択肢を複数設定する場合に連番で用意されます。商品の仕様やRMS画面によって利用できる上限が変わる場合があります。
楽天CSVの必須項目は新規登録・更新で異なる
「楽天CSV 必須項目」で検索する際に特に重要なのは、新規登録に必要な情報と、既存商品の更新時に必要な情報を分けて考えることです。
新規登録時に優先して確認する項目
一般的な商品登録では、商品管理番号（商品URL）、商品名、ジャンルID、SKU管理番号、通常購入販売価格、在庫、カタログID関連の入力条件などを確認します。マルチSKU商品はバリエーション定義も重要です。
ジャンル別の商品属性では、属性名・属性値・単位に必須条件が設定されていることがあります。ジャンルが違えば必須属性も変わる可能性があるため、最新の属性定義を確認しましょう。
既存商品の一部項目を更新する場合
例えば商品名だけを変える更新と、SKUの価格だけを変える更新では、必要な行やカラムが異なります。商品・SKUの識別子を残して対象の項目を更新します。不要な列を機械的に残したり空欄で送ったりせず、RMSの更新仕様で確認してください。
「商品名」「価格」「販売期間」はどの行に入力する？
| 変更内容 | 行の種類 | 特に確認すること |
|---|---|---|
| 商品名を変更 | 商品レベル | 商品管理番号と商品名の対応 |
| 価格を変更 | SKUレベル | 通常購入販売価格とSKU管理番号の対応 |
| 販売期間を指定 | 商品レベル | 開始・終了日時、指定書式 |
| 在庫を変更 | SKUレベル | 対象SKU、在庫管理方法 |
| ポイント倍率を変更 | 商品レベル | 変倍率、適用期間、楽天側の設定条件 |
例えば白・黒の2SKUがあるTシャツを登録している場合、商品名は商品全体の情報ですが、販売価格と在庫数はSKUごとに持つ情報です。
販売期間は販売期間指定（開始日時）と販売期間指定（終了日時）などの項目で設定します。日時形式の例としてYYYY/MM/DD HH:MMが案内されますが、実際の受け付け形式は最新版を確認してください。
商品画像の項目：パスとタイプをセットで確認
楽天CSVで商品画像を設定するときは、商品画像パス1だけを変更すればよいとは限りません。画像の参照先に対応する商品画像タイプ1との組合せを確認します。
| 項目 | 役割 | 例の考え方 |
|---|---|---|
| 商品画像タイプ1 | 参照先の種類 | R-Cabinet等の画像管理方式に合わせる |
| 商品画像パス1 | 画像ファイルの参照先 | フォルダと画像ファイル名を確認する |
| 商品画像名（ALT）1 | 画像の説明文 | 写真の内容に合った短い説明を付ける |
| SKU画像タイプ・SKU画像パス | SKU別の画像 | 色違い等をSKUごとに見せる場合に使用 |
画像URLをそのまま貼り付ける運用と、R-Cabinetの管理パスをCSVに記載する運用は扱いが異なります。RMSの画像仕様に合わせて設定してください。
商品属性（項目・値・単位）は3つの列を確認
ジャンルによっては、商品属性の入力が必要です。楽天CSVでは商品属性が「項目」「値」「単位」などの組合せで扱われるため、値だけ入力しても登録できないケースがあります。
| 属性の列 | 役割 | 説明例 |
|---|---|---|
| 商品属性（項目）1 | 属性の種類 | 素材 |
| 商品属性（値）1 | 種類に対応する値 | 綿 |
| 商品属性（単位）1 | 単位が求められる場合の設定 | 重量など、単位を持つ属性で使用 |
上の値は仕組みを説明するための例です。実際の属性項目名や入力できる値は商品ジャンルごとの定義が優先です。ジャンルIDが変わると必要な属性が変わる場合もあるため、RMSの「商品属性定義」を参照してください。
単位を無理に入力しない
「素材：綿」のように単位を必要としない属性もあります。逆に長さ・重量などで単位の指定が必要な場合もあります。属性ごとに設定の要否を確認してください。
「素材：綿」のように単位を必要としない属性もあります。逆に長さ・重量などで単位の指定が必要な場合もあります。属性ごとに設定の要否を確認してください。
CSVの行構成を説明用の表で確認
単品商品でも商品レベル行だけで終わらず、通常購入販売価格などを登録するSKUレベル行が必要です。マルチSKUでは、販売する組合せの数だけSKU行を設定するイメージです。
| 行の種類 | 商品管理番号（例） | 設定する項目例 |
|---|---|---|
| 商品レベル | sample-shirt | 商品名、ジャンルID、バリエーション定義 |
| SKUレベル | sample-shirt | SKU管理番号：shirt-white-m、通常購入販売価格：1980 |
| SKUレベル | sample-shirt | SKU管理番号：shirt-black-m、通常購入販売価格：1980 |
上の表はアップロード用CSVではありません。
正式な列名と列構成を省略した説明図です。データを作成するときはRMSの最新サンプルCSVをダウンロードし、そこで指定されるヘッダーや必要な列を使用してください。
正式な列名と列構成を省略した説明図です。データを作成するときはRMSの最新サンプルCSVをダウンロードし、そこで指定されるヘッダーや必要な列を使用してください。
旧item.csvにあったn・u・dのコントロールカラムを、normal-item.csvに付け足さないようにしましょう。ただし、item-cat.csvなど別種のCSVには固有の項目があるため、すべてのCSVで共通のルールとは限りません。
楽天CSVの最新項目一覧・サンプルを確認する方法
1. 楽天RMS・店舗運営Naviを確認する
CSV商品一括編集の項目仕様・入力形式・必須条件を確認します。最新の正式仕様は楽天側の資料を優先してください。
2. 対象商品のCSVをダウンロードする
既存商品を更新する場合は現在の商品情報を取得します。ダウンロード条件で商品と項目を選び、現在どの列が使われているか確認します。
3. 変更したい項目と必要な行レベルを決める
商品名・販売期間なら商品レベル、販売価格・在庫ならSKUレベルなど、変更内容に応じて行を分けます。
4. 元CSVを保存し、少数商品で検証する
元データをバックアップし、CSVを編集します。最初は少数商品で楽天側の取り込み結果と実際の商品ページを確認しましょう。
空欄・カラム省略・値の削除は同じ意味ではない
CSV編集で起こりやすいミスの一つが、「空欄にしておけば変更されないはず」と決めつけることです。空欄で前の値を維持する列、設定解除を表す列、データ不足でエラーになる列など、項目によって動作が異なる場合があります。
また、列そのものをCSVから省く操作と、列を残したまま空欄にする操作も同じではありません。更新時にどの動作になるか、必ずRMSの項目別仕様を確認してください。
削除操作には特に注意
商品やSKUの削除は
商品やSKUの削除は
item-delete.csvなど、更新用と異なるCSVを使います。空欄や行削除だけで安全に削除できるとは考えないでください。楽天CSVの項目エラーでよく確認すること
| エラーや症状 | 確認する項目・原因 |
|---|---|
| 必須項目がありません | 新規登録・更新、商品レベル・SKUレベル、ジャンル別の必須条件 |
| ヘッダー・項目名が不正 | CSV項目の正式名称・スペース・文字コード・旧形式の混在 |
| SKUの価格が更新されない | SKU管理番号と通常購入販売価格の対応 |
| 画像が更新されない | 商品画像タイプと商品画像パスのセット・参照先 |
| 商品属性のエラー | ジャンルID、属性の項目・値・単位 |
| 一部の商品だけエラー | 商品管理番号・SKU・バリエーション定義の対応 |
| アップロードしたのに反映されない | SFTP転送成功と楽天側のCSV取込処理の切り分け |
ファイルのSFTP送信が完了しても楽天側の取り込みに失敗することがあります。送信結果と楽天側の取込結果を別々に確認しましょう。
CSV項目を確認したあと、検証・SFTP送信を効率化
商品CSVの項目・必須条件を確認してファイルを作成したら、送信前の検証とSFTPアップロードも重要です。
RMS Workbenchでは、作成済みCSVの形式検証・楽天SFTPへの今すぐ送信・予約送信・実行履歴の確認をまとめて管理できます。セール用の開始・終了CSVをあらかじめ登録しておく運用にも使えます。
RMS Workbenchは楽天CSVの全項目の正しさを保証するものではありません。
ジャンル固有の必須属性、価格や商品説明などの業務上の正確性は店舗側と楽天の最新仕様で確認してください。また、予約日時はCSVをSFTPへ送る時刻であり、楽天側の更新完了時刻ではありません。
ジャンル固有の必須属性、価格や商品説明などの業務上の正確性は店舗側と楽天の最新仕様で確認してください。また、予約日時はCSVをSFTPへ送る時刻であり、楽天側の更新完了時刻ではありません。
楽天CSVの項目についてよくある質問
楽天CSVの必須項目は何ですか？
normal-item.csvでは商品管理番号（商品URL）、新規登録時の商品名・ジャンルID、SKU管理番号、通常購入販売価格、在庫数などを優先的に確認します。ただし新規登録・更新、商品やSKUの構成、ジャンルにより条件が変わるため、最新のRMSの項目定義が最終基準です。
商品管理番号はどのレベルの行にも必要ですか？
商品管理番号（商品URL）は商品・SKU・商品オプションなど、関連する各行の対象商品を特定する重要な項目です。商品とSKUの対応が崩れないよう確認してください。
通常購入販売価格は商品レベルに入力しますか？
いいえ。通常購入販売価格はSKUレベルの項目です。サイズ・カラーがある商品はSKUごとに価格を確認してください。
楽天CSVの空欄と列の省略は同じですか？
同じとは限りません。列の省略と空欄による更新動作は項目・操作によって異なります。変更しない項目や設定解除を行う項目はRMSの最新仕様で確認し、少数商品で動作検証してください。
item-cat.csvにもコントロールカラムはありませんか？
item-cat.csvはnormal-item.csvとは別の仕様です。SKU対応後のnormal-item.csvでは旧item.csvのn・u・d指定を使いませんが、item-cat.csvの項目構造は異なるため、ファイルごとの公式仕様を確認してください。
まとめ
楽天CSVの項目を確認するときは、まずnormal-item.csvの行の種類を理解し、商品レベル・SKUレベル・商品オプションのどこに設定するのかを整理しましょう。商品管理番号やSKU管理番号などの識別子、SKU価格、画像タイプ・パス、商品属性の組合せを確認するとミスを減らせます。
必須項目と空欄の更新ルールは商品や操作によって異なるため、最新のRMS資料・サンプルを使い、必要な項目を絞って編集してください。CSV作成後の形式検証・SFTP送信・送信予約にはRMS Workbenchも活用できます。
参考資料：楽天公式：CSV商品一括編集機能、商品情報CSV（normal-item.csv）の項目対応表（外部サービス）。掲載したのは主要項目の抜粋です。楽天の項目名・必須条件・利用可能な機能は変更される場合があります。最新の正確な条件はログイン後の楽天RMS・店舗運営Naviで確認してください。RMS Workbenchは楽天グループ株式会社の公式サービスではありません。