ホーム > 楽天店舗・RMS
楽天のCSVアップロードが反映されたか確かめる方法|処理状況とエラーの見方

アップロード後は「CSVファイルダウンロード画面」の処理状況を目安に、個別の処理完了とエラーの有無を確認します。 処理が終わっても、商品ページとダウンロードし直したCSVを照合し、変更した内容まで確かめる必要があります。 エラー時は文字コード・必須項目・列名・コントロールカラムを点検し、詳しい仕様はRMSのマニュアルで確認できます。
反映を確かめる手順

楽天のCSV反映は、送信履歴、処理結果、再取得データ、商品ページの順に確認すると漏れを防ぎやすくなります。
楽天の公開案内では、商品一括編集機能は商品データのCSVをFTPでRMSへアップロードする仕組みと説明されています。ここでいう転送ソフトは、このFTP送信に使うソフトのことです。楽天市場「サービス・料金詳細」
転送ソフトの送信完了だけでは、商品情報の更新や商品ページへの反映まで完了したとは判断できません。
- 送信したファイルを特定します
転送ソフトの履歴で、対象店舗、送信日時、ファイル名を確認し、予定したCSVと一致するか照合します。
- システム全体の処理状況を確認します
RMSの「CSVファイルダウンロード画面」最上部で、混雑状況を確認し、次の作業を進める目安にします。
- 個別の処理結果とエラーを確認します
対象CSVの結果確認方法をRMSの管理画面内の案内から辿り、取得した結果が今回の送信分か確かめます。
- 商品情報をダウンロードし直します
更新対象の商品情報を再取得し、商品管理番号やSKU管理番号を使って、変更予定の値と照合します。
- 対象の商品ページを直接開きます
商品名、価格、説明文、画像など、今回変更した項目が購入者向けの表示にも反映されたか確認します。
- 不一致と未確認の対象を記録します
全体を一括で完了扱いにせず、確認済みの商品と、修正や再確認が必要な商品を分けて管理します。
CSVアップロードの処理状況表示の見方
処理状況の「正常」「やや遅延」「遅延」は、全店舗に共通するシステムの状態を示す表示です。
「CSVファイルダウンロード画面」の最上部には、次の処理状況とメッセージが表示されます。
| 処理状況 | 表示されるメッセージ | 確認するときの注意点 |
|---|---|---|
| 正常 | 10分以内に完了見込みです。 | 自店のCSVが正常終了したという意味ではありません |
| やや遅延 | アクセス集中により、処理完了まで10分以上かかる見通しです。 | システム全体で混雑していることを示します |
| 遅延 | アクセス集中により、処理完了まで大幅に時間がかかる見通しです。 | 個別ファイルの完了時刻を示す表示ではありません |
これらは、自店がアップロードしたCSVの進捗や成功・失敗を直接示すステータスではありません。
「正常」と表示されていても、それだけで確認を終えず、個別の処理結果と実際の登録内容を照合してください。
楽天のCSV反映までにかかる時間
確認できる時間の目安は処理状況表示の内容までであり、個別ファイルの反映完了時刻は保証されていません。
「正常」では10分以内の完了見込みが示されますが、アップロードから必ず10分で反映するとはいえません。
| 時間に関する確認事項 | 確認できる範囲 |
|---|---|
| 正常時の目安 | 処理状況表示では「10分以内に完了見込み」と案内されています |
| やや遅延時の目安 | アクセス集中により、10分以上かかる見通しと案内されています |
| 遅延時の具体的な分数 | 公開情報では確認できません |
| 商品件数や容量ごとの所要時間 | 公開情報では確認できません |
| 処理完了後、商品ページに表示されるまでの保証時間 | 公開情報では確認できません |
経過時間だけで再送を決めず、処理結果と再取得データを確認してから、次の対応を判断する運用を勧めます。
問い合わせる場合は、送信日時、ファイル名、対象商品、期待した変更内容をまとめると状況を説明しやすくなります。
エラーの主な原因

