コンテンツまでスキップ
ポータル
  • 検索フィールドが空なので、候補はありません。

メルカリShops連携FAQ

メルカリShopsとSCシステム（STOCKCREWシステム）のAPI連携について、お問い合わせの多いご質問をまとめてご案内します。

メルカリShopsとSCシステムのAPI連携について、お問い合わせの多いご質問をまとめました。
連携の条件や対象外の範囲など、仕様の詳細は「API連携の仕様(メルカリShops)」をご確認ください。

認証・API設定について

API認証に成功したのに「無効」と表示されます

認証直後は、受注取得・受注更新・在庫更新がすべて無効になっています。
「無効」は認証失敗を示す表示ではありません。
商品連携と初期設定を確認したうえで、利用する項目を個別に有効にしてください。

APIアクセストークンが入力欄へ表示されません

セキュリティ上、保存済みのAPIアクセストークンの実値は再表示しない仕様です。
登録済みの場合はマスク値と登録済みメッセージが表示されます。
変更する場合だけ、新しいAPIアクセストークンを入力して再認証してください。

APIアクセストークンをコピーできませんでした

メルカリShopsでは、発行直後の画面でのみAPIアクセストークンをコピーできます。
画面を再読み込みした後はコピーできないため、あらためて新しいトークンを発行してください。

接続を解除するとどうなりますか

保存されているAPI認証情報が削除され、受注取得・受注更新・在庫更新がすべて無効になります。
商品連携データは自動削除されません。
再接続後は、商品連携と各連携項目を確認してから運用を再開してください。

商品連携について

商品はSCシステムからメルカリShopsへ自動出品されますか

APIによる自動出品は現在対応しておりませんが、CSVでの一括登録をご利用いただけます。
SCシステムの商品一覧から「メルカリShops商品登録CSV」をCSVエクスポートし、必要項目を補完してメルカリShops管理画面へアップロードしてください。
メルカリShopsへ登録した後は、商品連携登録のAPIインポートで商品を紐づけます。

APIインポートでSCシステムの商品マスタも自動作成されますか

自動作成されません。
先にSCシステムの商品マスタへ商品を登録し、APIインポートでメルカリShopsのバリエーションと紐づけてください。

商品IDやSKU IDはどこで確認できますか

メルカリShopsのショップ管理画面で [商品] → [CSV一括機能] → [商品データのダウンロード] を選択してください。
ダウンロードしたCSVの「商品ID」が商品ID（Product.id）、「SKU1_ID～SKU10_ID」がSKU ID（ProductVariant.id）です。
画面の「商品管理コード」はCSVの「SKU1_商品管理コード～SKU10_商品管理コード」に対応する任意項目で、JANコードとは別の項目です。

APIインポート以外の方法で商品を紐づけられますか

1件ずつの手動登録と、メルカリShops専用の商品連携テンプレートによる一括登録をご利用いただけます。
CSV一括登録では、メルカリShopsからダウンロードした商品データCSVの必要項目を、SCシステムからダウンロードした専用テンプレートへ転記します。
この商品連携テンプレートは、メルカリShopsへ商品を出品するための「メルカリShops商品登録CSV」とは別のファイルです。

バリエーション商品に対応していますか

対応しています。
メルカリShopsの商品配下にある色・サイズ等のバリエーションごとに、SCシステムの商品またはSKUを紐づけます。

セット商品に対応していますか

対応しています。
SCシステムのセット商品の親商品を、メルカリShopsの1つのバリエーションへ紐づけます。
受注時は構成品を引き当て、在庫更新では構成品から算出した組立可能数を反映します。

受注取込について

支払日時が空欄の注文は未払いですか

必ずしも未払いではありません。
SCシステムは支払日時だけで判定せず、メルカリShopsの注文状態が「発送待ち」であることを支払済み・取込可能の基準にします。
支払待ちの注文は取り込まず、支払完了後に「発送待ち」へ変わった時点で取り込みます。

予約注文は取り込まれますか

予約注文は現在の連携対象外のため、予約確定後に注文状態が「発送待ち」になった場合も取り込みません。
予約注文の決済、発売日、お届け予定、キャンセルおよび配送手続きは、メルカリShops管理画面でご対応ください。
対象外となった注文は、SCシステムの「API連携ログ」で確認できます。

メルカリBiz配送の注文は取り込まれますか

メルカリBiz配送は現在の連携対象外のため、取り込みません。
対象外となった注文は、SCシステムの「API連携ログ」で確認できます。

メルカリ便・匿名配送の注文は取り込まれますか

現在、メルカリ便・匿名配送の送り状番号またはQRコードの発行に対応していないため、SCシステムの通常受注・通常出荷へは流さない仕様です。
これらの注文は、メルカリShops管理画面でご対応ください。

クール便の注文は取り込まれますか

倉庫の冷蔵・冷凍配送に現在対応していないため、クール便を含む注文は連携対象外です。
クール便の注文は、メルカリShops管理画面でご対応ください。

