スマレジ連携
店頭のPOSレジ「スマレジ」とサブスクラインをつなぐ設定です。できることは次の4つです。
- 店頭の会計をLINE会員に紐付ける: スマレジで会計した取引を取り込み、LINE会員と紐付けます。取り込んだ履歴はユーザー詳細の「店頭の購買履歴(スマレジ)」に表示され、ユーザーグループの「購買履歴の条件」で絞り込みにも使えます。
- サブスクラインの売上をスマレジに登録する: サブスクラインで決済された注文・定期便の課金・予約のカード決済を、スマレジに取引として登録します。店頭の売上と同じように、スマレジと連携した会計ソフトへ流せます。
- 滞在料金を店頭のスマレジで支払ってもらう(店頭精算): 滞在課金のプランで、会員がチェックアウトするときに、滞在料金をカードではなく店頭のスマレジで支払えるようにします。詳しくは 9. 店頭精算 を参照してください。
- 店頭の会計で来店スタンプ・ポイントを付与する: スマレジで会員証を読み取った会計ごとに、来店スタンプや、会計金額に応じたポイントをお客様に付与します。詳しくは 10. 来店スタンプ と 11. 会計金額に応じたポイント を参照してください。
場所:
- 接続・取込・会員の登録: 管理画面サイドバー「設定」>「スマレジ連携」タブ
- 売上の登録: 「スマレジ連携」タブの「売上をスマレジへ登録」にある「売上の登録を設定する」から開く「売上をスマレジへ登録」画面(接続情報を保存すると表示されます)
設定できる人
「スマレジ連携」タブと「売上をスマレジへ登録」画面は、クライアント管理者のアカウントだけが開けます。接続情報の保存、接続テスト、過去分の取込、会員の一括登録、売上の登録設定の保存と再送、ユーザー詳細での会員コードの紐付けも、クライアント管理者だけが実行できます。
1. 接続情報を登録する
「スマレジ連携」タブを開き、スマレジの接続情報を入力して「保存する」を押します。入力する契約ID・クライアントID・クライアントシークレットは、先にスマレジ側で用意します(スマレジ側で用意するもの)。

