Toast 薪资:获取员工映射方面的帮助

上次更新时间:2026年8月20日 13:47

解决 Toast Payroll 中的未映射员工错误——映射缺失的小费配置文件,重新映射错误的 POS 配置文件,并修复 Toast Web 与 Payroll 之间的同步问题。

本文内容:

 

开始之前

适用范围:Toast 薪资、Toast Web、Toast POS

 

所需权限:

  • Toast 薪资中的 HR+ 用户角色(访问映射模块所必需)

 

您将完成以下任务:确定员工未映射的原因,并正确映射或重新映射他们,以便工时记录、小费和薪资信息在 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 Web 档案,其姓名旁边都会显示 未支付员工 标签。
  • 从员工的个人资料页面。打开员工的 Toast Payroll 个人资料并选择 POS 映射 选项卡。如果该选项卡旁边有一个红色警报图标,则表示员工的个人资料和/或主要职位未映射。

 

旁边带有红色 ! 图标的 POS 映射选项卡

 

要映射他们:

  1. 在 Toast Payroll 中,导航至 设置 > Toast > 员工
  2. 使用 地点 下拉菜单选择员工工作的地点。
  3. 薪资员工 选项卡或 未映射的 POS 员工 选项卡上找到该员工。薪资员工 选项卡列出了需要 Toast Web 匹配的薪资档案。未映射的 POS 员工 选项卡列出了需要薪资匹配的 Toast Web 档案。
  4. 如果您在姓名旁边看到 接受建议 按钮,则系统已根据姓名、电子邮件或员工编号找到了可能的匹配项。如果正确,请选择 接受建议
  5. 如果没有出现建议,或者建议不正确,请选择编辑铅笔图标,并从 映射到 POS 员工 下拉菜单中选择正确的档案。输入部分姓名以缩小结果范围,并使用“最后打卡日期”确认您选择的是员工实际打卡时使用的档案。
  6. 如果员工不应通过薪资系统(Payroll)发放工资(例如,企业角色或通用的非人类个人资料),请选择 忽略此员工

 

预期结果:该员工的红色警报图标消失,工时条目和小费开始同步。请参阅 Toast Payroll:管理员工映射以获取完整流程,包括映射后重新提交工时条目。

 

回到顶部

 

解决小费无法发送时的“未映射员工”错误

这是客户联系客户服务部门咨询映射问题最常见的原因。小费管理中的错误提示为:

  • “抱歉!我们无法批准 X 天。”
  • “X 员工未映射。映射此员工。”
  • “以下日期发送失败。”

 

当您选择链接以映射员工时,页面通常会显示每个人都已映射。其原因几乎总是因为某个接收小费的个人资料出现在“小费管理”报告中,但未映射到 Toast Payroll 个人资料——即使该个人资料已设置为 在薪资系统中忽略

 

此类个人资料的常见示例:

  • 用于归集在线小费的“在线订餐”或“默认在线订餐”员工
  • 用于登记餐饮或活动的“活动标签”或通用餐饮账户
  • 用于小费池的“幽灵调酒师”或通用轮班个人资料
  • 为接收小费池份额而创建的非人类个人资料

 

如果此类资料出现在“小费管理”报告中且未映射,即使将其标记为在工资单中忽略,它也会阻止小费发送。

 

第1步:确认这是原因

方法1:

  1. 停留在报告 > 劳工 > 小费管理
  2. 查看当天无法发送的小费池中的员工列表。滚动浏览每一页以找到导致错误的未映射员工。
  3. 找到带有红色警报图标的员工资料。

 

方法2:

  1. 在 Toast Payroll 中,导航至 设置 > Toast > 员工
  2. 选择未映射的POS员工选项卡。
  3. 滚动到列表底部。标记为在工资单中忽略的在职且接收小费的员工列在底部。
  4. 将此列表与当天无法发送的“小费管理”报告中出现的姓名进行核对。

 

如果某个资料同时出现在这两个地方,它就是阻止发送的原因。

 

第2步:映射资料

如果该资料出现在“小费管理”报告中,则必须将其映射到Toast工资单资料以清除阻止——即使您打算让该资料保持在工资单中忽略状态。

  1. 未映射的POS员工选项卡中,选择资料旁边的编辑铅笔图标。
  2. 映射到POS员工下拉菜单中,选择此小费信息应同步到的Toast工资单资料。对于通用的非人员资料,这通常是为小费池路由创建的相应工资单资料。
  3. 返回“小费管理”报告并尝试再次发送小费。

 

预期结果:“未映射员工”错误清除,当天数据发送至薪资系统。

 

第 3 步:如果下拉菜单为空

如果 映射到 POS 员工 下拉菜单中没有可供选择的个人资料,最常见的原因是:

  • 该地点不存在匹配的 Toast 薪资个人资料。确认 Toast 薪资个人资料处于活动状态,并拥有运行小费池地点的地点权限。
  • Toast 薪资个人资料已归档或已终止。在映射之前重新激活它。
  • 存在重复的 Toast Web 个人资料干扰。查找可能在薪资入职期间创建并取代了活动个人资料的自动生成的 Toast Web 个人资料。归档自动生成的个人资料,并重新映射到包含工时记录和小费数据的原始 Toast Web 个人资料。

 