1件の注文に対象外の配送方法が混在している場合はどうなりますか

対象商品の一部だけを取り込まず、注文全体を取込対象外にします。
SCシステムの「API連携ログ」で、対象の注文・配送方法・商品を確認できます。

STOCKCREWから発送する商品は、メルカリShops側の配送方法を何に設定すればよいですか

「未定（出品者が手配）」を選択してください。APIでは UNDECIDED として連携され、取込対象です。 

メルカリShopsの商品登録画面には「ヤマト運輸 宅急便」などの選択肢はありません。
出品者が配送業者を手配する場合はすべて「未定（出品者が手配）」を選び、実際にどの配送方法で出荷するかはSCシステムの配送方法設定で指定します。 

らくらくメルカリ便、クールメルカリ便、メルカリBiz配送はメルカリが配送を行うため、STOCKCREWから出荷できません。 

注文が取り込まれません

次の項目をご確認ください。

  • [受注取得] が有効になっている
  • メルカリShopsの注文状態が「発送待ち」になっている
  • 予約注文ではない
  • 商品連携が登録されている
  • 支払方法と配送方法の対応設定が登録されている
  • メルカリBiz配送、メルカリ便・匿名配送、クール便が含まれていない
  • 配送先の氏名・郵便番号・都道府県・市区町村・住所・電話番号が取得できている
  • 「API連携ログ」にエラーが表示されていない

設定を見直しても注文が取り込まれません

もっとも多い原因は、支払方法・配送方法の設定が未登録または不足していることです。
API認証が有効でも、対応設定で変換できない注文は受注データが取り込まれません。

「API連携ログ」に変換できなかった値が表示されるため、その値を対応設定へ登録してください。  

  • 配送方法設定：変換前に UNDECIDED、変換後に出荷に使用する配送方法
  • 支払方法設定：BALANCE / CREDIT_CARD / CARRIER_PAYMENT / DEFERRED / STORE_PAYMENT / OTHER

登録後、次回の受注連携（約5分間隔）で対象注文があらためて取得されます。
反映されない場合は、次回連携後の「API連携ログ」をご確認ください。
入力する値の一覧は「項目の対応(メルカリShops)」をご確認ください。 

受注取得をオフにしていた期間の注文は取り込めますか

[受注取得] がオフの間は取り込まれません。オンに戻すと、次回の受注連携で対象注文があらためて取得されます。 

取り込まれるのは、メルカリShopsで引き続き「発送待ち」であり、取込対象期間内（既定では過去30日間）の注文です。 

オフにしていた期間に別の方法で発送した注文がある場合は、二重出荷を避けるため、その注文の扱いを確認してからオンに戻してください。 

在庫・出荷について

在庫数が反映されません

次の項目をご確認ください。
設定を修正した後、次回の定期連携をお待ちください。

  • [在庫更新] が有効になっている
  • 対象商品の商品連携が登録されている
  • 商品連携の [在庫連携] が有効になっている
  • SCシステムの引当可能在庫が0から9,999の範囲内である
  • 「API連携ログ」に在庫更新エラーが表示されていない

SCシステムで出荷済みですが、メルカリShopsが発送済みになりません

次の項目をご確認ください。
出荷実績は毎時00分・20分・40分に連携するため、処理中の場合は次回の連携後にあらためてご確認ください。

受注明細がSCシステム・メルカリShops双方で一致していない場合も、自動連携できない可能性があります。
受注明細の変更が必要な場合は、SCシステム側の受注削除→メルカリShopsからの再取込をご検討ください。

  • [受注更新] が有効になっている
  • SCシステムで対象受注の出荷が完了している
  • 商品連携が変更・解除されていない
  • メルカリShops側で注文または商品がキャンセルされていない
  • SCシステム上での受注明細変更により、メルカリShops側と受注明細が一致していない
  • 「API連携ログ」に出荷実績反映エラーが表示されていない

メルカリShopsに出荷日や配送会社は反映されますか

反映されません。メルカリShopsへ連携するのは、注文・商品・SKUを特定するID、出荷数量、送り状番号（ある場合）で、送信後に発送完了処理を行います。

メルカリShopsのAPIに出荷日・配送会社の項目がないため、これらは個別項目として連携できません。
メルカリShopsの管理画面も、購入者への追跡情報のみを登録するインターフェースになっています。
※ 詳しくはメルカリShops公式の購入者への追跡番号の通知をご確認ください。

送り状番号の反映と発送完了は自動で行われるため、出荷後にメルカリShops管理画面で追跡情報を手入力する必要はありません。

取込後にメルカリShopsでキャンセルされました

出荷待ちまでにキャンセルを検知した場合は、対象のSCシステム受注を出荷保留にします。
受注や引当は自動削除・自動修正されないため、「API連携ログ」を確認し、受注取消・数量修正・出荷継続をご判断ください。
出荷準備以降は出荷保留も倉庫作業の取消しも行いません。
詳しい挙動は「API連携の仕様(メルカリShops)」をご確認ください。

関連記事