上次更新时间:2026年8月20日 13:47
解决 Toast Payroll 中的未映射员工错误——映射缺失的小费配置文件,重新映射错误的 POS 配置文件,并修复 Toast Web 与 Payroll 之间的同步问题。
适用范围:Toast 薪资、Toast Web、Toast POS
所需权限:
您将完成以下任务:确定员工未映射的原因,并正确映射或重新映射他们,以便工时记录、小费和薪资信息在 Toast Web 和 Toast 薪资之间同步。
要打开映射模块:在 Toast Payroll 中,导航至 设置 > Toast > 员工。
有关使用映射工具本身的完整分步过程(接受建议、映射到 POS 员工 下拉菜单、编辑铅笔),请参阅 Toast Payroll:管理员工映射。本文重点介绍当映射未按预期工作时如何解决问题。
| 症状 | 最常见原因 | 快速修复 | 自助服务? |
|---|---|---|---|
| 小费管理阻止了一天,并显示“一名或多名员工未映射。您必须在继续之前映射他们”,但 Payroll 员工 选项卡显示每个人都已映射 | 小费接收配置文件(例如在线订购、默认在线订购、活动选项卡或通用虚拟配置文件)出现在小费管理报告中且未映射 — 即使设置为 在 Payroll 中忽略 | 打开 设置 > Toast > 员工 > 未映射的 POS 员工 并滚动到列表底部,找到标记为 在 Payroll 中忽略 的小费接收配置文件。映射它们或使用编辑铅笔选择要同步到的 Toast Payroll 配置文件。完整步骤:请参阅下方的 解决“未映射员工”错误(当小费无法发送时)。 | 是 |
| 员工在 Toast Payroll 中,但无法在 POS 设备上打卡 | Toast Web 配置文件未映射、已归档或重复 | 在 设置 > Toast > 员工 中映射他们。完整步骤:请参阅下方的 查找并解决未映射的员工。 | 是 |
| POS 中的工时未显示在薪资单的时间表中 | 员工被映射到了错误的 Toast Web 个人资料(通常是自动生成的重复资料) | 重新映射到“最后打卡日期”最近的 Toast Web 个人资料。完整步骤:请参阅下方的 重新映射映射到错误 POS 个人资料的员工。 | 是 |
| 员工的 POS 映射 选项卡显示红色警报图标 | 员工的个人资料和/或职位未映射 | 在 Toast Payroll 中打开员工个人资料,选择 POS 映射 选项卡,然后选择红色警报图标以打开映射视图。完整步骤:请参阅下方的 查找并解决未映射的员工。 | 是 |
| 搜索员工时映射下拉菜单为空,或者未出现编辑铅笔图标 | 存在重复的 Toast Web 个人资料、Toast Web 个人资料已归档,或者员工是在 Toast Payroll 之前在 Toast Web 中入职的 | 查找自动生成的 Toast Web 个人资料并按照 映射已归档或重新聘用的员工 操作,或参考 Toast Payroll 中“员工先在 Toast Web 入职”的情景:管理员工映射。 | 是 |
| 员工在 Toast Payroll 中有两个个人资料 | 入职期间创建了重复的 Toast Payroll 个人资料 | 客户服务部门必须协调重复的 Toast Payroll 个人资料;仅靠映射无法解决这些问题。完整步骤:请参阅下方的 联系客户服务前。 | 否 |
| 主要职位在个人资料映射正确后仍未映射 | 职位映射仅限 Toast 管理员操作 | 在员工的 POS 映射 选项卡中,选择 电子邮件支持 链接以请求职位映射。完整步骤:请参阅下方的 在联系客户服务之前。 | 否 |
在 Toast Payroll 中,有两个地方可以查看员工是否已映射:
要映射他们:
预期结果:该员工的红色警报图标消失,工时条目和小费开始同步。请参阅 Toast Payroll:管理员工映射以获取完整流程,包括映射后重新提交工时条目。
这是客户联系客户服务部门咨询映射问题最常见的原因。小费管理中的错误提示为:
当您选择链接以映射员工时,页面通常会显示每个人都已映射。其原因几乎总是因为某个接收小费的个人资料出现在“小费管理”报告中,但未映射到 Toast Payroll 个人资料——即使该个人资料已设置为 在薪资系统中忽略。
此类个人资料的常见示例:
如果此类资料出现在“小费管理”报告中且未映射,即使将其标记为在工资单中忽略,它也会阻止小费发送。
方法1:
方法2:
如果某个资料同时出现在这两个地方,它就是阻止发送的原因。
如果该资料出现在“小费管理”报告中,则必须将其映射到Toast工资单资料以清除阻止——即使您打算让该资料保持在工资单中忽略状态。
预期结果:“未映射员工”错误清除,当天数据发送至薪资系统。
如果 映射到 POS 员工 下拉菜单中没有可供选择的个人资料,最常见的原因是:
如果这些方法都无法解决问题,请参阅 联系客户服务之前。
如果员工的工时未计入薪资,或者他们的小费缺失,则薪资个人资料可能映射到了错误的 Toast Web 个人资料。这种情况通常发生在 Toast Web 个人资料在 Toast 薪资个人资料之前创建,并且在薪资入职期间创建了第二个自动生成的 Toast Web 个人资料时。可能映射的是自动生成的个人资料,而不是员工实际打卡使用的个人资料。
预期结果:工时和小费将开始从正确的 Toast Web 个人资料同步到 Toast Payroll。
如果 Toast Web 个人资料在映射工具中员工姓名旁边显示(已归档),则必须先取消归档该员工的 Toast Web 个人资料,映射才能解决他们的问题。
对于重新聘用的员工,请遵循 Toast Payroll 中的重新聘用流程。Toast 将自动取消归档旧的 Toast Web 个人资料并重新映射这两个个人资料。无需手动映射。
对于任何其他需要恢复的已归档个人资料,请遵循 恢复已归档员工,然后返回映射工具以验证个人资料是否已关联。
如果员工被添加到第二个地点,并且现在在该地点显示为未映射,则必须在 Toast Payroll 中也添加第二个地点。仅在 Toast Web 中添加地点不会为该地点创建 Payroll 个人资料。请参阅 Toast Payroll:与 Toast Web 同步信息以了解详细信息。
预期结果:工时和小费将开始从取消归档/重新聘用的 Toast Web 个人资料同步到 Toast Payroll。
未映射员工是指其 Toast Web 个人资料和 Toast Payroll 个人资料未连接的员工。当个人资料未映射时,来自 POS 的工时条目将不会流入工资单工时表,小费将不会发送到工资单,并且在工资单上进行的薪资费率或职位更改将不会同步到 Toast Web。
也常被问及:
当每个人都显示为已映射时,小费管理器却说您有一个未映射的员工,这是因为小费管理报告中几乎总会有一个接收小费的个人资料(通常是在线订购、活动标签、幽灵调酒师或其他非人类个人资料)且未映射——即使在设置为 在工资单中忽略 时也是如此。要找到它,请在 Toast Payroll 中导航至 设置 > Toast > 员工 > 未映射的 POS 员工,然后滚动到列表底部。请参阅 解决小费无法发送时的“未映射员工”错误。
也常被问及:
员工 Toast Payroll 个人资料中 POS 映射 选项卡上的红色警报图标表示该员工的个人资料和/或主要职位未映射。选择红色警报图标以打开映射视图,然后使用 编辑 按钮来映射个人资料。如果个人资料映射后主要职位仍未映射,请选择 电子邮件支持 链接以请求 Toast 代表进行职位映射——只有 Toast 管理员可以映射职位。
也常被问及:
员工在Toast Web中处于活动状态但在Toast Payroll中不处于活动状态的最常见原因是,员工是在Toast Web中入职的,但从未在Toast Payroll中入职。所有员工都应首先在Toast Payroll中入职——Toast Payroll随后会自动创建一个匹配的Toast Web个人资料。这包括将现有员工添加到第二个地点:该操作也必须在Toast Payroll中完成。请参阅 Toast Payroll:有关第二个地点的操作流程,请参阅“分配或更改员工职位或地点”。
当员工在POS上看到“无效密码”错误时,这可能表明他们的Toast Web和Toast Payroll个人资料未映射——但也可能意味着POS访问代码本身不正确。请记住:员工编号和POS访问代码是两个不同的数字。员工编号用于标识Toast Payroll中的个人资料。POS访问代码仅用于打卡或登录POS,仅在Toast Web中可见,且并不总是与员工编号一致。请参阅 Toast Payroll:有关区别,请参阅“员工编号和POS访问代码常见问题解答”。
要了解映射时选择哪个POS个人资料,请使用映射到POS员工下拉菜单中的“上次打卡”日期。当员工已经打卡时,将其Toast Payroll个人资料映射到具有工时和消费记录的Toast Web个人资料——他们正在使用该POS访问代码。在确认另一个(重复的)Toast Web个人资料没有工时或消费数据后,即可将其归档。
为防止工时同步错误,请遵循以下两条规则:所有员工必须先在Toast Payroll中入职,而不是在Toast Web中——一旦他们在Toast Payroll中添加,系统会自动且立即创建一个匹配的Toast Web个人资料。并且只有员工时间和小费信息会在 Toast Web 中进行调整。所有其他员工操作(新员工入职、工资率变更、添加地点或职位)均在 Toast Payroll 中进行。请参阅 Toast Payroll:同步 Toast Web 信息以获取完整集成指南。
要修复映射以便将工时从 Toast Web 同步到薪资系统,请使用 Toast Payroll 中的员工映射模块。在 Toast Payroll 中,导航至 设置 > Toast > 员工,并按照 Toast Payroll 中的“如何使用映射工具”部分进行操作:管理员工映射。映射完成后,请在 报告 > 劳动力 > 工时条目管理 处重新提交 Toast Web 中的现有工时条目,以便它们流入薪资系统。
“在薪资系统中忽略”的员工不会停止拦截您的小费,因为如果该资料出现在“小费管理”报告中——通常是接收小费的非人工资料,例如活动标签或在线订购——则必须将其映射到 Toast Payroll 资料才能发送小费,即使它被标记为 在薪资系统中忽略。在薪资系统中忽略设置可防止该资料获得报酬,但不会将其排除在“小费管理”报告的未映射检查之外。请参阅 解决小费无法发送时的“未映射员工”错误。
也常被问及:
一些映射场景确实需要客户服务介入,因为它们涉及只能由 Toast 进行的账户级更改:
如果您确实需要联系客户服务部,请准备好以下信息:
此内容仅供参考,不作为法律、税务、人力资源或其他任何专业建议。请咨询律师或其他专业人士以获取建议。