API連携の仕様(メルカリShops)

メルカリShopsとSCシステムのAPI連携でできること、連携の実行タイミング、取込対象と対象外の条件をご案内します。
連携を開始する前に、対象外となる注文や機能をご確認ください。

利用できる連携

連携の種類と実行タイミング

実行時刻は処理状況により前後する場合があります。

商品APIインポート

メルカリShopsに登録されている商品とバリエーションを取得します。
商品単位ではなく、バリエーション単位でSCシステムの商品へ紐づけます。
同じ商品の色・サイズ等は、それぞれ別のバリエーションとして紐づけます。

APIインポートだけでは、SCシステムの商品マスタは自動作成されません。
先にSCシステムの商品を登録してください。
在庫更新を行う商品は、商品連携登録時に在庫連携を有効にします。

受注取込

取込対象

• メルカリShopsで支払いが完了し、「発送待ち」になった注文
• 既定では、取得時点から過去30日間の発送待ち注文
• 受注取得が有効になっている店舗の注文
• 商品・支払方法・配送方法の対応設定が完了している注文

コンビニ・ATM払い等の注文は、支払前には取り込まれません。
支払完了後に「発送待ち」へ変わった時点で取り込みます。
メルカリShopsの注文データで支払日時が空欄の場合でも、注文状態が「発送待ち」であれば支払済みとして取り込みます。

30日を超えて商品連携不足などが解消されていない注文は、自動取込の保証対象外です。
必要な場合は、SCシステムの画面またはCSVインポートから手動で登録してください。

取込対象外

• 支払待ちの注文
• 取込前にキャンセル中またはキャンセル済みになった注文
• 予約注文
• メルカリBiz配送、メルカリ便・匿名配送、クール便を含む注文
• 配送先の必須項目が不足している注文
• 商品・支払方法・配送方法の対応設定が不足している注文

予約注文は、予約確定後に注文状態が「発送待ち」になった場合も取り込みません。
予約注文の決済、発売日、お届け予定、キャンセルおよび配送手続きは、メルカリShops管理画面で管理してください。

1件の注文に対象外の配送方法の商品が1つでも含まれる場合、注文の一部だけを取り込まず、注文全体を対象外にします。
取り込まれなかった理由は「API連携ログ」で確認できます。

受注の分割

1件のメルカリShops注文に複数の対応可能な配送方法が含まれる場合、配送方法ごとにSCシステムの受注を分けます。
分けられた受注は、元のメルカリShops注文番号を共通で保持します。

購入者情報

メルカリShops APIから取得した配送先情報を、SCシステムの購入者情報とお届け先情報へ登録します。
購入者メールアドレスと購入者メモは空欄になります。

在庫更新と出荷実績反映

在庫更新

• 商品連携登録済みで、在庫連携が有効な商品が対象です。
• SCシステムの引当可能在庫を、メルカリShopsのバリエーション在庫へ反映します。
• 送信できる在庫数は0から9,999です。
• 一部の商品だけ更新に失敗した場合、成功した商品はそのまま確定し、失敗した商品だけを次回の在庫更新で再実行します。
• SCシステムのセット商品を紐づけた場合は、構成品から算出した組立可能数を在庫として反映します。

出荷実績反映

• SCシステムで出荷完了した受注が対象です。
• メルカリShopsへ発送情報を作成し、送り状番号がある場合はあわせて反映したうえで、発送完了にします。
• 送り状番号を使用しない配送では、送り状番号を省略して発送完了にする場合があります。
• 同じ処理が再実行されても、すでに作成済みの発送情報を確認し、重複登録しないよう処理します。
• メルカリBiz配送、メルカリ便・匿名配送、クール便は出荷実績反映の対象外です。
• 1つのSCシステム受注を複数の送り状や複数回に分けて出荷する運用は対象外です。検知した場合はメルカリShopsへ送信せず、「API連携ログ」に表示します。

キャンセルとエラー

キャンセル

• 取込前にキャンセル中またはキャンセル済みの注文は取り込みません。
• 取込後、倉庫受注が出荷準備へ入る前（通常は出荷待ちまで）に全体キャンセルまたは商品・数量のキャンセルを検知した場合は、同じメルカリShops注文から作成されたSCシステム受注を出荷保留にします。
• SCシステムの受注、明細、引当は自動削除・自動修正されません。「API連携ログ」を確認し、受注取消、数量修正、または出荷継続をご判断ください。
• 出荷準備以降または出荷作業中以降にキャンセルされた注文は、API経由の出荷保留や倉庫作業の取消しを行いません。出荷実績の送信を停止し、保留できなかった受注番号と理由を「API連携ログ」に表示するため、メルカリShops管理画面と倉庫の作業状況をご確認ください。
• SCシステムからメルカリShopsへキャンセルを送信する機能は対象外です。

エラーの確認

予約注文、商品未連携、変換設定不足、対象外配送、住所不足、在庫更新失敗、出荷実績反映失敗は、SCシステムの「API連携ログ」に表示されます。

エラー内容を修正した後、次回の定期連携をお待ちください。
認証エラーが継続する場合は、店舗設定からAPIアクセストークンを再認証してください。

対象外の機能と注意点

対象外の機能

現在、次の機能はSCシステムのメルカリShops API連携の対象外です。

• SCシステムからAPIを使った商品の新規出品・商品情報更新
• 予約注文の取込、予約確定、決済および発売日に応じた配送制御
• メルカリBiz配送
• メルカリ便・匿名配送の送り状またはQRコード発行
• クール便
• 取引メッセージの送受信
• SCシステムからメルカリShopsへのキャンセル送信

注意点

• 連携の実行時刻は処理状況により前後します。反映されない場合は、次回の定期連携後にあらためてご確認ください。
• 商品連携、支払方法、配送方法の対応設定が不足している注文は取り込まれません。連携を有効にする前に設定を完了してください。
• 対象外の配送方法が1件でも含まれる注文は、注文全体が取込対象外になります。
• 取込対象外になった注文と失敗した連携は、SCシステムの「API連携ログ」でご確認ください。