楽天の商品データで商品を登録(API)【楽天市場】 ID:56642

楽天の商品データをAPIで取り込み、本システムの商品管理に「商品情報」「在庫数」「店舗別ページ」を新規登録する操作手順のご案内です。
また、同時にモール商品CSVファイル(在庫連携対象となる商品のデータ)の取り込みも行いますので、モール商品一括登録を行わず、在庫連携を行なうことが可能となります。

※楽天SKU以降済み店舗のみ利用可能です。

1.事前の確認事項

■API設定
本機能のご利用にはAPI連携に必要な認証情報の登録、[設定]→[基本]→[API]にて「楽天SKU移行状況」を有効にする必要があります。
API申請、認証情報の登録方法は以下マニュアルをご参照ください。

ご利用前の準備|1-2.APIで在庫連携を行う場合 API認証情報の登録

■登録可能な商品
本機能のご利用前に、必ず楽天と商品コードの統一を行ってください。
楽天にて「商品番号」「システム連携用SKU番号」が、本システムの商品コードルールに沿って登録されているされている商品のみ登録可能です。

<本システムの商品コードルール>
使用可能文字 :半角英字、半角数字、半角ハイフン(-)、半角アンダーバー(_)のみ
文字数制限  :30字以内

<本機能 商品登録時の動き>

単品商品   :楽天の「商品番号」を『商品コード』として登録

選択肢つき商品:楽天の「商品番号」を『代表商品コード』
楽天の「システム連携用SKU番号」を『商品コード』として登録

商品コードのルール

■バリエーション商品登録時の注意
楽天にて「システム連携用SKU番号」が未登録の場合、商品登録は行われません。

■商品番号、システム連携用SKU番号が重複している場合
重複した商品の内、1商品のみ登録されます。

■セット商品・コピーページ商品を取り扱っている場合
セット商品販売を行っている商品も商品管理に登録されます。
セット商品・コピーページ商品は、商品管理より削除し、別途セット商品管理への登録を行ってください。

商品管理データの削除(マスタ削除) セット商品の登録

■モール商品CSVの取込(在庫連携の対象にする)について
オプションにて「在庫連携の対象にする」を選択した場合、「対象商品を指定」にて指定されたすべての商品のモール商品CSV取り込みを行います。
対象に含まれない商品は、別途モール商品一括登録を行ってください。

在庫連携対象となる商品データの出力 在庫連携対象となる商品データの取込

■取り込み中に棚卸を行った場合
直近の100件のみ取り込み、処理が中断されます。棚卸し終了後に再度操作を行ってください。

■すでに商品管理に登録済みの商品
登録済みの商品に対して、更新、画像/在庫数の登録、店舗別ページの作成/更新は行われません。
登録済みの商品にRMSにてバリエーションの追加を行った場合は、未登録のバリエーションを追加登録します。

■店舗別ページのみ作成済みの商品
商品管理に登録なし(マスタ削除)、店舗別ページのみ作成済みの場合、「ページの詳細情報を取り込む」を選択した際に店舗別ページの内容が更新されます。

■楽天にてSKU管理番号を変更した場合
本機能にて登録した商品の「SKU管理番号」が楽天側で変更となった場合、別途モール商品CSVのアップロードが必要です。
アップロードを行わない場合、該当商品は在庫連携ができません。

2.操作手順

【本システム画面】

  1. [商品]より[商品管理の一括登録]をクリック
  1. 「モール・カートのAPIで商品を登録する」を選択
  2. 店舗を選択

    ※SKU移行済み店舗のみ対象となります。
    一覧に表示されない場合、[設定]→[基本]→[店舗]にて「SKU移行状態(商品管理)」にチェックを入れてください。

  3. 取込対象の商品を選択

    ・全商品
    RMSに登録されているすべての商品が対象となります。

    ・一部の商品(RMS最終更新日で絞り込み)
    RMSの最終更新日で絞り込みます。

    選択時のみ表示

  4. オプションを選択

    ・ページの詳細情報を取り込む
    店舗別ページ(楽天形式の商品ページデータ)を作成します。作成したデータを元に、各店舗の商品ページの作成・更新ができます。
    商品管理に取り込まれる項目は3.取り込み対応項目をご参照ください。

    ページ作成とは?

    ・商品画像を取り込む
    楽天RMS上で登録している商品画像(1)〜(20)とそれぞれの名称(ALT)を画像管理に登録します。
    SKU画像と白背景画像は登録しません。

    ・在庫数を取り込む
    楽天の在庫数を商品に登録します。

    ・在庫連携の対象にする
    モール商品CSVの取り込みを行います。
    新規登録がスキップされた登録済み商品も対象となります。

  5. [取り込み開始する]をクリック
  1. [OK]をクリック


取り込みが開始される

画面下部に下がる

  1. 「APIから取り込んだ商品一括登録の状態・履歴」にて[詳細を確認]をクリック

    ※「APIから取り込んだ商品一括登録の状態・履歴」は、取り込み方法を選択にて「APIから取り込む(楽天のみ)」際のみ表示されます。

  1. 処理結果を確認

    ※エラーが表示されている場合、商品管理番号などをコピーのうえ、楽天にてエラー内容を修正し、再度取り込みを行ってください。

