การแมปข้อมูลพนักงาน Square กับข้อมูลพนักงานของ Receipt Roller

Square พนักงาน Team API การเชื่อมต่อ POS การแมปข้อมูล

พนักงานที่รับผิดชอบรายการขายใน Square จะถูกจัดการในฝั่ง Square เป็น Team Member เมื่อเชื่อมโยงกับ ข้อมูลพนักงานของ Receipt Roller (StaffDto) ในฝั่งเรซีทโรลเลอร์ ระบบจะสามารถนำไปใช้ในการระบุผู้รับผิดชอบของข้อมูลการขาย การรวมยอดขาย และการบริหารต้นทุนแรงงานได้

แนวทางการใช้งานในเวอร์ชันปัจจุบัน
ระบบยังไม่รองรับการซิงค์อัตโนมัติระหว่าง Square Team Member และข้อมูลพนักงานของ Receipt Roller เป็นวิธีการลิงก์แบบแมนนวลโดยสร้างพนักงานในฝั่ง RR แล้วกรอก Square Team Member ID ที่ตรงกันด้วยตนเอง

ตารางเทียบฟิลด์

Square Team Member	Receipt Roller (`StaffDto`)	หมายเหตุ
`id`	`SquareTeamMemberId`	Team Member ID ในฝั่ง Square กรอกด้วยตนเองในบันทึกพนักงานของ RR เพื่อเชื่อมโยง
`family_name`	`LastName`	ค่าอ้างอิง กรอกด้วยตนเองเมื่อสร้างพนักงานในฝั่ง RR
`given_name`	`FirstName`	ค่าอ้างอิง เช่นเดียวกับข้างต้น
`email_address`	`Email`	ค่าอ้างอิง เช่นเดียวกับข้างต้น
`phone_number`	`Phone`	ค่าอ้างอิง เช่นเดียวกับข้างต้น
`status`	`IsActive`	`ACTIVE` ของ Square = `true`, `INACTIVE` = `false` ซิงค์ด้วยตนเอง
`is_owner`	—	ไม่มีแนวคิดที่ตรงกันใน RR ฝั่ง RR แสดงด้วย `Position`（ตำแหน่งงาน）

ขั้นตอนการเชื่อมโยง

ตรวจสอบ Team Member ID ของ Team Member เป้าหมายจากแดชบอร์ดของ Square（แสดงใน URL หรือหน้ารายละเอียดสมาชิกทีม）
เปิด "พนักงาน" → "เพิ่มพนักงาน" ในหน้าจัดการร้านค้าของเรซีทโรลเลอร์
กรอกชื่อ นามสกุล และข้อมูลติดต่อ แล้วใส่ ID ในฝั่ง Square ลงในช่อง Square Team Member ID
หลังจากบันทึกแล้ว พนักงานคนนี้จะถูกเชื่อมโยงโดยอัตโนมัติในฐานะผู้รับผิดชอบของรายการขายที่เกิดขึ้นใน Square

การระบุผู้รับผิดชอบในข้อมูลการขาย

เมื่อข้อมูลการขายจาก Square ถูกส่งเข้ามา ระบบจะจับคู่ team_member_id ที่อยู่ในรายการขายกับ StaffDto.SquareTeamMemberId เพื่อระบุพนักงานที่เกี่ยวข้อง หากไม่พบข้อมูลที่ตรงกัน ช่องผู้รับผิดชอบของรายการขายจะถูกบันทึกเป็นค่าว่าง（ภายหลังหากสร้างพนักงานในฝั่ง RR และกรอก ID แล้ว ก็จะสะท้อนไปยังการแสดงผลของรายการขายในอดีตด้วยเช่นกัน）

รายการที่ไม่ถูกนำเข้า

ตำแหน่ง / แผนก / ข้อมูลสาขาที่สังกัดของ Square Team Member — การตั้งค่า Team ในฝั่ง Square（Locations หรือ Wage Settings）ไม่อยู่ในขอบเขตการซิงค์
ข้อมูลค่าจ้างของ Square Team Member — HourlyRate ของ RR เป็นอิสระจาก Square
การนำเข้าอัตโนมัติของ Team Member ใหม่ — Team Member ที่เพิ่มใน Square จะไม่ถูกสะท้อนในฝั่ง RR โดยอัตโนมัติ กรุณาสร้างบันทึกพนักงานด้วยตนเอง

จังหวะเวลาในการซิงค์

การนำเข้า Team Member: ไม่มีการซิงค์อัตโนมัติในเวอร์ชันปัจจุบัน กรุณาดูแดชบอร์ดของ Square และสร้าง/อัปเดตพนักงานด้วยตนเองในฝั่ง RR
การระบุผู้รับผิดชอบเมื่อมีรายการขาย: ระบุได้ทันทีโดยใช้ SquareTeamMemberId เป็นคีย์เมื่อนำเข้าข้อมูลการขาย

ข้อควรระวัง

หากลบ Team Member ออกจริงในฝั่ง Square team_member_id ของรายการขายในอดีตจะใช้งานไม่ได้อีกต่อไป แนะนำให้ใช้การปิดใช้งาน（INACTIVE）ในฝั่ง Square แทน
แม้จะตั้งค่า IsActive = false（สถานะลาออก）ในฝั่ง RR การระบุผู้รับผิดชอบของรายการขายในอดีตจะยังคงทำงานได้ตามปกติ แนะนำให้ไม่ลบข้อมูลพนักงานที่ลาออกแล้ว
หาก Team Member 1 คนรับผิดชอบหลายสาขา กรุณาตั้งค่าหลายสาขาใน AssignedStoreIds ของบันทึกพนักงานฝั่ง RR
อยู่ระหว่างพิจารณาการนำเข้าแบบกลุ่มจาก Square Team API（SearchTeamMembers）ในอนาคต หากมีความต้องการ กรุณาติดต่อทีมซัพพอร์ต

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

StaffDto Reference（สำหรับนักพัฒนา）— ข้อกำหนดฟิลด์ทั้งหมดของโมเดลมาตรฐาน
การแมปข้อมูลการขายของ Square
การแมปข้อมูลลูกค้าของ Square
การตั้งค่าเชื่อมต่อ POS ของ Square

เผยแพร่เมื่อ: 2569-05-29 อัปเดตเมื่อ: 2569-07-03

กลับไปที่รายการช่วยเหลือ

บทความที่เกี่ยวข้อง