透過 Square 連動的員工同步
Square
員工管理
POS連動
同步
Team Members
若與 Square POS 連動，可將 Square 端登錄的 Team Members（員工）資訊匯入 ReceiptRoller，並進行雙向同步。無論是在 Square 端新增員工，還是在 ReceiptRoller 端編輯，都會反映至對方。
同步項目
- 姓名・讀音・郵件地址・電話號碼
- 員工編號（reference_id）
- 狀態（在職中 / 停職中 / 已離職）
- 擁有者權限（is_owner）・免除加班（is_overtime_exempt）・小費領取對象（tip_eligible）
- 負責店鋪的分配（全店鋪 / 個別店鋪）
- 職稱與薪資（job assignments：職稱名稱・薪資形式・時薪・年薪・每週預估勞動時間）
ReceiptRoller 獨有的欄位（內部備註、緊急聯絡人、個人檔案照片等）不存在於 Square 端，因此在雙向同步時仍會維持原樣保留。
首次匯入（手動同步）
啟用 Square 連動的 POS 裝置登錄完成後，在員工列表畫面點選「從 Square 匯入」按鈕，即可從 Square Team Members API 取得員工列表，並登錄至 ReceiptRoller 端。若連動多個 Square 商家帳戶，會分別從各商家帳戶匯入。
自動同步
- Square 端有變更時：透過 Webhook 接收 team_member.created / team_member.updated 事件，自動反映至 ReceiptRoller 端
- 於 ReceiptRoller 端編輯時：儲存的同時會以背景方式反映至 Square 端。為避免儲存處理延遲，會以非同步方式執行
多重職務的處理
在 Square 中，一位員工可分配多個 job assignment（職稱＋薪資＋適用店鋪）。ReceiptRoller 端也會以相同結構匯入，並可在編輯畫面以 JSON 格式統整管理。主要職稱（用於列表顯示的主要職務）會自動視為第1筆項目處理。
同步衝突與覆寫規則
雙向同步發生衝突時，會以「最後寫入者優先（last-write-wins）」的原則解決。請避免在相同時間點同時編輯雙方。僅存在於 Square 端的欄位，或僅存在於 ReceiptRoller 端的欄位，在同步時都不會消失，會維持保留。
不會同步的情況
- 在 Square 端被刪除的員工，於 ReceiptRoller 端狀態會變為「已離職」（紀錄本身仍會以歷史紀錄保留）
- 即使在 ReceiptRoller 端刪除，Square 端的紀錄也不會自動刪除（為防止誤操作）
相關文章
發布日期： 2026-06-03
更新日期： 2026-07-03
相關文章
-
與 POS 的連動說明可與 ReceiptRoller 連動的 POS 系統概要，以及連接方式。支援 Square・Smaregi。
-
Square員工資料與ReceiptRoller員工資料的對應關係說明Square Team Member如何與ReceiptRoller的員工資料（StaffDto）建立關聯。內容涵蓋手動連結的操作方式、交易資料負責人解析邏輯，以及Team Member API主要欄位的整理。
-
Square 的 POS 連動設定說明將 Square 的 POS 與 ReceiptRoller 連動的步驟。透過 OAuth 認證即可輕鬆連接，交易資料會即時同步。
-
Square顧客資料與ReceiptRoller顧客資料的對應關係說明Square Customer Directory如何轉換為ReceiptRoller的顧客資料（CrmCustomerDto）。內容涵蓋given_name／family_name的對應、地址的拆解邏輯，以及reference_id的處理方式。
-
電子收據的運作原理說明 ReceiptRoller 電子收據的運作原理，以及與 Square、スマレジ 的 POS 連動方式。