Qoo10のAPI連携で押さえる仕様｜受注番号・配送方法・商品コードの取り扱いと設定手順

Qoo10のAPI連携で、最初に知っておきたいこと

ネット通販の利用は、すでに日常になっています。総務省の家計消費状況調査（2026年7月分）は、次のようにまとめています。

ネットショッピング利用世帯の割合は55.6％で、1年前に比べ2.4ポイントの低下

出典：総務省統計局「家計消費状況調査」（2026年7月分・2026年9月4日公表）

利用世帯の割合が横ばいから微減のなかでは、受注の増減に合わせて出荷を安定させることが店舗の評価に直結します。国土交通省がまとめた取扱実績では、令和6年度の宅配便取扱個数は次のとおりです。

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

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

荷物の数が高い水準で推移するなか、受注をひとつずつ手で倉庫に伝える運用は、件数が増えるほど負担になります。API連携は、モールの受注と在庫をシステム同士で受け渡す仕組みで、全体像はECカートと発送代行のAPI連携とは、CSV連携との違いはEC物流のAPI連携とCSV連携の違いで整理しています。

STOCKCREWがAPI連携しているモール・カート

STOCKCREWのヘルプでは、API連携しているカート・モール・OMSとは、複数ショップの一元管理が可能と案内されています。連携先は次の15種類です。

• モール——Yahoo!ショッピング、楽天、Qoo10、Temu
• カート——Shopify、BASE、makeshop、カラーミーショップ、ショップサーブ、futureshop、ecforce、EC-CUBE4
• OMS——ネクストエンジン、CROSS MALL、GoQsystem

ここで見落としやすい注意が1つあります。OMSと連携している場合、そのOMSが取得しているモール・カートと、STOCKCREWを直接連携すると、注文を2重で取得して発送することになります。Qoo10をOMSで管理している事業者は、連携の経路を1本に決めてから設定します。OMSの選び方はEC向けOMS比較ガイド、受注管理と物流の関係はEC受注管理（OMS）と物流の連携ガイドにあります。複数のモールで同じ在庫を売る場合は、複数ECモール同時出店の物流一元管理と在庫配分設計も参考になります。

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

Qoo10とのAPI連携を設定すると、受注情報と在庫情報をSCシステムと自動で連携できます。始める前に、SCシステムに対象のEC店舗が登録されていることが前提です。未登録なら、先に店舗設定から登録を済ませます。

入力する3つの情報と入手元

SCシステムの認証画面で入力する情報は、次の3つです。どれもQoo10側で用意するものですが、入手のしかたが異なります。

APIキーだけは申請が必要なため、導入の日程を決めるときは、APIキーの発行を待つ時間を見込んでおくと進行が止まりません。認証に成功すると「API認証に成功しました」と表示され、「販売者認証キー」が自動で生成されます。ヘルプの案内では、この販売者認証キーの有効期限は1年間です。設定を取り消したいときは、「接続を解除」ボタンでAPI接続情報を削除できます。

期限を忘れると、受注が連携されなくなる

1年の有効期限は、見落としやすいポイントです。受注が連携されなくなったときの対処は、APIキー自体の期限が切れているかどうかで分かれます。

1. APIキーが期限切れしていない場合——連携画面で「販売者認証キー」を再発行します。
2. APIキーが期限切れしている場合——Qoo10へAPIキーの再発行を申請し、新しいキーが発行されてから、連携画面で販売者認証キーを再発行します。

更新日をカレンダーに入れておくと、セール前に連携が止まる事態を防げます。Qoo10の大型セールの物流設計はQoo10 MEGA WEEKの物流設計と発送代行準備ガイドで整理しています。

受注取込の仕様：注文番号・配送方法・購入者情報・取込の条件

Qoo10の受注は、他のモールと同じ感覚で扱うとずれが出ます。STOCKCREWのヘルプ「API連携の仕様（Qoo10）」に載っている、受注取込の4つの仕様を順に見ていきます。

注文番号は「カート番号」が使われる

Qoo10では、受注番号として「カート番号」が使われます。Qoo10は明細行ごとに注文番号が付与されるため、1つの注文に複数の注文番号が存在することが理由です。項目対応表では、Qoo10の「PackNo（カート番号）」がSC側の注文番号に対応し、「OrderNo」は複数注文の場合にカンマで連結されて取り込まれます。OrderNoは発送処理で使うため、修正しないよう案内されています。

