スマレジの店舗在庫をECサイトに表示する方法【FutureShop対応】仕組み・必要なもの・注意点

「ECで在庫切れでも、近くの店舗には在庫がある」——実店舗を持つショップならよくある状況です。これをお客様が商品ページで確かめられるようにするのが「店舗在庫の表示」。在庫数を書き換える「在庫同期」とは別物で、ずっと軽く、安全に導入できます。

「店舗在庫を表示する」と「在庫を同期する」は別もの

スマレジとネットショップの連携というと、多くの方が「在庫数をECに反映させる（在庫同期）」を思い浮かべます。しかし実店舗を複数持つショップが本当に求めているのは、たいてい次の2つです。

• お客様が、自分の近くの店舗に在庫があるか商品ページで確認できる（来店につながる）
• 「在庫ありますか？」の電話・DMを店舗スタッフが受けなくてよくなる

この目的には、スマレジの店舗別在庫を読み取って表示するだけの連携で十分です。在庫数の書き換えや引当をしないので、POS側の運用は一切変わりません。

仕組み：スマレジAPIとカートAPIをつなぐ

店舗在庫の表示は、次の3つの部品で成り立ちます。

1. スマレジ API：契約IDとアクセストークンで認証し、商品IDに対する店舗別の在庫数を取得します。API の利用には、API が使えるプランでのご契約が必要です。
2. ECカート側の API（FutureShop の場合は futureshop API）：商品番号から商品名・価格・画像・カラー／サイズなどのバリエーションを取得します。
3. 商品ページに埋め込むスクリプト：「店舗在庫を確認」ボタンが押されたときだけ、上の2つを呼び出してポップアップに表示します。

ポイントは、在庫を取得するのはボタンが押されたときだけにすることです。ページ表示のたびに API を呼ぶと、スマレジ側・カート側の呼び出し回数制限にすぐ当たります。

スマレジ側の商品と、ECの商品をどう紐付けるか

もっとも実務的なのは、スマレジの商品に「ECの商品番号（SKU）」を持たせる方法です。スマレジの商品には自由に使える予備項目があるので、そこに FutureShop の商品番号を入れておけば、EC 側の SKU からスマレジの商品を一意に特定できます。JAN コードが両方に入っている場合は、JAN でも紐付けられます。

EC では1商品として売っているのに、店舗では「本体」と「ストラップ」のように別商品として登録しているケース（セット商品）は、構成品それぞれの在庫を取り、最小値を「セットとしての在庫」と見なすのが一般的です。

FutureShop（フューチャーショップ）で用意するもの

• futureshop API の利用設定と、API クライアント（クライアントID・クライアントシークレット）
• ショップキー（ショップの識別子）
• 商品詳細ページのテンプレートを編集できること（スクリプトタグとボタンを置くため）

FutureShop 側は「商品情報の参照」ができれば足ります。受注や会員情報の権限は不要です。

つまずきやすい3つの注意点

1. 許可IPアドレス（IP制限）

スマレジ API も futureshop API も、呼び出し元の IP アドレスを事前に登録する運用が基本です。登録前にテストを繰り返すと、スマレジ側でアカウントがロックされることがあります。連携サービス側の固定 IP を先に登録し、接続テストは最小回数で行うのが鉄則です。

2. 呼び出し回数の制限とキャッシュ

どの API にも単位時間あたりの呼び出し上限があります。同じ商品の在庫を数十秒〜数分の間はキャッシュで返す、店舗別の在庫は1回の照会でまとめて取る、といった設計で回数を抑えます。

3. 「取得できなかった」を「在庫ゼロ」と表示しない

API がエラーを返したときに ✕（在庫なし）と表示してしまうと、実際には在庫があるのに「どこにも無い」と案内することになります。エラー時は「在庫情報を取得できません」と分けて表示するべきです。地味ですが、売上に直結する設計判断です。

自社開発か、サービスを使うか

上の仕組みは自社でも開発できますが、API 仕様の変更への追従、店舗の追加・改名の反映、キャッシュや IP 制限まわりの運用は継続的に手がかかります。ShopStock は、この「表示専用の店舗在庫連携」をスマレジ＋FutureShop 向けにサービス化したもので、申し込み後に管理画面の手順に沿って API 情報を登録し、商品ページにタグを1行貼るだけで公開できます。

参考：スマレジ 公式サイト ／ スマレジ・デベロッパーズ ／ futureshop 公式サイト

関連コラム