キーワードを入力してください


Qoo10連携の設定方法(Certification Keyの発行手順)

CascadeとQoo10を連携する手順のご案内です。QSMでのCertification Keyの発行方法(承認まで約5営業日)、API IDとの違い、Cascadeでの接続手順、よくあるエラーの対処方法を掲載しています。

著者: Cascade

Qoo10 と連携すると、受注データをもとに売上分析・商品分析・商品管理が使えます。売上トレンド・売れ筋・商品 ABC 分析・商品別売上推移・セット購入・顧客分析・在庫・精算(手数料)に対応しています。左メニューの[設定]>[外部連携]から連携します。

連携には、QSM(Qoo10 Sales Manager)で発行する「Certification Key」を使います。パスワードの入力は不要です。

ご利用にあたっての前提

  • 外部連携と EC 分析は Business プランで利用できます。

  • 連携の操作には、プロダクトのオーナーまたは管理者の権限が必要です。

  • QSM のログイン ID(販売者アカウント ID)が必要です。

  • QSM で発行した Certification Key(150 文字前後の長い文字列)が必要です。

1 つのプロダクトに連携できる Qoo10 のアカウントは 1 つです。

Certification Key の発行手順(QSM)

1. QSM で「API IDの発行/照会」を開く

QSM にログインし、左メニューから「API IDの発行/照会」を開きます。見つからない場合は「基本情報 > My情報」の中にあります。

2. キーの発行をリクエストする

「API連動会社名」に「Cascade」と記入し、キーの発行をリクエストします。

3. 承認を待つ(約 5 営業日)

発行リクエストの承認まで約 5 営業日かかります。承認完了の通知は届かないため、数日後に同じ画面でご確認ください。承認前のキーは無効のため、貼り付けてもエラーになります。

4. 「Certification Key」をコピーする

承認後、同じ画面に「API ID」と「Certification Key」の 2 つの値が表示されます。Cascade の連携に使うのは「Certification Key」(150 文字前後の長い文字列)です。表示されたままの形でコピーしてください。

操作手順

1. 外部連携ページで[連携する]を押す

[設定]>[外部連携]を開き、「コマース連携」の「Qoo10」の行で[連携する]を押します。

2. ログイン ID と Certification Key を入力する

Qoo10 と連携のダイアログ

「Qoo10 と連携」の画面が開きます。「販売者アカウントID(QSM ログインID)」と「Certification Key」を入力し、[連携する]を押します。入力した値が短いときは、入力欄の下に警告が表示されます。「Qoo10 と連携しました。」と表示されたら完了です。

3. EC 分析を開く

左メニューの[EC]>[売上分析]を開くと、売上と顧客のデータが表示されます。商品ごとの分析は[EC]>[商品分析]で確認できます。

受注データは毎日早朝に 1 回取り込みます。初回は過去 2 年分までさかのぼって取り込むため、受注件数によって数時間かかることがあります。キャンセルなどの受注の訂正は、直近 35 日分を取り直して反映します。

確認できるデータ

  • 売上トレンド([EC]>[売上分析])

  • 顧客分析(LTV・リピート・F2 転換率)([売上分析])

  • 精算・手数料内訳 — Qoo10 の精算額をもとに、入金額と販売手数料の概算を表示します([売上分析])

  • 売れ筋ランキング・商品 ABC 分析・商品別売上推移([EC]>[商品分析])

  • セット購入(併売)ランキング・在庫([商品分析])

  • 商品管理(粗利率の設定)([EC]>[商品管理])

流入チャネル分析・返品/返金分析は、Qoo10 では対象外です。

Certification Key を更新する

Qoo10の認証情報更新

Cascade は、接続から 1 年を目安に Certification Key の更新をおすすめします。目安が近づくと、一覧の「確認事項」列に「更新推奨まで◯日」、過ぎると「キー更新推奨」と表示されます。これは実際の失効の予測ではなく、年次更新の目安です。

QSM で新しい Certification Key を発行し、「Qoo10」の行の[鍵を更新]を押します。「Qoo10 の認証情報を更新」の画面で、連携中と同じログイン ID と新しい Certification Key を入力し、[更新する]を押します。「Qoo10 の認証情報を更新しました。」と表示されたら完了です。連携済みのデータはそのまま引き継がれます。

Certification Key が無効になると、行に「認証エラー」と表示され、売上データの同期が止まります。QSM で再発行し、同じく[鍵を更新]から貼り付けてください。

連携を解除する

[設定]>[外部連携]の「Qoo10」の行で[解除する]を押します。「連携を解除すると連携先のデータにアクセスできなくなり、表示できるレポートやデータが制限されます。」と表示されるので、確認して進めます。別の Qoo10 アカウントに切り替える場合も、先に解除してから連携し直します。

こんなときは

Qoo10エラーメッセージ

症状

原因

対処

「入力された値は Certification Key より短いようです。」と表示される

同じ画面にある「API ID」(50 文字前後の短い値)を貼り付けている

「API ID」ではなく、150 文字前後の「Certification Key」を貼り付けてください。他のツールで「API ID」を使っていても、Cascade では使えません

「Certification Key が確認できませんでした。」と表示される

承認前のキー、失効したキー、または再発行前の古いキーを貼り付けている

発行リクエストから約 5 営業日の承認を待ってください。再発行した場合は、いま QSM に表示されているキーを貼り付けてください

「入力したログインIDが、連携中のアカウントと一致しません。」と表示される

鍵の更新で、連携中と違うログイン ID を入力した

連携中のログイン ID を入力してください。別のアカウントに切り替える場合は、一度解除してから連携し直してください

「すでに別の Qoo10 アカウントと連携済みです。」と表示される

このプロダクトは別の Qoo10 アカウントと連携している

一度[解除する]で解除してから、連携し直してください

「認証情報の更新には、このプロダクトのオーナーまたは管理者の権限が必要です。」と表示される

操作する権限がない

プロダクトのオーナーまたは管理者に依頼してください

「Qoo10 側が混み合っています。」と表示される

Qoo10 側の一時的な混雑

時間をおいて再度お試しください

「Qoo10 との連携に失敗しました。」と表示される

一時的な不具合

時間をおいて再度お試しください。繰り返す場合はサポートにお問い合わせください

「認証エラー」と表示され、売上が更新されない

Certification Key が無効になった(失効・再発行)

QSM で再発行し、[鍵を更新]から新しいキーを貼り付けてください

連携後にデータが表示されない

初回の取り込み中(過去 2 年分)

数時間後にもう一度ご確認ください

関連記事