↗付きの用語リンクは、別タブで説明を開きます。
クロスマと楽天市場の連携では、楽天市場のWEB APIライセンスキーを定期的に更新する必要があります。期限を過ぎると商品・受注・在庫などのAPI連携が止まり、停止中のデータがクロスマへ反映されない可能性があります。
楽天市場とクロスマの連携を継続するために、認証情報の更新期限、再発行、反映待ち、再設定後の確認を順に整理します。更新しただけで終わらせず、連携が再開したことまで確認しましょう。
結論：期限確認、RMSでの更新、反映待ち、クロスマ再設定を分けて進める
楽天APIの更新は、次の順番で進めると現在地を見失いにくくなります。
- クロスマの通知とRMSで、ライセンスキーの有効期限を確認する
- 更新前の連携状態と未反映の可能性がある注文・商品を記録する
- RMSで新しいライセンスキーを発行する
- 新しいキーが有効になるまで公式案内の時間を待つ
- クロスマのモール設定で楽天市場のライセンスキーを更新する
- 商品・受注・在庫の各連携と、停止中の未反映データを確認する
エラーが出たら、すぐに何度もキーを作り直すのではなく、「期限切れ」「入力値」「反映待ち」「一時的なAPIエラー」「権限・店舗設定」のどこで止まっているかを切り分けます。
楽天APIの期限切れで起こり得ること
| 症状 | 起こり得る影響 | 最初に確認すること |
|---|---|---|
| 商品情報を取得・更新できない | 価格、在庫、商品情報の変更が販売先へ反映されない | ライセンスキーの期限、エラー内容、商品紐付け |
| 受注がクロスマへ入らない | 出荷処理や在庫連動の開始が遅れる | 楽天側の注文、取得時刻、API認証、注文取得設定 |
| 在庫が更新されない | 欠品や販売機会損失につながる可能性がある | 基準在庫、直近の連携成功時刻、API認証 |
| 認証エラーが表示される | 楽天市場とのAPI処理が実行できない | 期限、入力値、反映待ち、権限 |
クロスマの公式マニュアルでは、楽天市場のライセンスキーの有効期限は90日と案内されています。これは2026年8月29日時点の確認内容であり、実作業ではRMSと最新の公式マニュアルに表示される期限・手順を優先してください。
また、連携エラーがすべて期限切れとは限りません。たとえば商品連携のエラーには、一時的な楽天API側のエラーや、入力した認証情報が合っていない場合もあります。エラー文、発生時刻、対象機能を記録してから判断します。
更新作業の前に残しておきたい記録
APIが停止している可能性がある状態で設定を変えると、どの期間のデータを再確認すべきか分かりにくくなります。変更前に、次の内容を社内記録へ残します。
- ライセンスキーの有効期限と通知を確認した日時
- 商品・受注・在庫が最後に正常連携した日時
- エラーが出ている画面、機能、対象期間
- 楽天市場側にあり、クロスマ側で未確認の注文
- 反映待ちの商品・価格・在庫変更
- 作業担当者、確認担当者、作業予定時間
認証情報そのものを通常の議事録、チャット、記事原稿、画面共有へ貼り付ける必要はありません。保存する場合は、権限を限定した認証情報の管理方法を利用します。
1. クロスマの通知とRMSで有効期限を確認する
クロスマでは、楽天市場のAPIライセンスキーの期限が近づいた場合や期限が切れた場合に、管理画面やメールで通知されることがあります。通知を受け取ったら、担当者がRMSへログインし、WEB APIサービスのライセンス情報を確認します。
クロスマ公式マニュアルで案内されているRMSの経路は、次の流れです。
- RMSの「店舗様向け情報・サービス」を開く
- 「WEB APIサービス」を開く
- 「2-1 WEB API」からライセンスキーの確認・変更画面へ進む
- 現在の有効期限と状態を確認する
RMSのメニュー名や配置は変更される可能性があります。見当たらない場合は、最新のRMSヘルプとクロスマ公式マニュアルを確認し、似た名前の別設定を推測で変更しないようにします。
2. RMSで新しいライセンスキーを発行する
有効期限と対象店舗を確認したら、RMSで新しいライセンスキーを発行します。期限前に更新する場合は、旧ライセンスキーを停止する操作も含め、RMSに表示される最新の案内に従います。すでに期限が切れている場合は、画面上の現在状態を確認してから進めます。
この工程で社内記録に残すのは、発行日時、担当者、対象店舗、有効化確認予定時刻です。ライセンスキーの文字列自体は、権限のない資料やチケットへ転記しません。
3. 発行直後は有効化を待つ
クロスマの公式マニュアルでは、新しいライセンスキーの発行後、利用可能になるまで約1時間から1時間30分かかることがあると案内されています。発行直後にクロスマへ入力してエラーになっても、入力値が誤っているとは限りません。
待機中は次の作業を進めます。
- 更新後に確認する注文・商品・在庫の対象を一覧にする
- 停止の可能性がある時刻以降の楽天市場の注文を確認する
- 変更前のクロスマ設定を社内記録へ保存する
- 確認担当者と確認時刻を決める
反映待ちの間に新しいキーを何度も発行したり、サービスシークレットや店舗URLまで同時に変更したりすると、原因の切り分けが難しくなります。変更対象を一つに絞ります。
4. クロスマのモール設定でライセンスキーを更新する
新しいライセンスキーが有効になったことを確認したら、クロスマの「設定」から「初期設定」「モール設定」へ進み、対象の楽天市場設定を開きます。ライセンスキーを新しい値へ更新し、保存します。
クロスマ公式の更新手順では、通常のライセンスキー更新でサービスシークレットと店舗URLを変更する必要はないと案内されています。別の移行や店舗設定変更を同時に行う場合を除き、今回の更新対象ではない項目を触らない方が切り分けしやすくなります。
| 設定項目 | 通常のライセンス更新時 | 注意点 |
|---|---|---|
| ライセンスキー | 新しい値へ更新する | 前後の空白や対象店舗の取り違えを確認する |
| サービスシークレット | 通常は変更しない | 別の理由で再発行した場合は最新公式手順を確認する |
| 店舗URL | 通常は変更しない | 店舗移行等がない限り、推測で書き換えない |
5. 保存後は商品・受注・在庫を別々に確認する
設定画面で保存できたことと、すべての連携が復旧したことは同じではありません。次の順番で読み戻します。
- クロスマの楽天市場設定が保存され、認証エラーが出ていない
- 代表商品を使い、商品情報の取得または更新結果を確認する
- 楽天市場の注文とクロスマの受注を対象期間で照合する
- 基準在庫と楽天市場へ表示された在庫を照合する
- 出荷・キャンセルなど通常フロー外の処理を確認する
クロスマ公式マニュアルでは、連携停止中のデータは反映されないと案内されています。更新後に自動で過去分がすべて補われたと決めつけず、停止の可能性がある期間の注文・商品・在庫を楽天市場側と照合します。
更新後の確認チェック表
| 確認対象 | 完了条件 |
|---|---|
| 認証 | クロスマの楽天市場設定を保存でき、認証エラーが解消している |
| 商品 | 代表商品の取得・更新が一度だけ正常に完了する |
| 受注 | 停止の可能性がある期間を含め、楽天側の注文とクロスマ側の受注が一致する |
| 在庫 | 基準在庫、安全在庫、販売先在庫が運用ルールどおりになっている |
| 出荷 | 対象注文が意図した出荷方法へ入り、重複処理がない |
| 記録 | 更新日時、担当者、確認結果、未対応項目、次回期限が残っている |
価格・在庫連動の設定値も同時に見直す場合は、クロスマの価格・在庫連動設定を参考に、API更新とは別の変更記録として管理してください。
うまく再連携できないときの切り分け
| 症状 | 確認すること | 避けたい対応 |
|---|---|---|
| 認証エラーが続く | 有効化までの待ち時間、対象店舗、入力値、前後の空白 | 短時間にキーを何度も再発行する |
| 一部の機能だけ動かない | 商品・受注・在庫のどのAPIか、対象権限、エラー時刻 | API全体が止まったと決めつける |
| 商品更新だけ失敗する | 商品紐付け、商品データ、楽天APIの一時エラー、認証 | 商品データを未確認のまま一括更新する |
| 過去の注文が入らない | 停止期間、注文取得条件、楽天側ステータス、手動確認範囲 | 更新後に過去分が自動取得されたとみなす |
| 在庫差異が残る | 停止期間中の販売、キャンセル、管理外注文、安全在庫 | 差異原因を確認せず全商品を上書きする |
API認証以外に、商品区分、出品状態、注文取得条件、在庫連動設定などが原因になる場合もあります。クロスマ全体の初期設定を確認したい場合は、クロスマの初期設定ガイドもあわせて確認してください。
期限切れを防ぐ運用表を用意する
ライセンスキーの更新を担当者の記憶だけに任せると、担当変更や繁忙期に見落としやすくなります。次の項目を一つの管理表へまとめます。
| 管理項目 | 記録例 |
|---|---|
| 対象店舗 | 社内で識別できる店舗名または管理番号 |
| 有効期限 | RMSで確認した日付 |
| 事前確認日 | 期限より余裕を持った社内確認日 |
| 通知の受信先 | 担当チームまたは共有アドレス |
| 更新担当・確認担当 | 作業者とダブルチェック担当 |
| 発行・反映待ち | 発行時刻と再確認予定時刻 |
| 再設定結果 | 保存、商品、受注、在庫の確認結果 |
| 次回期限 | 更新完了後にRMSで再確認した日付 |
少人数の運営では共有カレンダーと管理表を組み合わせ、複数店舗を運営する場合は店舗ごとに期限、担当者、確認結果を分けます。通知が届いたかどうかだけでなく、RMSの現在値を定期的に確認する運用が必要です。
クロスマの導入・楽天連携を検討している方へ
クロスマと楽天市場を連携するときは、初期設定だけでなく、ライセンスキーの更新、停止中データの照合、商品・受注・在庫の復旧確認まで運用に含めます。最新のサービス情報と申し込み方法、MO-LIBの導入支援は記事末尾の案内から確認できます。
まとめ
クロスマの楽天API連携が止まった場合は、まずライセンスキーの期限とエラー内容を確認します。RMSで新しいキーを発行した後は有効化を待ち、クロスマでは更新対象のライセンスキーだけを変更します。保存後は商品・受注・在庫を別々に読み戻し、停止中に反映されなかった可能性があるデータも楽天市場側と照合しましょう。次回期限、通知先、担当者、確認結果まで管理表へ戻すことで、同じ停止を予防しやすくなります。
