スマレジ
連携のご案内

1. 設定の「外部連携」で、スマレジと連携する

Storebookの設定を開き、「外部連携」タブでPOSシステムにスマレジを選びます。「スマレジアカウントで連携する」の欄にある「スマレジと連携する」ボタンを押すと、スマレジのログイン画面に移ります。スマレジで連携を許可すると、Storebookの設定画面に戻ります。

2. 売上入力で、スマレジの売上を取り込む

売上入力の画面にある「スマレジ から取得」の欄で「売上を取得」ボタンを押すと、その日の売上が入ります。連携した店舗は、毎朝の自動取込（前日分）にも対応しています。手入力で運用している日は上書きしません。

3. ダッシュボードで、売上を確認する

取り込んだ売上は、日次・月次のダッシュボードに反映されます。

スマレジ連携でできること

• スマレジの取引データを読み取り、日次の売上・客数、時間帯別の売上、商品別の売上、税率別の売上を、Storebookの画面に取り込みます。
• スマレジの商品・部門の情報を取り込み、商品別の売上の分類に使います。
• データの流れは、スマレジからStorebookへの読み取りだけです。スマレジの取引・商品・在庫などを書き換える操作は行いません。

利用するスコープ

• pos.transactions:read：取引の取得に使います。日次の売上金額・客数、時間帯別・商品別・税率別の売上の集計元です。
• pos.products:read：商品・部門の取得に使います。商品別の売上の分類に使う情報です。
• pos.stores:read：連携した店舗の情報を確認するために申請しています。現在のStorebookでは、このスコープを使う処理は動かしていません。
• 書き込み系のスコープは要求しません。なお、認証の内部処理として openid（契約IDの取得）と offline_access（トークンの自動更新）も使います。

認証の仕組み

• スマレジのOAuth 2.0（認可コード方式）で連携します。スマレジのIDやパスワードをStorebookが受け取ることはありません。
• 連携を始めるとき、Storebookは不正な画面遷移を防ぐための確認用の値（state）を発行し、スマレジから戻ってきたときに突き合わせます。
• 連携できるのは、Storebookにログインした店長以上の役職の人で、かつ対象の店舗を扱う権限がある人だけです。この確認は、連携を始めるときと、スマレジから戻ってきたときの両方で行います。
• デモ用の環境では、連携できないようにしています。

トークンの保管と更新

• スマレジから受け取ったアクセストークンとリフレッシュトークンは、一般の利用者の権限では読めない専用の置き場に分けて保管します。読み書きできるのはサーバー側の管理権限だけで、店舗のスタッフが画面や通信から見ることはできません。
• データベース全体の保存時暗号化（データベース基盤の機能）がかかっています。トークンの列そのものを追加で暗号化してはいません。守りは、読める人をサーバー側の管理権限だけに絞った専用の置き場に分けていることです。
• トークンの値をログやエラーメッセージに出さない設計にしています。
• アクセストークンの有効期限が近づくと、リフレッシュトークンで自動的に更新します。更新できないとき（リフレッシュトークンが失効したときなど）は、取込の操作をした際に、設定画面から連携をやり直すよう案内します。

連携の解除とデータの扱い

• 連携を止めるには、設定の「外部連携」タブのスマレジ連携の欄で「連携を解除」ボタンを押します。確認のメッセージで承諾すると、Storebookに保存していたスマレジのトークンを削除し、連携なしの状態にします。毎日の自動取込と、売上入力画面の取込ボタンも止まります。
• スマレジから利用者契約の解約の通知を受け取った場合は、その契約で連携している店舗の連携情報を削除し、連携なしの状態にする仕組みを備えています。
• 連携を止めても、取り込み済みの売上・商品のデータは削除されず、過去の実績として画面で確認できます。