| 項目 | 内容 |
|---|---|
| 接続先 | 「本番環境」か「開発環境(サンドボックス)」を選びます。 |
| 契約ID | スマレジの契約ごとに発行されるIDです。本番環境はお使いのスマレジの契約ID、開発環境(サンドボックス)は sb_ で始まる契約IDです(sb_ を含めてそのまま入力します)。 |
| クライアントID | 連携に使うスマレジのアプリのクライアントIDを入力します。 |
| クライアントシークレット | 暗号化して保存し、画面には表示しません。保存した後は「設定済み(変更する場合のみ入力)」と表示され、変更するときだけ入力します。 |
| 既定の店舗ID(任意) | 店舗を指定しない処理で使うスマレジの店舗IDです。接続テストで店舗の一覧を確認できます。 |
| 購買履歴の取込を有効にする | 初期値はオンです。オフにすると、取引の通知を受けても取り込まず、「取込を開始する」「一括登録を実行する」も押せなくなります。売上の登録(7.)も行いません。 |
| LINE会員をスマレジの会員として自動登録する | 初期値はオフです。詳しくは 5. 会員をスマレジに一括登録する を参照してください。 |
契約ID・クライアントIDが空のまま、または初回にクライアントシークレットが空のままでは保存できません。
スマレジ側で用意するもの
契約ID・クライアントID・クライアントシークレットは、スマレジの開発者向けサイト「スマレジ・デベロッパーズ」で作るプライベートアプリ(自社の契約だけで使うアプリ)の値です。プライベートアプリはアプリマーケットに公開されず、スマレジの審査もありません。
スマレジ・デベロッパーズに登録する: スマレジ・デベロッパーズの登録ページから開発者アカウントを登録します。登録後はログインページから入れます。登録すると、試験用の契約(サンドボックス)が自動で用意されます。
プライベートアプリを作る: 「アプリ」>「プライベートアプリ」で「プライベートアプリを新規登録」を押し、アプリ区分は「WEBアプリ」を選びます。アプリ名とアイコンを入力して「登録」を押します。アプリ名は「サブスクライン連携」など、自分で見分けられる名前にしてください。クライアントシークレットが発行されるのは「WEBアプリ」だけです。
スコープ(権限)をオンにする: アプリの「スコープ」で、次をオンにします。
pos.transactions:read、pos.customers:read、pos.stores:readの3つは、どの機能を使う場合でも必ずオンにします。ほかのスコープは、使う機能に応じて足します。使う機能 オンにするスコープ 店頭の会計の取込(どの機能でも必須) pos.transactions:read、pos.customers:read、pos.stores:readLINE会員をスマレジの会員として登録する 上に加えて pos.customers:write売上をスマレジへ登録する・店頭精算 上に加えて pos.transactions:write取込に必須の3つが足りないと、サブスクラインの「接続テスト」で足りないスコープの名前が表示されます。オンにしたはずなのに表示されるときは、保存し忘れていないか、接続先と同じ環境(本番または開発)のスコープがオンになっているかを確認してください。スコープが環境ごとに分かれて設定されるかは、スマレジのガイドでは確認できていないため、両方の環境で確認すると確実です。
pos.customers:writeが付いていない状態で「LINE会員をスマレジの会員として自動登録する」をオンにして保存するとき、またはオンのまま接続先・契約ID・クライアントIDを変えて保存しようとすると、足りないスコープの名前が表示されて保存できません。スマレジ・デベロッパーズのアプリ設定でスコープを有効にしてから、もう一度保存してください。オフのままでも、接続テストでpos.customers:writeが付いていなければ注意が表示されます(接続の成否には影響しません)。店頭精算のpos.transactions:read・pos.transactions:writeは店頭精算を有効にして保存するときに確認します。売上の登録に使うpos.transactions:writeは接続テストでは確認しないため、売上の登録を使う場合は忘れずにオンにしてください。環境設定を入力し、クライアントIDとクライアントシークレットを控える: アプリの「概要を見る」から「環境設定」タブを開き、次を入力して保存します。
スマレジの入力欄 入力する値 アプリのURL 「スマレジ側の準備」の「アプリのURL」 利用者契約通知先URL 「スマレジ側の準備」の「利用者契約通知先URL」 Webhookの送信先エンドポイント 「スマレジ側の準備」の「Webhook の送信先エンドポイント」(サブスクラインの「取引の通知(Webhook)」に表示される受信URLと同じ値です) サブスクラインの「スマレジ連携」画面の「スマレジ側の準備」に、お使いの環境に合わせた3つの値が表示され、それぞれ「コピー」で写せます(接続情報を保存する前から見られます)。
「利用者契約通知先URL」には、「Webhook の送信先エンドポイント」と同じURLが表示されます。サブスクラインは、取引と仮販売以外の通知を受け取っても処理しません。
「環境設定」には、本番環境用と開発環境用の設定があります。開発環境の欄にも、本番環境と同じように、「スマレジ側の準備」に表示された値を入力してください。片方だけでは「アプリのURLを入力してください」と表示され、保存できません。
同じ「環境設定」タブには、本番環境用と開発環境用のクライアントID・クライアントシークレットが別々に表示されます。**クライアントシークレットは、作成したときと再発行したときにしか表示されません。**その場でサブスクラインの画面に入力するか、控えてください。再発行すると以前の値は使えなくなります。
アプリをアクティベートする: プライベートアプリは、スマレジ本体の契約に連携(アクティベート)するまで使えません。アクティベートしていないと、サブスクラインの「接続テスト」が通らないことがあります。アプリの設定画面の「利用状況」タブにある「アプリをアクティベートしましょう」の欄に、スマレジ本体の契約ID(スマレジ・デベロッパーズやサブスクラインのIDではありません)を入力して、アクティベートします。
本番環境と開発環境(サンドボックス)では、契約ID・クライアントID・クライアントシークレットがすべて別の値です。サブスクラインの「接続先」と、入力する値の環境をそろえてください。取り違えると「接続テスト」が失敗します。
スマレジ側の画面名とご契約のプラン
スマレジ側の画面名やボタン名は、スマレジの更新で変わることがあります。最新の手順はスマレジ・デベロッパーズのガイドを確認してください。スマレジのガイドでは、本番環境の Webhook の設定は、スマレジ・デベロッパーズでの申請・公開の後に反映されると案内されています。本番で取引の通知が届かないときは、アプリの申請・公開の状態も確認してください。APIと取引の通知(Webhook)をお使いのスマレジのプランで使えるかは、スマレジにご確認ください。
接続テスト
保存すると「接続テスト」と「連携を解除する」のボタンが表示されます。「接続テスト」を押すと、スマレジに実際に接続して確認します。
- 接続できた場合は「接続できました。」と、スマレジの店舗の一覧(店舗ID: 店舗名)が表示されます。
- 接続できても、「LINE会員をスマレジの会員として自動登録する」がオフで
pos.customers:writeが付いていない場合は、「接続できました。」の下に注意が表示されます。自動登録を使う場合は、スマレジ・デベロッパーズのアプリ設定でこのスコープを有効にしてください。使わない場合は対応不要です。 - 接続できなかった場合は「接続できませんでした。」と、その理由が表示されます。スマレジのアプリに必要な権限(スコープ)が付いていない場合は、足りないスコープの名前が表示されます。スマレジ・デベロッパーズのアプリ設定でそのスコープを有効にしてから、もう一度「接続テスト」を押してください。
- 会員の登録や取込の途中で「スマレジのアプリに必要な権限(スコープ)が足りません (HTTP 403)」と表示された場合も、同じくスマレジ・デベロッパーズのアプリ設定で必要なスコープを有効にしてください。クライアントIDやクライアントシークレットの誤りのときは「スマレジの認証に失敗しました」と表示されます。
「LINE会員をスマレジの会員として自動登録する」をオンにしている場合は、会員を登録するための権限が付いていないと接続テストが失敗します。
契約を変える・連携を解除する
- 購買履歴を取り込んだ後、会員を紐付けた後、取込などの処理を実行している間は、契約IDと接続先を変更できません。別の契約につなぎ替えるときは、「連携を解除する」で解除してから設定し直してください。
- 「連携を解除する」を押すと、取り込み済みの購買履歴と会員の紐付けも削除されます。同じ契約でつなぎ直した場合は、過去分の取込で取り直せます。
- 過去分の取込や会員の一括登録を実行している間は、連携を解除できません。終わってからもう一度お試しください。
- 同じ契約IDが別のアカウントで連携済みの場合は保存できません。
- 売上をスマレジへ登録の設定(オン/オフ・店舗ID・端末ID)は、連携を解除しても残り、つなぎ直すとすぐに登録を再開します。別の契約につなぐ前に、店舗ID・端末IDを見直してください。
- 「スマレジ連携」タブの「店頭精算(スマレジで滞在料金を支払う)」は、連携を解除すると無効になります(店舗ID・端末ID・商品の入力内容は残ります)。つなぎ直した後に使う場合は、あらためて「店頭精算を有効にする」をオンにして保存してください。
- 店頭精算で支払い待ちの仮販売(店頭で読み取るコードを発行し、まだ支払われていないもの)が残っている間は、連携を解除できません。「店頭精算(スマレジで滞在料金を支払う)で支払い待ちの会員が○件あるため、連携を解除できません。」と件数が表示されます。支払いか取り下げが済んだ後に、もう一度お試しください。
- 同じように、支払い待ちの仮販売が残っている間は契約IDと接続先も変更できません(「契約IDと接続先は変更できません。」と件数が表示されます)。
- 件数には、スマレジとの通信が途切れてコードを表示できなかった支払い待ちも含まれます。この支払い待ちは、作成から10〜20分ほどで自動で取り下げます(スマレジ側に仮販売が登録されていれば取り消します。店頭で支払われていた場合は支払いとして記録しますが、その会員がすでにカードで支払っていた場合は記録せず、二重払いとしてサブスクラインの運営に通知します)。
2. 取引の通知(Webhook)を設定する
スマレジで会計・取消・返品があったときに、すぐに購買履歴へ反映させるための設定です。送信先のURLは、接続情報を保存する前から「スマレジ連携」画面の「スマレジ側の準備」に表示されます。接続情報を保存すると、「取引の通知(Webhook)」にも同じ「受信URL」が表示され、通知を受け取った日時などを確認できます。

