SquareのPOS連携設定
Square のPOSをレシートローラーと連携すると、会計のたびに取引データが自動的に送信され、電子レシートが生成されます。連携はSquareアカウントの認証だけで完了します。Squareの開発者設定やAPIキーの入力は不要です。
Step 1:POS端末画面を開く
店舗ダッシュボードの機能カード一覧から「POS端末」をクリックします。POS端末一覧画面が開きます。
Step 2:Squareと連携する
画面右上の「Squareと連携する」ボタンをクリックします。Squareの認証ページに移動します。
Step 3:Squareアカウントで認証する
Squareのログイン画面でSquareアカウントにサインインし、アクセス許可を確認して「許可する」をクリックします。認証が完了すると、レシートローラーに自動的に戻ります。
Step 4:ロケーションを選択する(複数ロケーションの場合)
Squareアカウントに複数のロケーション(店舗・拠点)が登録されている場合、「Squareロケーション選択」画面が表示されます。連携する店舗に対応するロケーションの「このロケーションを選択」をクリックしてください。
ロケーションが1つだけの場合はこの画面はスキップされ、自動的に連携が完了します。
連携完了後の確認
POS端末一覧に「Squareと連携しました」と表示され、新しい端末カードが追加されます。カードには以下の情報が表示されます。
- 端末名(例:Square POS — 店舗名)
- SquareバッジとAPI連携バッジ
- ロケーション(住所)
- 同期済み取引件数
- ステータス(稼働中)
連携後に同期されるデータ
連携が完了すると、以下のデータが Square ↔ レシートローラー間で自動的に行き来します。
| データ種別 | 方向 | タイミング | 詳細 |
|---|---|---|---|
| 取引(売上明細・金額・支払方法) | Square → RR | リアルタイム(Webhook) | Square 取引データのマッピング |
| 顧客情報(氏名・連絡先・会員番号・誕生日・住所) | 双方向 | 登録・更新時に数秒以内 + 1 時間ごとの差分同期 | 会員情報双方向同期 / 顧客データのマッピング |
| 商品マスタ(商品名・SKU・カテゴリ・価格) | Square → RR | 手動同期(商品管理画面の「Squareから同期」ボタン) | 商品データのマッピング |
| スタッフ(Team Member) | 手動リンク | RR 側でスタッフ作成時に Team Member ID を入力 | スタッフデータのマッピング |
商品マスタを取り込む(任意)
取引データは POS 連携の完了と同時に自動取り込みが始まりますが、商品マスタ(商品名・SKU・カテゴリ・価格などの一覧)の取り込みは店舗運営者の任意です。レシートローラー側で原価を入力して利益分析を活用したい場合や、商品ごとの追加属性(ブランド・仕入先・JAN コードなど)を管理したい場合に取り込んでください。
- 店舗管理画面の「商品管理」を開きます。
- 右上のメニュー(︙アイコン)から「Squareから同期」をクリックします。
- Square Catalog API 経由で全商品とカテゴリが取り込まれ、新規追加・更新が自動で行われます。
- 同期完了後、画面上部に取り込み件数が表示されます。
取り込まれる項目とフィールド対応、Square 固有の挙動(複数 Variation の扱い、原価が取り込まれない理由など)の詳細は Square 商品データとレシートローラー商品データのマッピング をご覧ください。
商品マスタを取り込まなくても、商品別売上分析は機能します(取引明細から商品名・カテゴリが自動集計されるため)。原価管理や利益分析を行いたい場合のみ取り込みをご検討ください。
データの手動同期
端末カードをクリックして詳細画面を開き、「Squareと同期」ボタンをクリックすると、直近30日分(または前回同期以降)の取引データを手動で取り込むことができます。同期完了後、「Squareと同期しました。○件の取引を取得しました。」と表示されます。
通常は会計ごとにリアルタイムでデータが送信されるため、手動同期は初回連携時や再同期が必要な場合に使用します。
端末の編集・削除
端末詳細画面から端末名やロケーション情報を編集できます。連携を解除する場合は「削除」ボタンから端末を削除してください。
データの内部構造を確認したい場合
Square から取得した取引データが、レシートローラー内部の取引データモデルにどのようにマッピングされているかは、技術解説記事をご覧ください。フィールド単位の対応表・ステータス変換・明細・顧客マッチキー・OAuth トークンの自動リフレッシュなどの内部仕様を整理しています。
- Square 取引データとレシートローラー取引データのマッピング — 技術詳細
- Square 顧客データとレシートローラー顧客データのマッピング
- Square 商品データとレシートローラー商品データのマッピング
- PosTransactionDto 仕様(フィールドリファレンス) — 取引データモデルの全フィールド
関連記事
-
Square連携による従業員同期Square POSで登録済みのチームメンバーをレシートローラーの従業員として一括同期する方法を説明します。二重登録の手間を省けます。
-
Square スタッフデータとレシートローラースタッフデータのマッピングSquare Team Member がレシートローラーのスタッフデータ(StaffDto)にどう関連付けられるかを説明します。手動リンクの運用方法、取引データの担当者解決ロジック、Team Member API の主要フィールドまでまとめています。
-
スマレジ・Square との会員情報双方向同期レシートローラーの会員情報は、連携している POS(スマレジ・Square など)と双方向で同期されます。本記事では、双方向同期の仕組み、同期される項目、同期のタイミング、競合時の優先順位、対応 POS、設定方法、トラブルシューティングをご案内します。
-
Square 顧客データとレシートローラー顧客データのマッピングSquare Customer Directory がレシートローラーの顧客データ(CrmCustomerDto)にどう変換されるかをフィールド単位で説明します。given_name / family_name の対応、住所の分解ロジック、reference_id の扱いまでまとめています。
-
Square連携による従業員同期Square POS と連携している店舗で、Square Team Members(従業員)の情報をレシートローラーと双方向に同期する方法を説明します。職種・時給・担当店舗・オーナー権限などが Square と整合した状態で管理できます。