配送方法は「先頭（1商品目）」で決まる

Qoo10では、商品ごとに配送方法を設定できます。ところが、1つの受注のなかに配送方法の異なる商品が混在すると、先頭（1商品目）の配送方法を使って出荷されます。

たとえば、薄くて小さい商品と、大きめの商品を同じ注文で買われた場合を考えます。先頭の商品が薄型便の設定だと、大きめの商品も同じ配送方法の扱いになり、サイズ超過や追加料金の原因になりかねません。同じ注文で組み合わせて買われやすい商品は、配送方法をそろえて設定すると、意図しない出荷を防げます。薄型便のサイズ規格は宅配便のサイズ規格をヤマト・佐川・日本郵便で徹底比較で確認できます。

購入者情報は3項目だけ。住所はお届け先のものになる

Qoo10から連携される購入者情報は、氏名・メールアドレス・電話番号の3項目のみです。住所は、お届け先情報の住所を購入者住所として連携します。ギフトのように、購入者とお届け先が別の注文でも、購入者住所の欄には届け先の住所が入ります。購入者の住所を別に使う運用がある場合は、この点を前提にします。

取込の対象は3つのステータス

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

1. 入金待ち
2. 新規注文
3. 配送準備

これとは別に、ヘルプの項目対応表には、Qoo10の配送状態がSCシステムの受注ステータスに変換される対応も載っています。配送待ちは入金待ち、配送要請または配送準備は入金済みとして取り込まれます。取込対象の判断と、SCシステム側で見える受注ステータスは別の話として整理しておくと、「注文は入っているのに入金済みにならない」といった問い合わせに落ち着いて対応できます。

商品コードは「連結」で取り込まれる

Qoo10の連携でとくにつまずきやすいのは、商品コードです。受注時の商品コードは、販売者商品コードと販売者オプションコードを連結した形式で取り込まれます。オプションを設定した商品は、必ず「販売者オプションコード」を設定します。未設定の場合は、販売者商品コードだけで取り込まれます。

追加購入は、セット商品として登録する

追加購入を設定している商品は、追加購入の内容が販売者オプションコードに追加されます。そのため、次の2つの対応が必要です。

1. セット商品として商品対応表に登録する——販売者商品コードと追加購入オプションを組み合わせた、セット商品のコードで登録します。
2. 商品対応表は「在庫連携なし」で設定する——在庫連携をONにすると、APIエラーが発生するためです。

MOVEの在庫連携には条件がある

Qoo10のMOVEに出品した商品の在庫連携は、出品情報が一定の条件を満たす場合にだけ可能です。条件は通常のQoo10とMOVEの両方に出品されていることと、販売者商品コード・販売者オプションコードが両方で一致していることの2つです。満たしていない場合や、MOVEのみに出品されている商品は、在庫連携できません。コードの付け方は出品の段階で決まるため、MOVEにも出す予定があるなら、最初から両方に同じコードを付けておくと後の手戻りがありません。商品コードの設計の考え方は商品コード・SKU設計の実務ガイド、SKUの基本はSKUとは？EC在庫管理での意味・設定・活用法にまとめています。

商品連携の登録は3つの方法がある

商品の対応づけ（商品連携登録）は、API連携の設定の有無にかかわらず、次の3つの方法で行えます。

手動登録は、2026年6月5日に追加された機能です。数種類程度の商品なら、CSVを使わずに画面上でQoo10とSCシステムの商品情報を対応づけられます。入力する項目は、販売者コード、オプション商品を登録するかのチェック、オプションコード、オプション1、詳細1、SC側の商品コード、SC側の商品名、在庫連携のチェックの8つです。

モール形式CSVを使うときは、2つのCSVが必要になります。

1. GoodsList.csv——QSMの「価格/在庫」画面で、在庫状態を「全体」にして「照会」を押し、「Excel」からダウンロードします。
2. InventoryManagement_gridInventory.csv——「商品管理」の「商品の一括登録/修正」から「オプション管理」を開き、「全ての商品をダウンロード（CSV）」を押して取得します。

どの方法でも共通の注意があります。Qoo10管理画面で「販売者コード」を設定していないと、商品連携は登録できません。SCシステムの「商品コード」にQoo10の「販売者コード」を登録していない場合も、候補が表示されません。出品時の商品コードの付け方が、連携のしやすさを左右します。

