SquareのPOS連携設定

Square POS連携 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 コードなど)を管理したい場合に取り込んでください。

  1. 店舗管理画面の「商品管理」を開きます。
  2. 右上のメニュー(︙アイコン)から「Squareから同期」をクリックします。
  3. Square Catalog API 経由で全商品とカテゴリが取り込まれ、新規追加・更新が自動で行われます。
  4. 同期完了後、画面上部に取り込み件数が表示されます。

取り込まれる項目とフィールド対応、Square 固有の挙動(複数 Variation の扱い、原価が取り込まれない理由など)の詳細は Square 商品データとレシートローラー商品データのマッピング をご覧ください。

商品マスタを取り込まなくても、商品別売上分析は機能します(取引明細から商品名・カテゴリが自動集計されるため)。原価管理や利益分析を行いたい場合のみ取り込みをご検討ください。

データの手動同期

端末カードをクリックして詳細画面を開き、「Squareと同期」ボタンをクリックすると、直近30日分(または前回同期以降)の取引データを手動で取り込むことができます。同期完了後、「Squareと同期しました。○件の取引を取得しました。」と表示されます。

通常は会計ごとにリアルタイムでデータが送信されるため、手動同期は初回連携時や再同期が必要な場合に使用します。

端末の編集・削除

端末詳細画面から端末名やロケーション情報を編集できます。連携を解除する場合は「削除」ボタンから端末を削除してください。

データの内部構造を確認したい場合

Square から取得した取引データが、レシートローラー内部の取引データモデルにどのようにマッピングされているかは、技術解説記事をご覧ください。フィールド単位の対応表・ステータス変換・明細・顧客マッチキー・OAuth トークンの自動リフレッシュなどの内部仕様を整理しています。

関連記事

公開日: 2026-04-15 更新日: 2026-06-03
関連記事