StaffDto รีเฟอเรนซ์

สตาฟ พนักงาน ดาต้าโมเดล รีเฟอเรนซ์ การเชื่อมต่อ POS

บทความนี้เหมาะสำหรับใคร
สำหรับนักพัฒนาที่จัดการมาสเตอร์สตาฟ（พนักงาน）ของ ReceiptRoller ผ่าน API・MCP อธิบายการผูกกับข้อมูลผู้รับผิดชอบของ POS และลอจิกการหา「สตาฟผู้รับผิดชอบ」ของข้อมูลธุรกรรม

StaffDto คือโมเดลมาตรฐานของมาสเตอร์สตาฟ（พนักงาน）ของ ReceiptRoller ใช้ในการจัดการกะ・ลงเวลา・การรวมยอดตามผู้รับผิดชอบการขาย・การคำนวณค่าแรง ฯลฯ จัดการในระดับบัญชีธุรกิจ และอิงได้กับหลายร้านค้าภายใต้บัญชีนั้น

จัดการแยกจากลูกค้า（CrmCustomerDto）โดยสิ้นเชิง ลูกค้าคือลูกค้าที่เข้าร้าน ส่วนสตาฟคือพนักงานที่ทำงานในร้าน

ฟิลด์หลัก

ตัวระบุ・ข้อมูลพื้นฐาน

ฟิลด์	ชนิด	เนื้อหา
`OrganizationId`	string	ID บัญชีธุรกิจ PartitionKey
`StaffId`	string	ID สตาฟภายในของ RR（GUID）RowKey
`UserId`	string	การผูกกับบัญชีผู้ใช้ RR（ไม่บังคับ）สำหรับการล็อกอินของพนักงานในอนาคต มีเฮลเปอร์ `IsLinkedToUser`
`EmployeeNumber`	string	เลขที่พนักงาน（หมายเลขที่ผู้ดำเนินงานร้านใช้）
`LastName` / `FirstName`	string	นามสกุล・ชื่อ มีพร็อพเพอร์ตี `FullName`
`DisplayName`	string	ชื่อที่แสดง เป็นฟอลแบ็กที่ใช้เมื่อนามสกุล・ชื่อว่าง（แบบนิกเนม）

ข้อมูลการจ้างงาน

ฟิลด์	เนื้อหา
`Position`	ตำแหน่ง（ผู้จัดการร้าน, รองผู้จัดการร้าน, สตาฟ ฯลฯ）เป็นข้อความอิสระ
`EmploymentType`	`FullTime`（พนักงานประจำ）/ `PartTime`（พาร์ตไทม์・อาร์ไบต์）/ `Contract`（พนักงานสัญญาจ้าง）/ `Other` แปลเป็นภาษาญี่ปุ่นด้วย `EmploymentTypeDisplayName`
`HourlyRate`	ค่าจ้างรายชั่วโมง（decimal）จัดรูปเป็น「¥1,200/ชม.」ด้วย `FormattedHourlyRate`
`HireDate`	วันเข้าทำงาน
`AssignedStoreIds`	ID ร้านค้าที่สังกัด คั่นด้วยจุลภาค อ่านเขียนเป็นอาร์เรย์ได้ด้วย `AssignedStoreIdList`

ข้อมูลติดต่อ・ข้อมูลส่วนบุคคล

Phone, Email, DateOfBirth, Address, ProfileImageUrl ผู้ติดต่อฉุกเฉินมี EmergencyContactName / EmergencyContactPhone / EmergencyContactRelation

ฟิลด์สำหรับการเชื่อมต่อ POS

ฟิลด์	เนื้อหา
`SquareTeamMemberId`	Team Member ID ของ Square Team ลิงก์แบบชัดแจ้งเพื่อผูกสตาฟ RR กับผู้รับผิดชอบของ Square หาย้อนกลับได้ด้วย `StaffService.FindBySquareTeamMemberIdAsync()`

กรณี スマレジ เวอร์ชันปัจจุบันฝั่ง StaffDto ยังไม่มีฟิลด์เฉพาะ จึงอ้างอิง StaffId（ID ภายในของ スマレジ）ในรายละเอียดธุรกรรมตามเดิม รายละเอียดดูได้ที่ การแมปปิงข้อมูลสตาฟของ スマレジ

อื่น ๆ

Notes（ข้อความอิสระ）, IsActive（ผู้ลาออกแล้วเป็น false）, CreatedAt, UpdatedAt

การหาผู้รับผิดชอบจาก POS

ธุรกรรม POS（PosTransactionDto）มี ID และชื่อของสตาฟผู้รับผิดชอบรวมอยู่ด้วย วิธีหาสตาฟนี้ให้เป็น StaffDto ของ RR แตกต่างกันไปตาม POS

Square：เทียบ team_member_id ของธุรกรรมกับ StaffDto.SquareTeamMemberId จำเป็นต้องสร้างสตาฟไว้ฝั่ง RR ล่วงหน้าและกรอก Team Member ID ของ Square
スマレジ：ใช้ staffId（ID ภายในของ スマレジ）และ staffName ของธุรกรรมตามเดิมในการแสดงใบเสร็จหรือการรวมยอดขาย การแมปอัตโนมัติกับ StaffDto ของ RR ยังไม่รองรับในเวอร์ชันปัจจุบัน

การแมปปิงจาก POS

ข้อควรทราบ

คีย์ที่ไม่ซ้ำคือการรวม OrganizationId กับ StaffId
ใช้ IsActive = false เพื่อแสดงการลาออก หลีกเลี่ยงการลบทางกายภาพ และแนะนำการลบเชิงตรรกะ เพราะแม้ลาออกแล้วก็ยังจำเป็นต่อการหาผู้รับผิดชอบของธุรกรรมในอดีต
SquareTeamMemberId เป็นการตั้งค่าด้วยมือ เมื่อเพิ่ม Team Member ของ Square ใหม่ ให้สร้างเรกคอร์ดสตาฟ RR ที่สอดคล้องแล้วแปะ ID เข้าไป
สามารถรับผิดชอบหลายร้านได้ด้วย AssignedStoreIds ใช้ในการกรองตอนจัดการกะหรือรวมยอดขาย

คู่มือที่เกี่ยวข้อง

PosTransactionDto รีเฟอเรนซ์ — โมเดลมาตรฐานของข้อมูลธุรกรรม
CrmCustomerDto รีเฟอเรนซ์ — มาสเตอร์ลูกค้า（จัดการแยกจากสตาฟ）
กลับไปที่หน้าแรกเฮลป์สำหรับนักพัฒนา

วันที่เผยแพร่: 2569-05-29 วันที่อัปเดต: 2569-07-05

กลับไปที่รายการวิธีใช้งาน

หมวดหมู่

ทั้งหมด ทั่วไป 14 Webhook 6 การแก้ปัญหา 6 การลงทะเบียนแอปพลิเคชัน 5 คู่มือตามประเภทข้อมูล 5 พื้นฐาน API 5 การดำเนินงานและความปลอดภัย 4 เริ่มต้นใช้งาน 4 การยืนยันตัวตนและข้อมูลรับรอง 3 คู่มือแยกตามโดเมนข้อมูล 3

แท็ก

API (22) OAuth (15) Android (10) iOS (9) Webhook (8) api (7) oauth (5) getting-started (4) การลงทะเบียนแอป (4) การแก้ปัญหา (4)