Square連携による従業員同期
Square POS と連携している場合、Square 側で登録されている Team Members（従業員）の情報をレシートローラーに取り込めます。従業員情報を二重に登録する手間がなくなります。
同期される項目
- 氏名・カナ・メールアドレス・電話番号
- 従業員番号（reference_id）
- ステータス（在籍中 / 退職済み）
- オーナー権限（is_owner）・残業免除（is_overtime_exempt）・チップ受領対象（tip_eligible）
- 担当店舗の割り当て（全店舗 / 個別店舗）
- 職種と給与（job assignments：職種名・給与形態・時給・年俸・週あたり想定労働時間）
レシートローラー独自のフィールド（社内メモ、緊急連絡先、プロフィール写真など）は Square 側に存在しないため、同期しても保持されます。
初回の取り込み（手動同期）
Square 連携を有効にした POS 端末を登録したあと、従業員一覧画面の「Square から取り込み」ボタンをクリックすると、Square Team Members API から従業員一覧を取得し、レシートローラー側に登録します。複数の Square マーチャントを連携している場合は、それぞれのマーチャントから取り込まれます。
Square 側の変更を自動で取り込む
Square 側で従業員を追加・変更すると、Webhook（team_member.created / team_member.updated）を受け取って、自動でレシートローラー側にも反映されます。手動で同期をやり直す必要はありません。
同期の向きについて
同期は Square からレシートローラーへの一方向 です。レシートローラー側で従業員情報を編集しても、その内容が Square に書き戻されることはありません。Square 側の情報も正しく保ちたい場合は、Square 側でも編集してください。
逆に言えば、レシートローラー側で設定した職種・担当店舗・独自フィールドが Square 側の都合で上書きされることもありません。ただし、上記の同期される項目は Square 側の変更で更新されます。
マルチジョブの扱い
Square では1人の従業員に複数の job assignment（職種＋給与＋適用店舗）を割り当てられます。レシートローラー側でも同じ構造で取り込まれ、編集画面では JSON 形式でまとめて管理できます。プライマリージョブ（一覧表示用の主たる職種）は自動的に1件目として扱われます。
同期されないケース
- Square 側で削除された従業員は、レシートローラー側ではステータスが「退職済み」に変わります（レコード自体は履歴として残ります）
- レシートローラー側で削除しても、Square 側のレコードは自動削除されません（誤操作防止のため）
関連記事
-
SquareのPOS連携設定SquareのPOSをレシートローラーと連携する手順を説明します。OAuth認証で簡単に接続でき、会計データがリアルタイムで同期されます。
-
Square スタッフデータとレシートローラースタッフデータのマッピングSquare Team Member がレシートローラーのスタッフデータ（StaffDto）にどう関連付けられるかを説明します。手動リンクの運用方法、取引データの担当者解決ロジック、Team Member API の主要フィールドまでまとめています。
-
スマレジ・Square との会員情報双方向同期レシートローラーの会員情報は、連携している POS（スマレジ・Square など）と双方向で同期されます。本記事では、双方向同期の仕組み、同期される項目、同期のタイミング、競合時の優先順位、対応 POS、設定方法、トラブルシューティングをご案内します。
-
POSとの連携レシートローラーと連携できるPOSシステムの概要と、接続方法を説明します。Square・スマレジに対応しています。
-
Square 顧客データとレシートローラー顧客データのマッピングSquare Customer Directory がレシートローラーの顧客データ（CrmCustomerDto）にどう変換されるかをフィールド単位で説明します。given_name / family_name の対応、住所の分解ロジック、reference_id の扱いまでまとめています。