楽天市場のAPI連携が止まる前に確認すること｜ライセンスキー90日・認証エラー・取込対象外の受注

楽天のAPI連携が止まる原因は、期限・認証・取込対象の3つに集まる

楽天市場は、国内ECの中心的なモールです。楽天グループの決算では、国内ECの流通総額について、次のように発表されています。

2026年度第2四半期の国内ECにおける流通総額（注4）は、1兆5,322億円（前年同期比5.3％増）に

出典：楽天グループ株式会社「2026年度第2四半期 決算ハイライトに関するお知らせ」（2026年8月10日）

モール全体の取引が伸びるなかで、店舗の受注は増えていきます。国土交通省の取扱実績でも、荷物の数は高い水準です。

令和６年度の宅配便取扱個数は、50億3147万個で、前年度と比較して2414万個・約0.5%の増加となった。

出典：国土交通省「令和６年度 宅配便・メール便取扱実績について」

受注が増えるほど、API連携が止まったときの影響も大きくなります。楽天の連携が止まる原因は、STOCKCREWのヘルプを読むと、次の3つに整理できます。

止まる原因の3分類

どの原因も、あらかじめ運用のルールを決めておくと防げます。ほかのモール・カートの連携の例は、Qoo10のAPI連携で押さえる仕様、ショップサーブのAPI連携で押さえる仕様、ECカート別の発送代行連携を比較でも整理しています。API連携の全体像はECカートと発送代行のAPI連携とはで確認できます。

なお、楽天のAPI連携は、STOCKCREWの「連携できる外部サービス一覧」でも、楽天APIは定期的にlicenseKeyの更新を実施する必要があると注記されています。導入前の段階から、更新の運用を想定しておくと安心です。

連携の設定は「RMS」と「SCシステム」の2段階

楽天とのAPI連携を設定すると、受注情報と在庫情報をSCシステムと自動で連携できます。設定は、楽天RMSでWEB APIサービスを申し込み、必要なAPI機能を有効にして、3つの情報を取得し、SCシステムに登録するという流れです。

設定の前に確認する2つの前提

• SCシステムにEC店舗が登録されていること——未登録の場合は、先に店舗設定から登録します。
• 楽天のSKUプロジェクトに対応していること——未対応の場合は、API連携が正常に行えない可能性があるため、SKUプロジェクトへの移行対応が必要です。

API連携を始める前に、商品マスタの登録も済ませておきます。ヘルプでは、商品の登録をする前にAPI連携をすると、受注は取り込まれても引当がされず、発送処理もされないと案内されています。

楽天RMSで必要な3つのAPI機能を有効にする

RMSの「アプリ一覧」から利用機能を編集し、次の3つの機能が、すべて「利用する」に設定されていることを確認します。ここが一部でも無効だと、後述の認証エラーの原因になります。

1. 在庫API
2. 商品API
3. 楽天ペイ受注API

RMSで控える3つの情報

WEB APIの設定画面で、次の3つを確認して控えます。これをSCシステムの連携設定画面に入力します。

SCシステムの店舗設定で、対象店舗の「楽天」ボタンを押し、3つの情報を入力します。そして「楽天SKUプロジェクト適用済み」にチェックを入れて「登録」を押します。出店プランごとの費用の違いは、楽天市場の出店プランと費用・料金体系｜楽天市場出店で確認できます。

ライセンスキーは90日で切れる：更新の流れ

楽天のAPI連携で、最も忘れやすいのがライセンスキーの更新です。楽天市場のWEB APIサービスでは、ライセンスキーの更新が定期的に必要で、有効期限は90日です。有効期限が過ぎると、API連携が解除されます。

期限が近づくと、楽天からメールが届く

有効期限が近づくと、楽天から「【楽天市場】licenseKeyの有効期限のお知らせ」というメールが送られてきます。このメールを受け取ったら、SCシステムの画面で更新の操作を行います。メールの宛先が、普段あまり見ない共有のアドレスになっていると、気づかずに期限が切れかねません。RMSに登録しているメールを、担当者が確認できる状態にしておきます。

更新するときは、新しいライセンスキーを発行する

ライセンスキーを更新する場合は、RMSで「新しいライセンスキーを発行」します。発行したキーを、SCシステムの店舗設定の楽天の連携設定画面に入力し直します。更新の具体的な画面操作は、STOCKCREWのヘルプ「API連携を行うための設定（楽天）」の手順に沿って進めます。期限が切れてから気づくと、その間の注文は連携されないため、メールが届いた時点ですぐ更新する運用をおすすめします。

Un-Authorisedエラーが出たときの3つの確認

連携中に、次のようなエラーメッセージが表示されることがあります。これは、APIの認証に失敗していることを示します。

楽天:在庫数の変更v2 APIエラー:{ "errors": [ { "code": "GA0001", "message": "Un-Authorised" } ] }

このエラーが出たら、次の3つを順に確認します。