「受信URL」(「スマレジ側の準備」の「Webhook の送信先エンドポイント」と同じ値)をコピーし、スマレジ側で次のように設定します(画像の受信URLは撮影の都合でぼかしています)。アプリを作るときに環境設定で入力済みの場合は、イベントの有効化だけで構いません。
- スマレジ・デベロッパーズで、スマレジ側で用意したアプリの Webhook の設定を開きます。
- 送信するイベントで「取引」(
pos:transactions)を有効にします。店頭精算を使う場合は、仮販売のイベント(pos:temporary-transactions)も有効にします。 - スマレジ側の「Webhookの送信先エンドポイント」欄に、サブスクラインの画面に表示された受信URLを入力して保存します。
設定が済むと、「直近の受信」に通知を受け取った日時、「直近の取込」に取り込んだ日時が表示されます。取込や接続テストで失敗したときは「直近のエラー」に日時と理由が表示されます。
取引の通知を設定しないと自動では取り込まれません
新しい会計を取り込むきっかけは、スマレジからの取引の通知です。サブスクラインから定期的にスマレジへ取引を取りに行くことはありません。通知を設定していなかった期間や、通知を受け取れなかった期間の取引は、過去分の取込で取り込んでください。
3. 過去分の取込
連携を設定する前の取引を、期間を指定して取り込みます。
- 「過去分の取込」で開始日と終了日を選びます。開始日の0:00から終了日の23:59:59まで(日本時間)が対象です。
- 「取込を開始する」を押します。
- 1回で指定できる期間は最大732日です。これより長い期間を取り込むときは、期間を分けて複数回実行してください(732日を超えると「一度に取り込める期間は732日までです」と表示されます)。
- 同じ取引を何度取り込んでも重複しません。取込済みの取引がスマレジで取り消されていた場合は、取消として反映します。
- 過去分の取込や会員の一括登録を実行している間は、「取込を開始する」を押せません。
- 「購買履歴の取込を有効にする」がオフのときは押せません。
- 売上の登録に使う端末の取引と、サブスクラインが登録した取引(端末IDを変える前の端末に登録した返品を含む)は、購買履歴に取り込みません。
直近の取込状況の見方
「直近の取込状況」に、過去分の取込と会員の一括登録の実行結果が新しい順に10件まで表示されます。実行中は5秒ごとに自動で更新され、「更新」でも取り直せます。
| 列 | 内容 |
|---|---|
| 開始日時 | 処理を始めた日時 |
| 処理 | 「過去分の取込」または「会員の一括登録」 |
| 状態 | 待機中 / 実行中 / 完了 / 失敗 |
| 対象期間 | 過去分の取込で指定した期間 |
| 処理件数 | 取り込んだ(または登録した)件数 |
| 失敗・対象外 | 取り込めなかった件数と、取り込まなかった(対象外の)件数の合計 |
| エラー | 失敗した理由 |
一部の取引を取り込めなかった場合は、状態が「完了」でもエラー欄に理由が表示されます。
4. 会員を紐付ける
取り込んだ取引をどのLINE会員の購買として扱うかは、スマレジの会員で決まります。
- 自動の紐付け: 取引に記録されたスマレジの会員コードが、LINE会員証のバーコードの番号(会員番号を13桁になるよう先頭を0で埋めた番号)と一致すると、そのLINE会員に自動で紐付けます。店頭でLINE会員証のバーコードを読み取って会計すると、この方法で紐付きます。会員証については 会員証 を参照してください。
- 手動の紐付け: スマレジ側の会員コードが会員証の番号と違う場合は、ユーザー詳細の「店頭の購買履歴(スマレジ)」でスマレジの会員コードを入力し、「会員コードを紐付ける」を押します。
どちらの方法でも、紐付けた時点で、その会員コードで記録された過去の取引もこのお客様の履歴に入ります。会員に紐付いていない取引(会員を指定せずに会計した取引)は、どのLINE会員の履歴にも入りません。
同じ会員コードがすでに別のLINE会員に紐付いている場合や、そのLINE会員が別の会員コードに紐付いている場合は、紐付けられません。
店頭で会員証を読み取る
- スマレジのレジアプリで会員を選ぶ画面を開き、LINE会員証のバーコードを読み取ります。商品を登録する画面で読み取っても、会員は呼び出されません。
- スマレジで会員を呼び出すときは、QRコードではなくバーコードを読み取ってください。会員証のQRコードの中身は、スマレジの会員コードではありません。
- 会員コードを手で入力するときは、紐付け方によって入れる番号が違います。
- 会員証の番号で紐付いている会員(自動の紐付け・一括登録した会員)は、会員番号を13桁になるよう先頭を0で埋めた番号を入れます(例: 会員番号が123なら
0000000000123)。**会員証のバーコードの下に表示される番号は、スマレジの会員コードとは異なります。**下の番号を入力しても会員は見つかりません。 - 手動の紐付けでスマレジ側の別の会員コードに紐付けた会員は、その会員コードを入力します。
- 会員証の番号で紐付いている会員(自動の紐付け・一括登録した会員)は、会員番号を13桁になるよう先頭を0で埋めた番号を入れます(例: 会員番号が123なら
5. 会員をスマレジに一括登録する
会員登録済みのLINEユーザーを、スマレジの会員としてまとめて登録できます。登録した会員は会員証の番号を会員コードに使うので、店頭でLINE会員証を読み取ると、その会員として会計できます。
- 今いる会員をまとめて登録する: 「会員の一括登録」で「一括登録を実行する」を押します。スマレジとまだ紐付いていない会員が対象です。
- 新しい会員も続けて登録する: 接続情報の「LINE会員をスマレジの会員として自動登録する」をオンにして保存します。保存すると一括登録が始まります。その後は、友だち追加や会員登録で新しく会員番号が付いた会員を、1〜2分ほどでスマレジに登録します。店頭で友だち追加した直後のお客様も、そのままLINE会員証を読み取って会計できます。すぐに登録できなかった会員や、CSV取込などで一度に多数増えた会員は、15分ごとの確認でまとめて登録します。初期値はオフです。
登録の内容と条件は次のとおりです。
- 会員コードには、LINE会員証のバーコードの番号(13桁)を使います。
- 同じ会員コードの会員がスマレジにすでにある場合は、新しく作らずに紐付けだけを行います。
- 氏名は、会員登録で入力された姓・名を使います(それぞれ30文字まで)。スマレジでは姓・名が必須の項目で、任意には変えられないため、サブスクラインは必ず姓・名の両方を入れて送ります。足りない部分は次のようにします。
- 姓だけ登録している会員は、名を「-」にします。
- 名だけ登録している会員は、登録した名を姓として登録し、名を「-」にします。
- 姓も名も登録していない会員は、管理画面の表示名、それも無ければLINEの名前、さらに無ければ会員コードを姓として登録し、名を「-」にします。スマレジでは「表示名 -」のように見えます。
- スマレジが氏名の絵文字を受け付けずに登録を断った場合は、絵文字を「-」に置き換えて1回だけ登録し直します。
- スマレジに送るのは姓・名・会員コードだけです。スマレジの会員必須項目設定で、これ以外の項目(電話番号・メールアドレスなど)が必須になっていると登録できません。その場合は処理を止めて「失敗」とし、エラー欄に必須になっている項目名を表示します。自動登録をオンにしていた場合はオフに戻します。スマレジ側でその項目を任意に変えてから、自動登録をもう一度オンにしてください。
- 個別の会員の登録に失敗しても処理は続け、失敗した件数と最後の理由を「直近の取込状況」に表示します。
- 会員番号が付いた直後の登録に失敗した会員は、15分ごとの確認で改めて登録を試みます。そこでも失敗した会員が、次のやり直しの対象になります。
- 失敗した会員は、自動登録がオンなら15分ごとの見回りで間隔を空けて自動でやり直します。最初の失敗の約15分後、次は約1時間後、約6時間後、約24時間後の順に試し、最初の失敗を含めて5回失敗した会員は自動のやり直しを止めます。やり直しで登録できた会員は、そのまま紐付きます。
- 「会員の一括登録」には、スマレジに未登録の会員の人数と、そのうち自動でやり直し中の人数・やり直しを止めた人数、いちばん多いエラーの内容が表示されます。止めた会員や、すぐにやり直したい会員は、エラーの原因を直してから「一括登録を実行する」を押してください。未登録の会員すべてを、もう一度登録します。
- スマレジ側の設定や権限が原因で処理全体が失敗したときは、自動登録をオフに戻し、会員ごとの自動のやり直しは行いません。設定を直してから、自動登録をもう一度オンにしてください。
登録した後にお客様がサブスクラインで氏名を登録・変更したときは、「LINE会員をスマレジの会員として自動登録する」がオンで連携が有効なら、15分ごとにスマレジの会員の氏名も更新します。氏名を登録していなくて名が「-」で登録された会員も、あとで氏名を登録すると更新されます。氏名を登録していない会員は、管理画面の表示名を変えたときも、スマレジの姓を新しい表示名に更新します。
- お店がスマレジで直した氏名は、上書きしません。スマレジの氏名が、サブスクラインが最後に登録・更新した氏名のままの会員だけを更新します。
- 氏名の更新が始まる前にサブスクラインが登録した会員と、お店がもともとスマレジに登録していた会員(紐付けだけを行った会員)は、サブスクラインが送った氏名の記録がありません。これらの会員は、スマレジの名が「-」のときだけ更新します。ただし、サブスクラインが確かめたときにスマレジの氏名がサブスクラインの氏名と同じだった会員は、それ以後の変更を反映します。
- 氏名の更新で絵文字を断られたときは、登録のときと同じく絵文字を「-」に置き換えて1回だけやり直します。
- スマレジが更新を受け付けなかった会員は、次にお客様の情報が変わるまで繰り返しません。スマレジにつながらない・応答が遅いなど一時的な理由で確かめられなかった会員は、次の15分ごとの確認でもう一度確かめます。確かめられない会員が3人続いたときは、スマレジ側の障害とみて、その回の更新を途中で止めます。
- 氏名の更新の進み具合は「直近の取込状況」には表示されません。失敗したときは、「取引の通知(Webhook)」の「直近のエラー」に理由が表示されます(会員ごとの失敗は「LINEユーザーID」と番号付きで表示します)。この表示は、次に取込などが成功すると消えます。
6. 取り込んだ購買履歴を使う
- ユーザー詳細で見る: ユーザー詳細の「店頭の購買履歴(スマレジ)」に、そのお客様に紐付いた取引が新しい順に最大100件表示されます。
- ユーザーグループで絞り込む: ユーザーグループの「購買履歴の条件」で、店頭の購買を条件に配信先を絞り込めます。
7. 売上をスマレジへ登録する
サブスクラインで決済された売上を、スマレジに取引として登録します。
- 先に 1. 接続情報 を保存します。
- 「スマレジ連携」タブの「売上をスマレジへ登録」で「売上の登録を設定する」を押すと、「売上をスマレジへ登録」画面が開きます(2. の画像の下側にあるボタンです)。
- 下の項目を入力して「保存する」を押します。

| 項目 | 内容 |
|---|---|
| 売上をスマレジへ登録する | オンにすると登録を始めます。初期値はオフです。 |
| 店舗ID | 取引を登録するスマレジの店舗IDです。スマレジの管理画面の店舗一覧で確認できます。 |
| 端末ID | 取引の登録に使うスマレジの端末IDです。サブスクラインの売上の登録専用に1台分を用意し、店頭の会計には使わないでください。この端末の取引は、店頭の購買履歴に取り込みません。店頭の会計に使う端末を指定すると、その端末の店頭の取引が購買履歴に取り込まれなくなります。 |
| コンビニ決済の支払方法ID | コンビニ決済の注文に使うスマレジの支払方法IDです。コンビニ決済を使わない場合は空のままで構いません。 |
| 送る売上 | 「注文(モバイルオーダー・EC など)」(初期値オン)、「定期便(サブスク)の課金」(初期値オン)、「予約のカード決済(現地払い・0円の予約は登録しません)」(初期値オフ)から、スマレジへ送るものを選びます。 |
| 送料・サービス料・手数料も明細に含める | 初期値はオンです。オフにすると、スマレジに登録する合計は請求額から送料・手数料を除いた額になります。 |
| 注文・予約をキャンセルしたら、返金していなくてもスマレジの売上を取り消す | 初期値はオンです。オフにすると、キャンセルだけでは取り消さず、返金したときだけ反映します(全額返金は取引を取り消し、一部返金は返品の取引として登録します)。 |
「売上をスマレジへ登録する」をオンにして保存するには、次の条件をすべて満たす必要があります。
- 店舗IDと端末IDを入力している
- 送る売上を1つ以上選んでいる
- 「スマレジ連携」タブで接続情報を保存している
- 旧スマレジ連携(注文時の登録)が設定されていない(設定されていると、同じ注文が二重に登録されるため有効にできません。画面にもその旨が表示されます)
- 端末IDが、「スマレジ連携」タブの「店頭精算(スマレジで滞在料金を支払う)」で使っている端末でない。店頭精算で一度でも仮販売を登録した端末は、店頭精算を無効にした後も指定できません(スマレジに送る取引の番号が重なるため、店頭精算と売上の登録には別々の端末を用意してください)。
登録される内容
- 登録するタイミングは、注文はカード決済の確定時またはコンビニ決済の入金時、定期便は課金の支払いが済んだとき、予約はカード決済が確定したときです。取引日時は決済日時です。
- 「売上をスマレジへ登録する」をオンにする前の決済は、さかのぼって登録しません。
- スマレジに登録する合計は、お客様への請求額(税込)です。決済手数料は差し引きません。
- 0円の決済は送りません。注文・定期便の0円は送信状況に「送らなかった」と記録されます。予約の0円・現地払いは記録しません。
- 明細は税込(内税)で、税率ごとに消費税を計算します。商品・プラン・メニューの税率は、それぞれの編集画面の「税率」(標準税率10%・軽減税率8%)を使います。送料・サービス料・手数料は10%で計算します。
- 商品・プラン・メニューに「スマレジ商品ID」を入れると、スマレジの商品別の売上として集計されます。入れない場合は商品名で登録します。設定する場所は 商品管理・プラン管理・メニュー管理 の各ページを参照してください。定期便と予約は、決済した時点の名前・税率・スマレジ商品IDで登録します。
- コンビニ決済の注文は「コンビニ決済の支払方法ID」で登録します。空のままコンビニ決済の注文が入ると、その注文の登録は失敗になります。
キャンセル・返金したとき
| 操作 | スマレジの取引 |
|---|---|
| 注文・予約をキャンセル(取り消す設定がオン) | 取り消します。まだ登録前なら登録しません。ただし、一部返金の返品の取引をスマレジに登録済み(または登録中)の売上は取り消しません(元の取引だけを取り消すと返品だけが残るため)。残りを返金すると、返品の取引で打ち消されます。その返品がスマレジに登録されていないと分かったまま終わった場合(送らなかった・失敗したうち、スマレジ側の確認が要らないもの)は、その時点で、注文・予約がまだキャンセルのままなら売上を取り消します。届いたか分からない返品(送信状況の「理由」欄に「届いたか不明」と表示される記録)がある場合、売上は自動では取り消されません(あとで返品の記録が変わっても自動では取り消しません)。このとき売上の取引をスマレジ側で手で取り消さないでください(取り消すと、後の返金で返品の取引だけが残ります)。返品の記録が「失敗」なら、送信状況から再送してください。スマレジを確かめ、返品が無ければ返品を登録します(売上は返品が付いたまま残ります)。「送らなかった」の記録は再送できないため、スマレジで返品の取引の有無を確かめ、無ければスマレジ側で返品の取引を登録してください。まだ登録していない返品は、売上を取り消すと登録しません。 |
| 注文・予約をキャンセル(取り消す設定がオフ) | 取り消しません。返金していなければ売上はそのまま残ります。 |
| 1回で全額を返金 | 取り消します。 |
| 一部返金 | 元の取引はそのまま残し、返金した額を「返品」の取引として登録します。 |
| 一部返金の後に残りを全額返金 | 元の取引は取り消さず、まだ返品していない残りの額を「返品」の取引として登録します。 |
返金は、サブスクラインの管理画面から返金した場合に反映します。Stripe の画面から直接行った返金は反映されません。 スマレジ側で修正してください。
- 一部返金の返品の取引の金額は、お客様へ実際に返した額です。手数料をお客様負担として差し引いて返金した場合は、差し引いた後の額になります。
- 全額に達した返金(一部返金の後の残りの返金)の返品の取引は、元の取引のうちまだ返品していない残りの額で登録します。返品の取引の合計が元の取引の合計とちょうど一致するように打ち消すためで、お客様へ返した額と違うことがあります(Stripe の画面から直接一部返金していた場合など)。
- 届いたか分からないまま終わった返品(送信状況で「届いたか不明」と表示される記録)は、返品済みとして残りの額から除きます。スマレジで返品の取引の有無を確かめ、無ければスマレジ側で返品の取引を登録してください。登録すると、返品の取引の合計が元の取引と一致します。
- 「送料・サービス料・手数料も明細に含める」をオフにしている場合は、スマレジに登録した合計と請求額の比で換算した額にします(全額を返金すると、返品の合計は元の取引の合計と一致します)。
- 返品の取引は、元の取引を登録した店舗・端末に登録します(後から店舗ID・端末IDを変えても、元の取引のある店舗で打ち消します)。
- 売上を登録した後で「売上をスマレジへ登録する」をオフにしたり、その売上の種類を送らない設定に変えたりしても、登録済みの売上への返金は登録します。スマレジとの接続が無いとき・連携が無効のときは送りません。
- 返品の取引の明細は、元の取引の明細の金額の比で返金額を分けて作ります。商品名・税率は元の明細のままで、数量は1です。取引のメモに元の取引IDが入ります。
- 返品の明細にはスマレジ商品IDを付けません(付けると、金額だけの返金でもスマレジの在庫が戻るため)。返品はスマレジの商品別の売上には入らず、商品名で登録されます。
- 元の売上のスマレジへの登録が「失敗」になっている間は、返金の登録も「失敗」になります。元の売上を再送して登録できると、返金も自動で登録します。
- 返金した後に Stripe 側で返金が失敗・取り消しになっても、登録した返品の取引は自動では取り消しません。スマレジ側で取り消してください。
- 元の売上がまだスマレジに登録されていないときは、元の売上の登録が済んでから返品の取引を登録します。
- 元の売上をスマレジに登録していない決済(0円・送らない設定にしていた・売上の登録をオンにする前の決済など)や、取り消した売上への返金は登録しません。
キャンセルした予約を支払い済みのまま元に戻したときの扱いは、予約一覧 の「スマレジへ売上を登録している場合」を参照してください。
送信状況を確認する・再送する
画面下の「送信状況」に、直近30日の状態ごとの件数と、送信記録が新しい順に50件まで表示されます。プルダウンで「失敗だけ」「送信待ちだけ」「登録済みだけ」「取消済みだけ」「送らなかったものだけ」に絞り込めます。
| 状態 | 意味 |
|---|---|
| 送信待ち / 送信中 | これからスマレジへ登録する(登録中) |
| 登録済み | スマレジに登録できた。スマレジの取引IDも表示されます |
| 失敗 | 登録できなかった。「理由」に原因が表示されます |
| 送らなかった | 注文・定期便の0円、記録した後で送らない設定に変えた(売上の記録のみ。返金の記録には当てはまりません)、購買履歴の取込をオフにしていた、全額返金で元の取引を取り消した、などの理由で登録しなかった |
| 取消待ち / 取消中 / 取消済み | キャンセル・返金にあわせてスマレジの取引を取り消す(取り消した) |
返金の記録は「売上」の列に「返金」と表示され、金額の前にマイナスが付きます。金額はスマレジに登録した返品の額(まだ登録していなければ登録する予定の額)で、お客様へ返した額と違うとき(全額に達して残りの額で打ち消した返金、送料・手数料を含めない設定など)は、その下に「返金額」も表示します。「決済・返金日時」の列は、返金の記録では返金した日時です。
- 一時的なエラーで登録できなかったときは、1分・2分・4分・8分の間隔で自動的にやり直し、5回まで試します。
- 「失敗」の記録と、送信待ち・取消待ちのまま15分以上進んでいない記録には「再送」ボタンが表示されます。原因(店舗ID・端末ID・支払方法IDなど)を直してから押してください。
- 「届いたか不明のため、再送時はスマレジ側を確認してから送ります。」と表示されている記録は、前回の送信がスマレジに届いたか確認できなかったものです。再送するときは、スマレジに同じ取引があるかを先に確認してから送るため、二重には登録しません。
- 「スマレジ連携」タブで「購買履歴の取込を有効にする」をオフにしている間や、連携を解除した後は、売上を登録しません。この間に送らなかった売上は、後から再送できません。
8. 会計ソフトで二重に計上しないために
カード決済(注文・定期便の課金・予約)の売上は、スマレジに「クレジット預り」の取引として登録します。コンビニ決済の注文は、設定した支払方法の取引として登録します。
スマレジと連携した会計ソフトにこの取引が売上として取り込まれる場合、同じ売上を、決済代行会社からの入金をもとに会計ソフト側でも売上として登録すると、二重に計上されます。会計ソフト側で入金をどう扱うかは、会計ソフトの設定をご確認ください。
あわせて、次の点にもご注意ください。
- スマレジ側で同じ売上を別に入力している場合(例: 予約の売上を店頭のレジで入力している)、その種類の「送る売上」をオンにすると二重になります。予約のカード決済が初期値でオフになっているのはこのためです。
- 「送料・サービス料・手数料も明細に含める」をオフにすると、スマレジに登録する合計がお客様への請求額より少なくなります。
- スマレジに登録する金額は請求額で、決済手数料は差し引いていません。
9. 店頭精算(スマレジで滞在料金を支払う)
滞在課金のプランで、会員がチェックアウトするときの滞在料金を、店頭のスマレジで支払えるようにする設定です。有効にすると、会員の滞在料金の支払い画面に「スマレジで支払う」が表示されます。設定していないクライアントや無効にしているクライアントでは表示されず、これまでどおりカードで支払います。
店頭精算でスマレジ側に用意するもの
- スマレジとの接続: 1. 接続情報を登録するで接続情報を保存し、「接続テスト」で接続できることを確認します。スマレジ・デベロッパーズのアプリで、取引の登録・参照の権限(
pos.transactions:writeとpos.transactions:read)を有効にしておきます。 - 仮販売の通知: 2. 取引の通知(Webhook)を設定するで、仮販売のイベント(
pos:temporary-transactions)も有効にします。通知が届かない場合も、会員の画面を開いている間と、10分ごとの見回りでスマレジに支払いの状態を確認して取り込みます。 - 店舗と端末: 仮販売を登録するスマレジの店舗の店舗IDと、端末の端末IDを確認します。店舗IDは「接続テスト」で表示される店舗の一覧で確認できます。端末は、売上をスマレジへ登録で使う端末とは別の端末を用意してください。
- 滞在料金の商品: スマレジの商品マスタに、滞在料金として明細に載せる商品を1つ登録し、その商品ID・商品コード・商品名を控えます。
ご契約のプランで、API連携(スマレジ・デベロッパーズのアプリ)や仮販売を使えるかは、スマレジにご確認ください。
使い始める前に店頭で試してください
店頭のスマレジでコードを読み取ってから会計を終えるまでの操作は、お使いのスマレジの端末と設定で、会員に案内する前に一度お試しください。スマレジ・デベロッパーズの開発環境(サンドボックス)につないで試すこともできます。
設定する
「スマレジ連携」タブの「店頭精算(スマレジで滞在料金を支払う)」で、次の項目を入力し、「店頭精算を有効にする」をオンにして「保存する」を押します。
| 項目 | 内容 |
|---|---|
| 店頭精算を有効にする | オンにすると、会員の滞在料金の支払い画面に「スマレジで支払う」が表示されます。 |
| 店舗ID | 仮販売を登録するスマレジの店舗IDです。 |
| 端末ID | 仮販売の登録に使うスマレジの端末IDです。 |
| 商品ID・商品コード・商品名 | 明細に載せる滞在料金の商品です。スマレジの商品マスタに登録した値を入力します。 |
- 有効にして保存するときは、すべての項目の入力と、スマレジへの接続・権限(スコープ)を確認します。足りないものがあると、その理由が表示され、保存できません。
- 端末IDに、売上の登録(7.)で使っている端末を指定すると保存できません。
- 入力内容を変えるときは、値を直して「保存する」を押します。
- やめるときは、「店頭精算を有効にする」をオフにして「保存する」を押します。会員の画面に「スマレジで支払う」が表示されなくなります。すでにコードを表示している会員は、そのコードで店頭で支払うか、「カードで支払う」に切り替えられます。
支払いの記録
- 店頭のスマレジで精算されると、その金額を滞在料金の支払いとして記録し、チェックアウトします。チェックアウト時刻は、会員が「スマレジで支払う」を押して仮販売を登録した時刻です(同じ金額のまま押し直した場合は、最初に登録した時刻のままです)。
- 請求額は、会員が「スマレジで支払う」を押した時点の滞在時間とクーポンで決まります。スマレジには、明細1行(単価=割引前の滞在料金、値引き=クーポンの割引額、数量1、税込)の仮販売として登録します。
- 店頭精算の支払いは、プランの「決済成功時のポイント付与」の対象外です(カードでの滞在料金の支払いと同じです。このポイントはサブスクリプションの請求の決済が成功したときに付与します)。
- 自動応答の「ポイント増減」で付与方法を「精算金額に応じて付与」にしている場合は、店頭精算でもレジで支払われた合計をもとにポイントを付与します。詳しくは 精算金額に応じたポイント付与 を参照してください。
- 会員がコードを表示したまま24時間が過ぎると、スマレジ側の仮販売を取り消して支払い待ちを取り下げます。
- スマレジで仮販売が見つからなくなった支払い待ちは、店頭で精算されたかどうかを確かめられないため、自動では取り下げません。会員が「カードで支払う」などを押すと「お支払いの状態を確認できません。お手数ですがお店のスタッフにお声がけください。」と表示されます。このときはサブスクラインの運営に通知が届きます。お店では、スマレジの取引でその会員の精算があったかを確かめ、サブスクラインのサポートにご連絡ください。
支払い待ちの間に止まる操作
会員がコードを表示している間(支払い待ち)と、店頭精算で支払った後は、二重に請求しないよう次の操作を止めます。「店頭のスマレジでのお支払いが進行中です。」などと表示されたら、会員に店頭で支払ってもらうか、会員の画面で「カードで支払う」に切り替えてもらってから、もう一度お試しください。
- 管理画面・会員の画面からのチェックアウト、チェックイン取消、チェックアウト取消、カードでの滞在料金の支払い、滞在課金の編集は、支払い待ちの間はできません。
- 支払い待ちの会員がいる間は、連携の解除と、契約ID・接続先の変更ができません。
10. 来店スタンプ
スマレジで会員証を読み取った会計をきっかけに、お客様へ来店スタンプを付与できます。来店スタンプの有効・無効、必要数、特典名、付与のきっかけ(チェックイン・店頭の会計)の設定は、設定の「マイページ」タブの来店スタンプで行います。会計で付与するには、付与のきっかけで「店頭の会計」を選んでください。特典の使い方・履歴の確認も同じページを参照してください。
会計でスタンプが付与される条件
- スマレジで会員証のバーコードを読み取った会計(このお客様に紐付いた会計)で、商品を1品以上購入した日に1個付与します。購入金額は問いません。
- 1日に何回会計しても、付与は1日1個までです(同じ日にチェックインで付与済みなら、会計では付与しません)。日付の区切りは日本時間の0時です。
- 付与するのは、来店スタンプを有効にした日時以降の会計だけです。有効にする前の会計は、過去分の取込で後から取り込んでも付与しません。設定画面に有効にした日時が表示されます。
- 取消・返品の会計と、明細の無い会計では付与しません。スマレジで会計を取り消すと、その会計で付与したスタンプも取り消します(同じ日に別の会計があれば、その会計のスタンプとして残ります。付与のきっかけに「チェックイン」を選んでいて、その日にチェックインしていた場合は、チェックインのスタンプとして残ります)。
- 会計の後で会員を紐付けた場合は、紐付けたときにその会計のスタンプを付与します。紐付けを解除すると、その会員コードの会計で付与したスタンプを取り消します。
- 来店スタンプを無効にしている間と、付与のきっかけで「店頭の会計」を外している間は、会計では付与しません。それまでに付与したスタンプは残ります。ただしその間に元の会計が取り消されたり紐付けを解除したりした場合は、そのスタンプを取り消します。
11. 会計金額に応じたポイント
スマレジで会員証を読み取った会計の金額に応じて、お客様にポイントを付与する設定です。付与したポイントは、ほかのポイントと同じようにお客様の保有ポイントに加わり、ポイント残高と履歴に「スマレジでのお買い物」として表示されます。設定はこのページの下にある「会計金額に応じたポイント」で行います。
10. 来店スタンプと同時に使えます。来店スタンプとポイントは別々に付与され、どちらかの付与が一時的に失敗しても、もう一方は止まりません(失敗した方は自動でやり直します)。
設定する
| 項目 | 内容 |
|---|---|
| 会計金額に応じたポイントを有効にする | オンにすると付与が始まります。有効にした日時が設定画面に表示されます。 |
| 付与率(%) | 1〜100の整数で指定します。初期値は1で、100円で1ポイントです。1ポイント未満は切り捨てます。 |
| ポイントの有効期間 | 付与した日から数えた日数・週数・月数で指定します。空欄にすると無期限です。 |
ポイントが付与される条件
- スマレジで会員証のバーコードを読み取った会計(このお客様に紐付いた会計)に、会計の合計金額(税込・値引後)× 付与率 のポイントを付与します。例えば付与率10%で1,980円の会計なら198ポイントです。
- 付与は会計1件につき1回だけです。スマレジからの通知が重なって届いたり、過去分の取込で同じ会計を取り込み直したりしても、二重には付与しません。
- 付与するのは、有効にした日時以降の会計だけです。有効にする前の会計は、過去分の取込で後から取り込んでも付与しません。
- 取消の会計、会員に紐付いていない会計、計算したポイントが1ポイント未満になる会計(0円の会計を含む)では付与しません。
- 会計の後で会員を紐付けた場合は、紐付けたときにその会計のポイントを付与します。
- 付与した後で付与率を変えても、付与済みのポイントは変わりません。
取消・紐付けの解除・返品のとき
- スマレジで会計を取り消すと、その会計で付与したポイントを回収します(ポイント履歴に「スマレジでのお買い物の取消」として表示されます)。回収は1回だけです。
- お客様がすでにポイントを使っていて残りが足りないときは、残っている分だけを回収します。保有ポイントがマイナスになることはありません。
- 紐付けを解除すると、その会員コードの会計で付与したポイントを回収します。別のお客様に紐付け直した場合は、そのお客様に付与し直します。同じお客様に紐付け直した場合は、回収を取り消して元に戻します。無効にしている間や、もう一度有効にして「有効にした日時」が新しくなった後でも元に戻します。
- スマレジで返品の会計をすると、元の会計で付与したポイントを上限に、返品の割合(返品の金額 ÷ 元の会計の金額)だけ1回差し引きます(ポイント履歴に「スマレジでのお買い物の返品」として表示されます)。例えば1,980円の会計で198ポイント付与し、そのうち980円分を返品すると98ポイントです。付与した後で付与率を変えても、差し引く量は付与したポイントをもとに計算します。
- 同じ会計を何回かに分けて返品しても、差し引く合計は元の会計で付与したポイントまでです。
- 元の会計でポイントを付与していない場合(有効にする前の会計、元の会計がお客様に紐付いていない場合、元の会計と返品で紐付いたお客様が違う場合など)は差し引きません。元の会計が後から同じお客様に紐付いたときは、そのときに付与と差し引きをそろえます。
- 保有ポイントが足りないときは、残っている分だけを差し引きます。返品の会計を取り消した場合や紐付けを解除した場合は、差し引いた分を戻します(同じお客様に紐付け直すと、もう一度差し引きます)。元の会計が取り消されて付与したポイントを回収するときは、返品で差し引いた分を戻してから付与した分を回収します(二重には差し引きません)。
無効にしたとき
- 無効にしている間は、新しく付与・差し引きしません。
- 無効にしても、それまでに付与したポイントは残ります。ただし無効の間に元の会計が取り消されたり紐付けを解除したりした場合は、そのポイントを回収します(返品の取消なら差し引いた分を戻します)。
- もう一度有効にすると、その日時が新しい「有効にした日時」になり、それ以降の会計が付与の対象になります。
履歴を確認する
付与・回収・差し引きは、ユーザー詳細の「ポイント」タブのポイント履歴で確認できます。この機能で付与したポイントは、管理画面から編集・削除できません。