如果这些方法都无法解决问题,请参阅 联系客户服务之前

 

回到顶部

 

重新映射映射到错误 POS 个人资料的员工

如果员工的工时未计入薪资,或者他们的小费缺失,则薪资个人资料可能映射到了错误的 Toast Web 个人资料。这种情况通常发生在 Toast Web 个人资料在 Toast 薪资个人资料之前创建,并且在薪资入职期间创建了第二个自动生成的 Toast Web 个人资料时。可能映射的是自动生成的个人资料,而不是员工实际打卡使用的个人资料。

 

  1. 在 Toast Payroll 中,导航至 设置 > Toast > 员工
  2. 薪资员工 选项卡上找到该员工。
  3. 记录每个候选 Toast Web 个人资料的“最后打卡”日期。员工实际使用的个人资料将具有最近的“最后打卡”日期。自动生成的个人资料很可能没有“最后打卡日期”,也可能没有 POS 访问代码。
  4. 选择员工姓名旁边的编辑铅笔图标。
  5. 映射到 POS 员工 下拉菜单中,选择 取消映射此员工 以将其从错误的个人资料中取消映射。
  6. 选择员工姓名旁边的编辑铅笔图标。
  7. 映射到 POS 员工 下拉菜单中,选择具有最近“最后打卡日期”的 Toast Web 个人资料。
  8. 在确认自动生成的个人资料没有工时条目或小费数据后,将其在 Toast Web 中归档。
  9. 重新映射后,从 Toast Web 重新提交工时条目,使其流入 Payroll。在 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 员工,然后滚动到列表底部。请参阅 解决小费无法发送时的“未映射员工”错误

 

也常被问及:

    • “我有一个未映射的员工,但在我这边他们都已映射”
    • “它显示我有一个未映射的员工,但我没看到他们处于未映射状态”
    • “我无法将小费发送到工资单,因为员工未映射,但我所有的员工都已映射”

 

POS 映射选项卡上的红色警报图标是什么意思?

员工 Toast Payroll 个人资料中 POS 映射 选项卡上的红色警报图标表示该员工的个人资料和/或主要职位未映射。选择红色警报图标以打开映射视图,然后使用 编辑 按钮来映射个人资料。如果个人资料映射后主要职位仍未映射,请选择 电子邮件支持 链接以请求 Toast 代表进行职位映射——只有 Toast 管理员可以映射职位。

 

也常被问及:

    • “POS 映射有一个带有 ! 的红色三角形”
    • “POS 映射选项卡上的红色三角形”
    • “POS映射警告”

 

为什么员工在Toast Web中处于活动状态,但在Toast Payroll中却不是?

员工在Toast Web中处于活动状态但在Toast Payroll中不处于活动状态的最常见原因是,员工是在Toast Web中入职的,但从未在Toast Payroll中入职。所有员工都应首先在Toast Payroll中入职——Toast Payroll随后会自动创建一个匹配的Toast Web个人资料。这包括将现有员工添加到第二个地点:该操作也必须在Toast Payroll中完成。请参阅 Toast Payroll:有关第二个地点的操作流程,请参阅“分配或更改员工职位或地点”。

 

当我的员工在POS上打卡时,为什么显示“无效密码”?

当员工在POS上看到“无效密码”错误时,这可能表明他们的Toast Web和Toast Payroll个人资料未映射——但也可能意味着POS访问代码本身不正确。请记住:员工编号和POS访问代码是两个不同的数字。员工编号用于标识Toast Payroll中的个人资料。POS访问代码仅用于打卡或登录POS,仅在Toast Web中可见,且并不总是与员工编号一致。请参阅 Toast Payroll:有关区别,请参阅“员工编号和POS访问代码常见问题解答”。

 

映射时我该如何知道选择哪个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 进行的账户级更改:

  • 重复的 Toast Payroll 资料。如果一名员工在 Toast Payroll 中有两个资料,仅靠映射无法解决此问题。客户服务必须协调这些资料以合并工时和工资数据。客户服务还可以确认是否可能适用工资修正或费用。
  • 职位映射。只有 Toast 管理员可以映射职位。在 Toast Payroll 中,从员工的POS 映射选项卡中,选择电子邮件支持链接,即可直接从映射屏幕发送职位映射请求。Toast 代表将在完成后通知您。
  • 映射工具被阻止或不可用。如果映射页面无法加载、下拉菜单中没有任何地点的档案,或者您的角色不包含 HR+ 访问权限,请联系客户服务部。

 

如果您确实需要联系客户服务部,请准备好以下信息:

  • 您的 Toast Payroll 公司代码
  • 受影响员工或档案的全名(包括任何“在线订购”、“活动选项卡”或通用档案名称)
  • 出现问题的地点
  • 小费管理或工时表中的确切错误消息文本
  • 受影响的工资发放周期或具体日期
  • 受影响的地点和/或职位
  • 简要描述您已尝试的操作——例如,“确认该档案位于未映射的 POS 员工选项卡中,并设置为工资单中忽略,但映射到 POS 员工下拉菜单为空”

 

回到顶部

 

相关文章

 

回到顶部

 

此内容仅供参考,不作为法律、税务、人力资源或其他任何专业建议。请咨询律师或其他专业人士以获取建议。