取り込み状況の表示

取り込み状況については、商品管理の一括登録の画面上部にも表示されます。

※[取込予約する]をクリック直後は、商品管理の一括登録画面を開き直すことで表示されます

※件数は代表商品コード単位での表示です

■取り込み状況

※処理開始直後の場合(0 / 0件)と表示される場合がありますが、順次正しい件数に更新されます。

■取り込み結果

3.取り込み対応項目

商品管理に登録される項目の一覧です。
※項目変換設定「基本 ← 楽天」にて初期値をご利用の場合の登録内容となります。

本システム項目名 楽天項目名
単品 項目選択肢つき
商品コード 商品番号 システム連携用SKU番号
代表商品コード 商品番号
仕入先 9999:設定無し 9999:設定無し
商品名 商品名 商品名 + 横軸選択肢名 + 縦軸選択肢名
原価 0 0
売価 販売価格 販売価格 (商品単位 または SKU単位)
ページコード システム連携用SKU番号 システム連携用SKU番号
掲載商品名 商品名 商品名
商品情報→バリエーション システム連携用SKU番号、商品名、販売価格 (商品単位 または SKU単位)

「ページの詳細情報を取り込む」を選択した場合は、下表の項目を追加で取り込みます。

本システム項目名 楽天項目名 備考
商品名 掲載商品名
公開・非公開 倉庫指定 0:販売中 → 1:表示
1:倉庫に入れる → 0:非表示
説明文1(PC) PC用商品説明文
説明文2(スマホ) スマートフォン用商品説明文
説明文4 PC用販売説明文
送料区分 送料 0:送料別 → 0:送料別(個別)
1:送料無料 → 2:送料込(無料)
個別送料 個別送料
代引料(代引区分) 代引料 0:代引料別 → 0:代引料別(個別)
1:代引料込み → 1:代引料込(無料)
注文受付区分 注文受付数 空欄 → 空欄
0 → 1:指定欄なし(1個限定)
1~ → 2:個数選択(プルダウン)
注文受付数 注文受付数
在庫表示 在庫表示 -1:残り在庫数表示する → 1:残り在庫数表示する
0:残り在庫数表示しない → 0:残り在庫数表示しない
1から20:指定の数で△表示 → 2:在庫僅少表示
在庫僅少表示閾値 在庫表示 -1:残り在庫数表示する → 【empty】
0:残り在庫数表示しない → 【empty】
1から20:指定の数で△表示 → 空欄
ポイント変倍率 ポイント  
ポイント適用期間 開始日 ポイント変倍率適用期間(開始日時)  
ポイント適用期間 開始時間 ポイント変倍率適用期間(開始日時)  
ポイント適用期間 終了日 ポイント変倍率適用期間(終了日時)  
シークレットパスワード 闇市パスワード  
モール基本カテゴリID ジャンルID  
定価 表示価格 open:「オープン価格」を表示する → 空白
商品区分 注文ボタン 0:ボタンつけない → 0:通常
1:通常注文ボタンをつける → 0:通常
2:予約注文ボタンをつける → 10:予約
JANコード カタログID  
発売日 予約商品発売日  
販売開始日 販売期間指定(開始日時)  
販売終了日 販売期間指定(終了日時)  
消費税 消費税 0:消費税別 → 0:税別
1:消費税込 → 1:税込
のし対応 のし対応 0:対応しない → 0:対応しない
1:対応する → 1:対応する
オプション オプション  
カテゴリ 店舗内カテゴリ1 ~ 10  

4.エラーの対応方法

エラー内容は選択した登録先ごとの処理結果(◯:成功/✕:失敗)と、エラー内容の詳細が「メッセージ」に表示されます。
各商品のエラー内容を修正のうえ、再度登録を行ってください。

■商品が「✕」の場合

商品管理への商品登録が失敗しています。
「メッセージ」の内容を確認し、楽天にてエラー内容を修正のうえ、再度APIによる取り込みを行ってください。

楽天側の修正項目については「3.取り込み対応項目」の「楽天項目名」をご参照ください。

■ページ、画像が「✕」の場合

エラー項目を楽天側で修正するか、項目変換設定の内容を確認し、以下の対応を行ってください。
楽天側の修正項目については「3.取り込み対応項目」の「楽天項目名」をご参照ください。

処理結果 ページ「✕」 画像「✕」
商品の登録「◯」

商品管理より商品を削除し登録をやり直すか、店舗別ページのみ別途登録を行ってください。

商品管理より商品を削除し登録をやり直すか、画像のみ別途登録を行ってください。

商品の登録「✕」 「メッセージ」表示されたエラー内容を修正の上、再度APIでの取り込みを実行

関連するアプリの記事

関連する記事がみつかりませんでした。

関連するQ&Aの記事

関連する記事がみつかりませんでした。