↗付きの用語リンクは、別タブで説明を開きます。
クロスマとYahoo!ショッピングを連携するときは、ストアIDを入力して認証するだけでは十分ではありません。公開鍵とバージョン、API認証の更新、注文自動取得、メール設定、接続後のテストまでを一続きで確認する必要があります。
MO-LIBがEC運営と販売促進支援の実務に入る中でも、設定画面上は有効に見えていても、認証情報の更新、注文取得、購入者向けメールなどの実運用までは検証できていないケースがあります。本記事では会社名、店舗情報、注文情報、認証値を使わず、クロスマの公式マニュアルと一般化した確認手順をもとに解説します。
結論：API認証、公開鍵、注文取得を別々に確認する
Yahoo!ショッピングとの連携では、次の三つを分けて確認します。
- Yahoo!ショッピングのストアとクロスマをAPI認証する
- 有効な公開鍵と対応するバージョンをクロスマへ登録する
- 注文自動取得を有効にし、テスト注文で取得結果を確認する
API認証に成功しても、公開鍵が期限切れだったり、注文自動取得がオフだったりすると、在庫や注文の連携が安定しません。各工程の完了条件を決めてから本番運用へ進みます。
連携前に準備するもの
作業前に、Yahoo!ショッピングとクロスマの両方へログインできる担当者を決めます。認証情報をチャットや記事用の資料へ貼り付けず、権限のある担当者が画面間で直接入力します。
| 準備項目 | 確認すること |
|---|---|
| ストアID | 連携対象のYahoo!ショッピング店舗と一致しているか |
| ストアアカウント | 対象店舗のAPI認証を行えるYahoo! JAPAN IDか |
| 公開鍵 | ストアクリエイターProで有効になっている鍵か |
| 公開鍵のバージョン | 貼り付ける公開鍵と同じバージョンか |
| 担当者・更新日 | API認証と公開鍵の期限を誰が確認するか |
| テスト注文 | 本番出荷へ影響しない確認方法を決めているか |
複数店舗を運営している場合は、ストアID、Yahoo! JAPAN ID、クロスマ側の店舗設定の組み合わせを一覧にしておくと、別店舗へ接続するミスを防ぎやすくなります。
クロスマとYahoo!ショッピングをAPI連携する流れ
1. ストアIDと接続先を確認する
クロスマの「設定」からモール設定を開き、Yahoo!ショッピングの連携対象を確認します。ストア名だけで判断せず、Yahoo!ストアクリエイターPro側のストアIDと照合します。
過去のブックマークからクロスマへ入っている場合は、公式マニュアルで案内されている現在のログインURLも確認します。クロスマの公式案内では、古いURLからログインしているとYahoo!の鍵更新に失敗するケースがあると説明されています。
2. 公開鍵とバージョンを確認する
Yahoo!ストアクリエイターProの「設定」から「暗号鍵管理」を開き、公開鍵の有効期限とバージョンを確認します。新しい公開鍵を発行した場合は、鍵だけでなく対応するバージョンもクロスマへ入力します。
公開鍵は画面上の文字をドラッグしてコピーせず、ストアクリエイターProのコピーボタンを使います。クロスマの公式マニュアルでは、先頭と末尾の行を含む正しい形式、余分な行がないこと、公開鍵とバージョンが一致していることが重要と案内されています。
3. クロスマからYahoo! JAPAN IDで認証する
公開鍵とバージョンを入力したら、クロスマ側で更新操作を行い、表示されたYahoo! JAPAN IDのログイン画面で対象ストアのアカウントを認証します。ログイン中のアカウントが別店舗用でないか、認証前に確認します。
完了メッセージだけで判断せず、クロスマのモール設定へ戻ってストアID、公開鍵のバージョン、更新状態を読み直します。認証値そのものをスクリーンショットや作業報告へ残す必要はありません。
APIと公開鍵には別々の更新期限がある
クロスマの公式マニュアルでは、Yahoo!ショッピングのAPI認証は28日ごと、公開鍵は1年ごとの更新が必要と案内されています。API更新と公開鍵の再発行は同じ作業ではありません。
- API認証の期限が近い場合：クロスマのモール設定から更新し、Yahoo! JAPAN IDで再認証する
- 公開鍵の期限が近い場合：ストアクリエイターProで新しい鍵を発行・有効化し、鍵とバージョンをクロスマへ登録する
- 担当者が変わる場合：ログイン権限、通知先、更新予定日を引き継ぐ
更新通知を受け取るだけではなく、管理表に「次回確認日」「担当者」「更新後のテスト結果」を記録します。期限切れ後に再接続できても、自動連携が安定しているとは限らないため、注文と在庫の確認を行います。
注文自動取得は別画面で確認する
API接続後は、「メール設定（注文関連設定）」でYahoo!ショッピングの注文自動取得を確認します。クロスマの公式マニュアルによると、アカウント発行後や利用再開時は注文自動取得がオフの場合があり、設定後の取得まで1時間以上かかることもあります。
注文が見つからない場合は、API設定を何度もやり直す前に次を確認します。
- 注文自動取得が有効になっているか
- モール側の注文ステータスが取得対象か
- 対象注文をストアクリエイターProで開いたり、状態変更したりしていないか
- 設定から十分な時間が経過しているか
- クロスマ内でエラーや処理停止になっていないか
出荷期限が迫っている注文は、連携の復旧を待つだけでなく、モール側で直接処理する判断も必要です。その場合は、復旧後の二重処理を防ぐため、注文番号、対応日時、担当者、出荷状況を記録します。
接続後の確認は少数のテストで行う
| 確認段階 | 確認内容 | 問題がある場合 |
|---|---|---|
| 認証 | 対象ストアと接続できている | ストアID・ログインアカウントを照合 |
| 公開鍵 | 鍵とバージョンが一致し有効期限内 | コピーボタンで再取得し、余分な行を除く |
| 商品 | 代表商品を取得・更新できる | 商品コード、公開状態、カテゴリを確認 |
| 注文 | テスト注文を一度だけ取得できる | 自動取得設定と注文ステータスを確認 |
| 在庫 | 想定した販売可能数へ更新される | 安全在庫、反映時間、対象SKUを確認 |
| 通知 | 送信元・署名・文面が正しい | 購入者向けメール設定を見直す |
商品取得、注文取得、在庫反映、メール送信は別の機能です。一つの確認に成功しても、ほかの機能まで成功したことにはなりません。実運用前は少数商品とテスト注文で工程ごとに確認します。
連携がうまくいかないときの確認順
- クロスマの現在のログインURLを確認する
- Yahoo!ショッピングのストアIDが一致しているか確認する
- 公開鍵をコピーボタンで取得し直す
- 公開鍵とバージョンの組み合わせを確認する
- Yahoo! JAPAN IDで再認証する
- 注文自動取得のON・OFFを確認する
- テスト注文のステータスとクロスマ側の処理状態を確認する
同じ更新操作を繰り返すと、どこで状態が変わったか分からなくなります。一つずつ確認し、変更前後と結果だけを記録します。公開鍵やログイン情報は記録へ貼り付けません。
公式マニュアルと更新日を確認する
管理画面の名称や手順は変更されることがあります。作業時は、クロスマ公式の「Yahoo! API更新方法」と「注文自動取得設定」を確認してください。本記事の手順は2026年8月29日に確認した内容をもとにしています。
クロスマの導入・Yahoo!連携を検討している方へ
クロスマは、Amazonの商品や在庫を起点に複数モールの出品、受注、在庫、出荷をまとめたい事業者に適した選択肢の一つです。ただし、店舗数、商品コード、倉庫、注文の例外処理、担当体制によって必要な設定は異なります。最新の公式情報とMO-LIBの導入支援は、記事末尾の案内からご確認いただけます。
まとめ
クロスマとYahoo!ショッピングの連携は、ストアID、公開鍵、バージョン、Yahoo! JAPAN IDによる認証を確認し、注文自動取得とテスト注文まで進めて完了です。API認証と公開鍵には異なる更新周期があるため、担当者と次回確認日を管理します。認証に成功したことと、商品・注文・在庫・通知が正しく動くことを分けて検証しましょう。