確認1：serviceSecretとlicenseKeyが正しいか

SCシステムの連携設定に入力したserviceSecretとlicenseKeyが、RMSで確認できる値と同じかを見ます。ライセンスキーを更新したのに、SCシステム側の入力が古いままだと、この確認に引っかかります。

確認2：RMSのAPI利用設定が有効か

RMSで、次のAPI利用設定が有効になっているかを確認します。楽天ペイ受注API、在庫API、商品APIの3つです。設定時に有効にしたものが、あとから変わっていないかを見直します。

確認3：licenseKeyの期限が切れていないか

最後に、licenseKeyの有効期限が切れていないかを確認します。期限が切れていた場合の更新の流れは、第3章のとおりです。3つのうち、期限切れは「気づかないうちに起きる」ため、最も見落としやすい原因です。

受注取込の対象と、API連携で自動にならない作業

楽天RMS上の注文情報は、ステータスに応じて、自動でSCシステムに取り込まれます。ただし、取込の対象外の受注と、APIでは連携されない作業があります。ここを知らないと、「注文が入っているのに倉庫に届かない」「お客さまにメールが届いていない」という問い合わせの原因になります。

取り込まれる受注のステータス

API連携で取り込まれるのは、次の3つのステータスの受注です。

• 注文確認待ち
• 楽天処理中
• 発送待ち

「注文確認待ち」「楽天処理中」で入金が未完了の場合、受注データは「入金待ち」ステータスで取り込まれます。楽天側で入金が完了すると、SC側のステータスも「入金済み」に更新され、自動的にSCシステム上で出荷待ちになります。入金の確認を、人が手で取り次ぐ必要はありません。

頒布会と予約注文は、CSVで手動取込になる

次の2つの受注は、API取込の対象外です。CSVでの手動取込が必要になります。

1. 頒布会注文
2. 予約注文

定期的に商品を届ける頒布会や、発売前に受け付ける予約注文を扱う店舗は、API連携を入れても、これらの注文だけは別の手順で倉庫に渡す必要があります。予約販売や定期販売を行う場合の出荷の考え方は、Shopifyでサプリを売る事業者の発送代行ガイドのような商材別の記事でも触れています。

サンクスメールとステータス変更は、RMSでの手動操作が必要

次の2つの処理は、APIでは連携されていません。楽天RMS上での手動操作が必要です。

楽天で連携を続けるための運用チェックリスト

ここまでの内容を、運用のチェックリストにまとめます。連携を始める前と、始めたあとの両方で使えます。

連携を始める前の確認

1. SCシステムにEC店舗を登録したか——未登録なら、先に店舗設定から登録します。
2. 楽天のSKUプロジェクトに対応しているか——未対応のままだと、連携が正常に行えない可能性があります。
3. 商品マスタの登録が済んでいるか——登録前の連携では、受注は入っても引当・発送がされません。
4. RMSで3つのAPI機能が「利用する」になっているか——在庫API、商品API、楽天ペイ受注APIです。

連携を始めたあとの運用

1. ライセンスキーの更新日を決める——有効期限は90日です。メールを見る担当者も決めておきます。
2. 頒布会・予約注文の取込手順を決める——CSVでの手動取込を、誰がいつ行うかを決めます。
3. サンクスメールとステータス変更の担当を決める——API連携では自動にならない作業です。
4. エラーが出たら、3つの確認の順で見る——入力情報、RMSのAPI設定、期限の順です。

楽天のほかに、複数のモールやカートで販売している事業者は、受注の経路を整理しておくと、問い合わせの原因を絞りやすくなります。複数モールで在庫を共有する場合は、複数ECモール同時出店の物流一元管理と在庫配分設計も確認します。楽天市場の出荷を自社と外部のどちらで運用するかは楽天倉庫（RSL）とSTOCKCREWの比較で整理しています。導入時の費用や条件は、STOCKCREW完全ガイドで確認できます。

まとめ：楽天の連携は「90日の更新」と「対象外の受注」を押さえる

楽天市場のAPI連携で押さえておきたいのは、ライセンスキーの有効期限は90日で、切れるとAPI連携が解除されること、Un-Authorisedエラーは、入力情報・RMSのAPI利用設定・期限の3つで切り分けられること、頒布会と予約注文はCSVでの手動取込になり、サンクスメールとステータス変更はRMSで手動操作が必要なことの3点です。連携の設定では、RMSで在庫API・商品API・楽天ペイ受注APIを有効にし、serviceSecret、licenseKey、店舗URLをSCシステムに登録します。

発送代行の仕組みや業者の比べ方は発送代行おすすめ25選、物流全体の設計はEC物流完全ガイド、モール運営はネットショップの始め方、サービス内容はSTOCKCREW完全ガイドにまとめています。自社の商品数や出荷件数で費用を確かめたい場合はお問い合わせから、まずは情報を集めたい段階であれば資料ダウンロードをご利用ください。