CSVが反映できないときは、保存形式だけでなく、必須項目、列名、レベル行、ファイル名まで順に点検します。
入力を誤ると、取り込みエラーに加えて、別の商品が更新されたり、新規商品として登録されたりする恐れがあります。
| 原因 | 症状・起こり得ること | 直し方 |
|---|---|---|
| 文字コード・保存設定の変更 | 日本語や記号が変化し、入力内容を正しく扱えない可能性があります | 編集前後の文字と保存設定を比べ、対象CSVの指定形式に合わせます |
| 機種依存文字の使用 | 文字の除去、変換、エラーによる処理終了のいずれかが起こります | エラーログの該当箇所を確認し、使用文字を修正します |
| 必須項目の不足 | 必須列がない場合や、必須の値が空欄の場合にエラーになります | 登録・更新それぞれの必須条件と照合します |
| 列名の誤り | 正しい項目名で作成するルールを満たせません | 正式な列名に戻し、独自の見出しへ置き換えないようにします |
| レベル行の取り違え | 商品・商品オプション・SKUの情報が正しい行に入りません | 項目の所属するレベル行へ値を移します |
| 判定用項目への不要な入力 | レベル行の判定条件から外れ、エラーになる場合があります | 商品管理番号、選択肢タイプ、SKU管理番号の組み合わせを直します |
| 商品管理番号の空欄 | 商品とオプション・SKUを正しく紐付けられません | すべてのレベル行に商品管理番号を入力します |
| 対になる列の不足 | 画像や期間設定を片方の列だけで設定しようとしています | 画像タイプとパス、期間の開始と終了などを確認します |
| ファイル名の誤り | ファイルが取り込まれず、処理されません | 種類ごとの命名規則に合わせて保存します |
| コントロールカラムの誤用 | 対象外のCSVへの指定や、意図しない削除につながります | 使用できるファイルと、指定値の意味を確認します |
文字コードは推測で変換せず、まず保存設定を確認し、対象CSVの指定形式と一致しているかを確かめてください。
楽天側でEUCへ変換してバイト数を計算する説明は、アップロード用の保存文字コードを指定する説明とは別です。
normal-item.csvのレベル行を見分ける方法
normal-item.csvでは、次の組み合わせでレベル行が判定され、これ以外の組み合わせはエラーになります。
| レベル行 | 商品管理番号 | 選択肢タイプ | SKU管理番号 |
|---|---|---|---|
| 商品レベル行 | 入力 | 空欄 | 空欄 |
| 商品オプションレベル行 | 入力 | 入力 | 空欄 |
| SKUレベル行 | 入力 | 空欄 | 入力 |
商品名は商品レベル行に、販売価格や在庫数はSKUレベル行に入力し、異なるレベルの情報を混在させないようにします。
シングルSKUでも商品レベル行とSKUレベル行が必要であり、同じ商品管理番号の関連行は連続させて入力します。
CSVファイル名とコントロールカラムの確認方法
ファイル名とコントロールカラムはCSVの種類ごとに異なるため、以前のファイルを流用するときも確認が必要です。
| CSVの用途 | アップロード時のファイル名 | コントロールカラム |
|---|---|---|
| 商品登録・更新 | 先頭を「normal-item」にします | SKU対応版以降は廃止されています |
| 商品・SKUなどの削除 | 先頭を「item-delete」にします | 使用できません |
| カテゴリと商品の紐付けなど | 必ず「item-cat.csv」にします | n・u・dを使い分けます |
ダウンロードした「dl-」で始まるファイル名のまま送ると取り込まれないため、送信前に名前を確認してください。
ファイル名本体で使える文字は半角英数字、ハイフン、アンダースコアであり、全角文字などは使えません。
| item-cat.csvの指定値 | 処理内容 | 注意点 |
|---|---|---|
| n | 新規登録 | 新しいカテゴリとの紐付けに使います |
| u | 更新 | 更新できるのは「優先度」のみです |
| d | 削除 | 既存の紐付けを解除するときに使います |
別カテゴリへ紐付けを変更する場合は、既存の紐付けをdで削除してから、新しい紐付けをnで指定します。
CSVをダウンロードし直して差分を確認する方法
反映後のCSVは、行番号ではなく商品管理番号などで対応付け、変更予定の値と実際の登録値を比較します。
登録後の値はRMSの「CSVダウンロード」で取得でき、「CSV項目の選択」または「全項目」で確認できます。
- 編集前のCSVを保存します
商品情報ならnormal-item.csv、カテゴリ設定ならitem-cat.csvを取得し、更新前の状態を残します。
- 変更予定の項目と値を整理します
送信前の値、変更後に期待する値、対象の商品やSKUを、照合できる形で一覧にしておきます。
- 処理後のCSVを再取得します
取得日時を記録したうえで、今回変更した項目を含む商品情報をダウンロードし直します。
- 対象の欠落・重複と値を確認します
商品管理番号、レベル行、SKU管理番号などで対応付け、未取得の対象と不一致の項目を抽出します。
| 比較するデータ | 確認する内容 |
|---|---|
| 編集前と変更予定 | 今回変更する対象と項目が正しいか |
| 変更予定と再取得後 | 期待した値が登録されているか |
| 編集前と再取得後 | 予定していない項目まで変わっていないか |
スプレッドシートでVLOOKUPを使う場合は、検索キーの重複を先に確認し、完全一致で値を取得する方法が適しています。
商品管理番号だけでは複数のレベル行が該当するため、SKUなどの識別情報も含めて照合する必要があります。
ダウンロード時は最大列数で出力される項目もあり、アップロード時とはデータの記載が異なる場合があります。
ファイル全体の一致だけで判定せず、対象の識別情報と変更項目の値を比べることで、必要な差分を確認できます。
商品ページで反映を確認する項目
再取得したCSVの値が合っていても、対象の商品ページを開き、購入者に見える内容まで確認する運用を勧めます。
| 変更した項目 | 商品ページでの確認内容 |
|---|---|
| 商品名 | 変更した文言が表示されているか |
| 販売価格 | 対象SKUを選んだ状態で、意図した価格になっているか |
| 商品説明 | 追記・削除が反映され、表示が崩れていないか |
| 商品画像 | 画像の内容と順序が正しく、画像切れがないか |
| バリエーション | 選択肢名と選択後の表示が意図どおりか |
| スマートフォン用説明文 | スマートフォン向けの表示でも変更を確認できるか |
検索結果で見つかるかどうかとは分け、まず対象の商品URLを直接開いて、今回変更した内容を照合してください。
一部の商品を抽出して確認した場合は、全件確認した記録と区別し、確認範囲と未確認の対象を残します。
CSV処理中の同時編集と上書きの注意点
CSV処理中もRMS画面やAPIから編集できますが、最後に処理された情報が反映されるため注意が必要です。
| 処理の順番 | 起こり得ること |
|---|---|
| RMS画面・APIの更新後にCSVが反映 | 画面やAPIで更新した内容がCSVの情報で上書きされます |
| CSVの反映後にRMS画面・APIが更新 | CSVで更新した内容が画面やAPIの情報で上書きされます |
カテゴリ名を処理中に変更すると、CSVが参照する旧カテゴリ名が存在せず、新規カテゴリが生成される場合があります。
たとえば「レディース/ワンピース/楽天」を「レディース/ワンピース/Rakuten」へ変更した場合が該当します。
CSVが旧名称で紐付けると両方のカテゴリが残るため、カテゴリ変更とCSV処理の作業時間を分ける運用が安全です。
CSVアップロードの日時・ファイル名・件数の記録
アップロードの記録は、送信した事実と反映確認の結果を結び付け、再送や問い合わせに使える形で残します。
| 記録項目 | 残す内容 |
|---|---|
| 対象店舗・担当者 | 作業対象の店舗と実施者、確認者 |
| アップロード日時 | 送信開始・終了の日時 |
| ファイル名 | 実際に送った名前と、手元の保存先 |
| 件数 | 対象商品数、対象SKU数、CSVのレコード数を区別 |
| 変更内容 | 対象項目、変更前の値、期待する値 |
| 処理結果・エラー | 取得日時、表示内容、対象の商品やSKU |
| 差分・表示確認 | 再取得日時、不一致、確認済みの範囲 |
| 再送履歴 | 修正版の保存先、再送対象、送信日時 |
説明文に改行が含まれるCSVでは、テキスト上の行数とレコード数が一致しないため、件数の定義も明記します。
送信済みCSVは上書きせず、編集前、送信版、修正版、再取得版を分けて保存すると、変更の経緯を追いやすくなります。
CSVの再アップロードと解約前の確認
再送前には最新の登録内容を確認し、解約前にはすべての商品ページへの反映が終わったことを確認します。
- エラー内容と送信済みCSVを照合し、修正が必要な商品・SKUと項目を特定します。
- 最新の登録内容を確認し、他の担当者やAPIによる変更を上書きしないか点検します。
- 必須項目と必要な関連行を残して修正版を作り、送信後に差分と商品ページを確認します。
空欄で更新すると既存値が削除されたり、初期値へ戻ったりする項目があるため、空欄を「変更なし」と扱わないでください。
反映前にCSV商品一括編集機能を解約すると、アップロードが完了していても商品ページへ反映されません。
再契約時の未反映データについては、RMSの説明に「削除される」と「反映され上書きされる」の食い違いがあります。
どちらかの挙動を前提にせず、全ページの反映を確認してから解約し、不明点はRMSの管理画面内の案内で確認してください。
よくある質問(FAQ)
反映確認で迷った場合は、システム全体の表示、個別の処理結果、実際の登録内容を分けて判断してください。
「正常」と表示されたら反映完了ですか?
いいえ、「正常」は全店舗共通のシステム状況であり、自店のCSVが正常終了したことを示す表示ではありません。
FTPの送信は終わったのに反映できないのはなぜですか?
FTPの送信完了は、ファイルが届いたことの確認にとどまります。ファイル名の誤りでは取り込まれず、必須項目や列名の誤りではエラーになるため、処理結果とエラーの内容を先に確認してください。
10分待っても反映されない場合は再送すべきですか?
経過時間だけで再送せず、処理結果、エラー、再取得した商品情報を確認してから、再送の必要性を判断してください。
エラーがあればファイル全体が失敗していますか?
エラー内容ごとの部分反映の扱いは、公開情報では確認できません。対象ごとの登録内容も確認してください。
商品オプションの順番はCSVの行を並べ替えれば変わりますか?
商品オプション項目名の順番は、item-delete.csvで一度削除し、normal-item.csvで希望する順に登録し直します。
R-Cabinetの結果メールが届いたのにエラーログがありません
画像一括登録では、成功時もエラー時も自動配信メールが届き、エラーログはエラーがある場合に作成されます。
画像の登録結果と商品CSVの処理結果は対象が異なるため、商品情報への反映は別に確認する必要があります。
店舗の「次の一手」を一緒に進めるなら
AI社員アプリ・運営代行・ECコンサルまで、現場を知るチームがワンストップで伴走します。
西尾 勝太株式会社ラクダ 代表
楽天SOY 2年連続受賞 / 楽天NATIONSリーダー店舗 / 楽天NATIONS AIエバンジェリスト
楽天市場の月商を5年で200万円→2億円に伸ばした現場の実践者。売れるECの方程式にAIを重ね、EC事業者の「次の一手」に伴走しています。
西尾勝太のブログを読む




