Square員工資料與ReceiptRoller員工資料的對應關係

Square 員工 Team API POS連動資料對應

在Square負責交易的員工，是以Team Member的形式在Square端進行管理。透過與ReceiptRoller的員工資料（StaffDto）建立關聯，即可運用於交易資料的負責人解析、銷售統計、人事費用管理等用途。

目前版本的運作方式
Square Team Member與ReceiptRoller員工資料並不會自動同步。這是需要在ReceiptRoller端建立員工，並手動輸入對應Square Team Member ID的明示連結方式。

欄位對應表

Square Team Member	ReceiptRoller（`StaffDto`）	備註
`id`	`SquareTeamMemberId`	Square端的Team Member ID。需手動輸入至ReceiptRoller員工紀錄以建立關聯。
`family_name`	`LastName`	參考值。於ReceiptRoller端建立員工時手動輸入。
`given_name`	`FirstName`	參考值。同上。
`email_address`	`Email`	參考值。同上。
`phone_number`	`Phone`	參考值。同上。
`status`	`IsActive`	Square的 `ACTIVE` = `true`、`INACTIVE` = `false`。需手動同步。
`is_owner`	—	ReceiptRoller無對應概念。ReceiptRoller端以 `Position`（職稱）表示。

建立關聯的步驟

於Square儀表板中，確認欲關聯的Team Member的Team Member ID（顯示於URL或團隊成員詳細頁面）。
於ReceiptRoller的門市管理畫面開啟「員工」→「新增員工」。
輸入姓、名、聯絡方式等資料，並在Square Team Member ID欄位貼上Square端的ID。
儲存後，此員工便會自動被連結為Square所發生交易的負責人。

交易資料的負責人解析

當交易資料從Square送達時，交易中所含的 team_member_id 會與 StaffDto.SquareTeamMemberId 進行比對，藉此解析出對應的員工。若未比對成功，交易的負責人欄位將維持空白（之後若在ReceiptRoller端建立員工並貼上ID，也會反映至過去交易的顯示中）。

不會被匯入的項目

Square Team Member的職稱、部門、據點資訊 — Square端的Team設定（Locations或Wage Settings）不屬於同步對象。
Square Team Member的薪資資訊 — ReceiptRoller的 HourlyRate 等與Square相互獨立。
新Team Member的自動匯入 — 於Square新增的Team Member不會自動反映至ReceiptRoller端。請手動建立員工紀錄。

同步時機

Team Member的匯入：目前版本不提供自動同步。請一邊查看Square儀表板，一邊於ReceiptRoller端手動建立、更新員工資料。
交易時的負責人解析：於匯入交易資料時，以 SquareTeamMemberId 為鍵即時解析。

注意事項

若在Square端實體刪除Team Member，過去交易中的 team_member_id 將失效。建議在Square改用停用（INACTIVE）處理。
即使在ReceiptRoller端將員工設為 IsActive = false（離職狀態），過去交易資料的負責人解析仍會持續生效。建議保留離職員工的紀錄，不予刪除。
若一位Team Member需負責多間門市，請在ReceiptRoller員工紀錄的 AssignedStoreIds 中設定多間門市。
目前正在評估透過Square Team API（SearchTeamMembers）進行整批匯入的可行性。如有需求，歡迎與支援團隊聯繫。