Square で取引を担当したスタッフは、Team Member として Square 側で管理されています。レシートローラーのスタッフマスタ（StaffDto）と関連付けることで、取引データの担当者解決・売上集計・人件費管理に活用できます。

フィールド対応表

関連付けの手順

1. Square ダッシュボードで、対象 Team Member の Team Member ID を確認します（URL またはチームメンバー詳細ページに表示）。
2. レシートローラーの店舗管理画面で「スタッフ」→「スタッフを追加」を開きます。
3. 姓・名・連絡先などを入力し、Square Team Member ID 欄に Square 側の ID を貼り付けます。
4. 保存後、Square で発生する取引の担当者として、このスタッフが自動的に紐付けられます。

取引データの担当者解決

Square から取引データが届くと、取引に含まれる team_member_id が StaffDto.SquareTeamMemberId と照合され、対応するスタッフが解決されます。マッチしなかった場合は、取引の担当者欄は空のまま記録されます（後から RR 側でスタッフを作成して ID を貼れば、過去取引の表示にも反映されます）。

取り込まれない項目

• Square Team Member の役職・部門・拠点情報 — Square 側の Team 設定（Locations や Wage Settings）は同期対象外。
• Square Team Member の給与情報 — RR の HourlyRate 等は Square と独立。
• 新規 Team Member の自動取り込み — Square で追加された Team Member は、RR 側に自動的には反映されません。手動でスタッフレコードを作成してください。

同期のタイミング

• Team Member の取り込み：現バージョンでは自動同期なし。Square ダッシュボードを見ながら、RR 側で手動でスタッフを作成・更新します。
• 取引時の担当者解決：取引データ取り込み時に SquareTeamMemberId をキーに即時解決。

注意点

• Square 側で Team Member を物理削除すると、過去取引の team_member_id が無効になります。Square では非アクティブ化（INACTIVE）を推奨します。
• RR 側で IsActive = false（退職扱い）にしても、過去取引の担当者解決は引き続き機能します。退職スタッフのレコードは削除せず残しておくことを推奨します。
• 1 人の Team Member が複数店舗を担当する場合は、RR のスタッフレコードの AssignedStoreIds に複数店舗を設定してください。
• 将来的に Square Team API（SearchTeamMembers）からの一括取り込みを検討しています。要望があればサポートチームまでお寄せください。

関連ガイド

• StaffDto リファレンス（開発者向け）— 正規モデルの全フィールド仕様
• Square 取引データのマッピング
• Square 顧客データのマッピング
• Square の POS 連携設定