StaffDto リファレンス

スタッフ従業員データモデルリファレンス POS連携

この記事の対象
レシートローラーのスタッフ（従業員）マスタを API・MCP 経由で扱う開発者向けです。POS の担当者情報との関連付けや、取引データの「担当スタッフ」解決ロジックを説明します。

StaffDto はレシートローラーのスタッフ（従業員）マスタの正規モデルです。シフト管理・打刻・売上担当者の集計・人件費計算などに使われます。組織（ビジネスアカウント）単位で管理され、配下の複数店舗にアサインできます。

顧客（CrmCustomerDto）とは完全に別管理です。顧客は来店客、スタッフは店舗で働く従業員です。

フィールド	型	内容
`OrganizationId`	string	ビジネスアカウント ID。PartitionKey。
`StaffId`	string	RR 内部のスタッフ ID（GUID）。RowKey。
`UserId`	string	RR ユーザーアカウントとの紐付け（任意）。将来の従業員ログイン用。`IsLinkedToUser` ヘルパーあり。
`EmployeeNumber`	string	社員番号（店舗運営者が使う番号）。
`LastName` / `FirstName`	string	姓・名。`FullName` プロパティあり。
`DisplayName`	string	表示名。姓・名が空のときに使うフォールバック（ニックネーム的）。

フィールド	内容
`Position`	役職（店長、店長代理、スタッフなど）。フリーテキスト。
`EmploymentType`	`FullTime`（正社員）/ `PartTime`（パート・アルバイト）/ `Contract`（契約社員）/ `Other`。`EmploymentTypeDisplayName` で日本語化。
`HourlyRate`	時給（decimal）。`FormattedHourlyRate` で「¥1,200/時」形式に整形。
`HireDate`	入社日。
`AssignedStoreIds`	所属店舗 ID のカンマ区切り。`AssignedStoreIdList` で配列として読み書き可能。

Phone、Email、DateOfBirth、Address、ProfileImageUrl。緊急連絡先として EmergencyContactName / EmergencyContactPhone / EmergencyContactRelation。

フィールド	内容
`SquareTeamMemberId`	Square Team の Team Member ID。RR スタッフを Square 担当者と関連付けるための明示リンク。`StaffService.FindBySquareTeamMemberIdAsync()` で逆引き可能。

スマレジの場合、現バージョンでは StaffDto 側に専用フィールドを持たず、取引明細の StaffId（スマレジ内部 ID）をそのまま参照します。詳細はスマレジスタッフデータのマッピングをご覧ください。

Notes（フリーテキスト）、IsActive（退職済みは false）、CreatedAt、UpdatedAt。

POS 取引（PosTransactionDto）には担当スタッフの ID と名前が含まれます。これを RR の StaffDto に解決する方法は POS によって異なります。

Square：取引の team_member_id を StaffDto.SquareTeamMemberId で照合。事前に RR 側でスタッフを作成し、Square の Team Member ID を入力する必要があります。
スマレジ：取引の staffId（スマレジ内部 ID）と staffName をそのままレシート表示や売上集計に使用。RR の StaffDto との自動マッチングは現バージョンでは未対応。

OrganizationId と StaffId の組み合わせが一意のキーです。
IsActive = false で退職を表現します。物理削除は避け、論理削除を推奨します。退職後も過去取引の担当者解決に必要なため。
SquareTeamMemberId は手動で設定する運用です。Square の Team Member を新規追加した際は、対応する RR スタッフレコードを作成して ID を貼り付けてください。
AssignedStoreIds で複数店舗を担当できます。シフト管理や売上集計時の絞り込みに使用。