連携が止まる・ずれるときの切り分け

連携のトラブルは、原因が決まっているものが多くあります。STOCKCREWのヘルプに載っている切り分けを、症状別にまとめます。

受注が連携されない

まず疑うのは、第2章で触れた販売者認証キーです。APIキーの期限が切れていなければ販売者認証キーを再発行し、切れていればQoo10へ再申請してから再発行します。それでも取り込まれない場合は、受注のステータスが取込対象の3つ（入金待ち・新規注文・配送準備）に当てはまるかを見ます。

在庫数が反映されない

在庫数が反映されない主な原因は、次の3つです。

1. 商品連携が正しく登録されていない——Qoo10の商品コードと、SCシステムの商品コードが対応づけられていません。登録内容を見直します。
2. 商品入荷後に商品連携登録をしている——登録の順番の問題です。
3. 在庫数が0の商品である——在庫数に変動がない商品は連携の対象外で、入荷や出荷で在庫数に変動があると、自動で在庫連携が行われます。

追加購入つきの商品を在庫連携ありで登録していないかも、あわせて点検します。在庫の考え方そのものは複数ECモールの在庫配分設計に詳しく載っています。

Qoo10側で受注を修正したとき

一度連携された受注は、再度は取り込まれません。Qoo10側で受注の内容を修正した場合は、次の手順で対応します。

1. Qoo10側で受注を修正する
2. SCシステムで該当の受注を削除する
3. 修正後の受注がAPI連携で再度登録される——この工程の操作は不要です。

金額を修正した場合は、SCシステム側でも金額を手で直します。受注を削除するときは、Qoo10側とSCシステム側の両方で削除する必要があります。片方だけを削除すると、注文の数が両者で食い違い、出荷漏れや二重出荷の原因になります。

Qoo10で連携を始める前のチェックリスト

ここまでの内容を、連携を始める前の準備としてまとめます。倉庫に商品を送る前に済ませておくと、立ち上がりが早くなります。

1. SCシステムにEC店舗を登録する——API連携の前提です。
2. APIキーを申請し、発行の日程を見込む——QSMの「chatでお問い合わせ」から申請します。
3. 販売者認証キーの更新日をカレンダーに入れる——有効期限は1年間です。
4. OMSとの二重連携を避ける——OMSで管理しているQoo10は、経路を1本に決めます。
5. Qoo10で販売者コードとオプションコードを設定する——未設定だと商品連携が登録できません。
6. 追加購入つきの商品は、セット商品・在庫連携なしで登録する——連結コードで登録します。
7. 同じ注文で買われやすい商品は、配送方法をそろえる——先頭の商品の配送方法で出荷されるためです。
8. MOVEに出す商品は、両方に同じコードを付ける——在庫連携の条件になります。

モール別の連携の考え方

ほかのモール・カートで連携を考えている場合は、Yahoo!ショッピングで化粧品を売る事業者の発送代行ガイド、カラーミーショップ×発送代行の連携実務ガイド、Shopify×発送代行の連携方法と業者選定ガイド、メルカリShops×発送代行の実務ガイドで、モールごとの癖を整理しています。Qoo10の出店方法や手数料の全体像はQoo10とは？出店方法・手数料・物流代行との連携を徹底解説にまとまっています。楽天との違いはRSLとSTOCKCREWを徹底比較、Yahoo!ショッピングの選び方はYahoo!ショッピング×発送代行の選び方で確認できます。STOCKCREWは初期費用0円・固定費0円で、1点から預けられ、導入は最短7日です。

配送方法の設定は、賠償の上限にも関わります。紛失・損傷への賠償額は、ヤマト運輸の法人向けFAQでサービス別に案内されています。

まとめ：Qoo10の連携は「連結コード」と「先頭の配送方法」を押さえる

Qoo10の出店者が発送代行とAPI連携するときのポイントは、注文番号がカート番号であること、混在した受注は先頭（1商品目）の配送方法で出荷されること、商品コードが販売者商品コードとオプションコードの連結で取り込まれることの3つです。追加購入のある商品はセット商品として在庫連携なしで登録し、MOVEの商品は両方に同じコードを付けます。連携が止まったときは、1年で切れる販売者認証キーと、一度取り込まれた受注は再取込されない仕様を疑います。

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