上次更新时间:2026年10月8日 15:03
如果小费无法发送至薪资系统、工时未同步,或者您在 POS 映射选项卡上看到红色警报图标,则说明员工的 Toast Payroll 个人资料可能未链接到正确的 Toast Web 个人资料。请使用本文进行修复。
适用于:Toast Payroll, Toast Web, Toast POS
所需权限:
您将完成以下操作:将员工的 Toast Payroll 个人资料与正确的 Toast Web 个人资料相关联,以便工时记录、小费、职位、工资率和员工状态在 Toast Payroll 和 Toast Web 之间自动同步。
下表列出了最常见的映射症状及其原因和最快的修复方法。每一行都链接到下方相应的分支。
| 症状 | 最常见原因 | 快速修复 | 自助服务? |
|---|---|---|---|
| “1名员工未映射。映射此员工。”向薪资系统发送小费时 | 小费池中的一名员工未在Toast薪资系统和Toast Web之间建立关联 | 若要解决“1名员工未映射”导致无法向薪资系统发送小费的问题:请登录 payroll.toasttab.com 并导航至 设置 > Toast > 员工,在Toast薪资系统和Toast Web之间映射该未关联的员工。完整步骤:请参阅 小费无法发送至薪资系统:“1名员工未映射”下方。 | 是 |
| 由于存在未映射的员工导致小费无法发送,但映射页面显示所有人都已映射 | 一名收款员工在“未映射的POS员工”选项卡底部的薪资系统中被标记为“忽略” | 若要解决映射页面显示正常但提示仍显示未映射的问题,请检查“未映射的POS员工”选项卡底部是否有被标记为“在薪资系统中忽略”的收款员工,并映射该档案。完整步骤:请参阅下方的 小费池显示“未映射”但映射页面显示正常。 | 是 |
| 员工打卡后,工时或时间条目未同步至Toast薪资系统 | Toast薪资系统档案映射到了错误的Toast Web档案(或未映射) | 若要解决工时或时间条目未同步至Toast薪资系统的问题,请更正员工的映射——将Toast薪资系统档案重新映射到正确的Toast Web档案,如果未映射,请进行映射。完整步骤:请参阅下方的 时间条目或工时未同步至薪资系统。 | 是 |
| POS映射选项卡上出现红色警报图标,并显示消息“作业同步挂起。下次同步后,该员工在薪资系统中的作业将添加到其Toast POS档案中。” | 在Toast薪资系统中添加了新作业,但尚未同步到Toast POS | 若要解决POS映射选项卡上的红色警报图标和“作业同步挂起”消息:这是在Toast薪资系统中添加新作业后出现的,作业同步到Toast POS后会自动清除。完整步骤:请参阅下方的 添加新作业后POS映射出现红色警报图标。 | 是 — 用于重新同步;如果缺少“电子邮件支持”链接,则仅限代理。 |
| 映射列表中的 Toast Web 配置文件在员工姓名旁边显示(已归档) | 活动的 Toast Web 配置文件已被归档,或者员工先在 Toast Web 中入职,导致创建了重复项。 | 要修复映射列表中显示为“(已归档)”的 Toast Web 配置文件:当活动配置文件被归档,或员工 先在 Toast Web 中入职 并创建了重复配置文件时,会出现此情况。 | 是 |
| 团队页面上的横幅:“一名或多名员工未映射。您必须在继续之前映射他们。” | Toast Web 配置文件没有匹配的 Toast Payroll 配置文件,反之亦然 | 要修复团队页面上的“一名或多名员工未映射”横幅:这意味着 Toast Web 配置文件没有匹配的 Toast Payroll 配置文件(反之亦然)— 请将它们相互映射。完整步骤:请参阅下方的 解决团队页面上的未付员工问题。 | 是 |
| “抱歉!我们无法批准 2 天。” / “以下日期发送失败:” | 由于一名或多名员工未映射,小费管理器无法发送。 | 要修复“抱歉!我们无法批准 [X] 天”或小费管理器中的“以下日期发送失败”:这意味着一名或多名员工未映射 — 请在重新发送前将他们映射。完整步骤:请参阅下方的 小费无法发送至薪资系统:“1 名员工未映射”。 | 是 |
| 薪资系统上的“员工未映射”错误 | 一个或多个配置文件未在 Toast Payroll 和 Toast Web 之间关联 | 要修复薪资系统上的“员工未映射”错误:请在 Toast Payroll 和 Toast Web 之间关联受影响的配置文件。完整步骤:请参阅下方的 Map Employees in Toast Payroll。 | 是 |
| 同一员工拥有两个 Toast Payroll 个人资料 — 劳动力和提示信息数据在两者之间拆分 | 入职期间创建了重复的 Toast Payroll 个人资料 | 如果员工拥有两个 Toast Payroll 个人资料,且劳动力和提示信息数据在两者之间拆分:这是入职期间创建的重复个人资料,必须由客户服务部门进行核对 — 此操作无法自助完成。完整步骤:请参阅下方的 Duplicate Toast Payroll Profiles。 | 否 — 需要客户服务部门进行核对 |
| 重新聘用的员工未显示或未映射 | 未使用重新聘用流程;旧的 Toast Web 个人资料仍处于归档状态 | 要修复重新聘用的员工未显示或未映射的问题:请使用正确的重新聘用流程,而不是创建新个人资料 — 只需取消归档并重新映射旧的 Toast Web 个人资料即可。完整步骤:请参阅下方的 Rehiring an Employee。 | 是 |
本文重点介绍如何将 Toast Payroll 个人资料关联至 Toast Web 个人资料。关于相关主题:
映射是将员工的 Toast Payroll 档案与其 Toast Web 档案相关联的过程。当员工被正确映射后,他们的数据会自动同步 — 包括小费、工作、职位、薪资费率、员工状态,以及从 Toast POS 设备显示在 Toast Payroll 考勤表上的工时记录。
为避免大多数手动映射的情况,请在 Toast Payroll 中雇用员工,而不是在 Toast Web 中。当员工在 Toast Payroll 中被雇用时,系统会立即创建 Toast Web 档案并自动进行映射。
预期结果:员工“薪资员工”选项卡旁不再显示红色警报图标,且时间条目会显示在他们的 Toast Payroll 工时表中。
Toast Payroll 让您可以直接从员工个人资料中查看并修复其映射。
职位映射只能由 Toast 管理员完成。在许多情况下,映射员工个人资料也会映射其职位。次要职位在此页面上不可见 — 一旦职位映射完成,Toast 将通知您。
预期结果:POS 映射选项卡上的红色警报图标在个人资料映射后(如果创建了职位映射案例,则在 Toast Payroll 客户服务解决职位映射案例后)会被清除。
以下分支涵盖了 Toast Payroll 用户最常报告的症状。每个分支都会告诉您原因和解决方法。
将小费发送至工资单时,您可能会看到以下一个或多个错误:
如果因为员工未映射而导致小费无法发送:
预期结果:小费发送成功,错误消息消失。
如果小费管理器显示某位员工未映射,但映射页面显示所有员工当前均已映射,则该未映射的员工通常是在 Payroll 中被标记为“已忽略”的接收小费的个人资料。这些条目仍然会阻止小费。
预期结果:小费管理工具不再报告未映射的员工,当天的各项小费已成功发送。
如果员工在 Toast POS 设备上打卡,但其工时未出现在 Toast 薪资管理工时表中,则很可能是 Toast 薪资管理档案映射到了错误的 Toast Web 档案(或完全未映射)。
预期结果:在 Toast Web 中重新提交工时条目后的几分钟内,它们会出现在 Toast Payroll 工时表上。
在员工的 Toast Payroll 个人资料中添加新工作或职位后,您可能会在“POS 映射”选项卡上看到一个红色警报图标,并显示消息“职位同步待处理”。下次同步后,该员工在薪资系统中的作业将添加到其Toast POS档案中。”
预期结果:一旦新职位同步到 Toast POS 且所需的 Toast 管理员职位映射完成,红色警报图标就会消失。
原因:该员工先在 Toast Web 中入职,后在 Toast Payroll 中入职。员工用于打卡的 Toast Web 个人资料未映射,而自动生成的 Toast Web 个人资料(在 Toast Payroll 入职期间创建)已映射。工时条目不会同步到 Toast Payroll。
修复:
预期结果:原始 Toast Web 档案中的工时记录和小费数据会流入 Toast Payroll 工时表。
原因:当员工拥有多个 Toast Web 档案时,通常只有一个档案包含工时记录。拥有多个 Toast Web 档案的员工通常需要重新映射,且必须归档未使用的档案以防止反复出现问题。
注意:在 Toast Web 中,档案是归档而非永久删除。客户有时会将归档操作描述为“删除”。
修复(概览):
有关分步归档和识别说明,请参阅 Duplicate Employee Profiles in Toast Web。
预期结果:员工只有一个处于活动状态的 Toast Web 个人资料,且 Toast Payroll 个人资料已映射到该资料。
原因:当员工拥有多个 Toast Payroll 个人资料时,他们的工时表和小费可能会在这些个人资料之间被拆分。他们也可能拥有重复的 Toast Web 个人资料。
修复:仅靠映射无法解决此问题——必须由 Toast Payroll 客户服务专家团队协调重复的 Toast Payroll 个人资料,以将工资和劳动力数据保留在单个个人资料中,并避免重复的税务文件。在开立工单之前,请参阅 联系客户服务之前。
预期结果:工资单客户服务专家会协调重复的个人资料。他们会告知您是否适用工资修正或费用。
当您通过 Toast Payroll 重新聘用流程重新聘用员工时,Toast 会自动取消旧 Toast Web 个人资料的归档并重新映射这两个个人资料。无需手动映射。
如果重新聘用的员工未被映射,请按照 Toast Payroll: 中的重新聘用流程操作:重新聘用指南,而不是手动映射——重新聘用流程会同时处理取消归档和重新映射。
预期结果:重新聘用员工的旧 Toast Web 个人资料会自动取消归档并映射到其 Toast Payroll 个人资料。
在 Toast Payroll 中,当员工的 Toast Web 个人资料没有匹配的 Toast Payroll 个人资料(反之亦然)时,团队页面会显示带有“未付款员工”标签的员工。您可能还会看到“一名或多名员工未映射”的横幅。您必须在继续之前映射他们。”
解决方法取决于员工的情况:
有关三点菜单的完整演练,包括筛选器行为和安全角色可见性,请参阅 Toast Payroll:Team Page。
本节仅适用于需要 Toast Payroll 客户服务解决的两种情况——它们无法自助完成:
对于所有其他映射场景,上述分支无需客服人员即可解决问题。
在提交工单之前,请收集:
若要开立工单,请通过 Toast Payroll 内的在线聊天支持渠道联系 Toast Payroll 客户服务部。
“薪资员工”选项卡列出了所有 Toast Payroll 个人资料以及每个资料所映射到的 Toast Web 个人资料。“未映射的 POS 员工” 选项卡列出了 Toast Web 个人资料以及每个资料所映射到的 Toast Payroll 个人资料。按产品拆分视图可以让您查看员工是否存在于两个系统中的仅其中一个系统内。
最常见的原因是该员工在 Toast Web 中被归档,而其 Toast Payroll 个人资料仍处于活动状态。若要取消归档 Toast Web 个人资料,请按照 在 Toast Web 中添加和管理员工 中的 取消归档员工 说明进行操作。
这通常是因为员工是直接在 Toast Web 中添加的,而从未在 Toast Payroll 中进行新员工入职流程。请务必在 Toast Payroll 中进行新员工入职流程——该步骤会自动创建匹配的 Toast Web 个人资料并将其映射。将员工添加到第二个地点时也适用同样的操作:请在 Toast Payroll 中进行。请参阅 Toast Payroll:分配或更改员工职位或地点。
该员工仍会在映射页面上显示为未映射。无需将其映射到 Toast Web 个人资料,只需在映射工具步骤中选择 忽略此员工 即可。
其他提问方式:
POS 映射选项卡上的红色警报图标表示员工的个人资料或职位未映射。打开员工的 Toast Payroll 个人资料,选择 红色警报图标,然后按照 从个人资料映射单个员工 中的步骤操作。如果该图标是由于添加新职位后职位同步待处理,请参阅 添加新职位后 POS 映射上的红色警报图标。
个人资料按地点划分范围,一次只能查看一个地点。使用映射页面上的 地点 下拉菜单在不同地点之间切换。
自动映射建议是系统根据名字、姓氏、电子邮件地址、昵称或员工编号的部分匹配所识别出的配对。如果建议正确,请选择 接受建议。
这意味着 Toast Web 个人资料已被归档。要取消归档,请按照 在 Toast Web 中添加和管理员工 中的 取消归档员工 说明进行操作。
不会。要将现有的工时条目从 Toast Web 推送到 Toast Payroll,请在 Toast Web 中导航至 报告 > 劳工 > 工时条目管理,并通过打开 班次详情 侧边栏并选择 保存更改 来重新提交每个工时条目。
可能是。“密码无效”错误可能在员工的 Toast Web 和 Toast Payroll 个人资料未映射时发生,此外还有其他原因。请注意,员工编号和 POS 访问代码是两个不同的数字——POS 访问代码仅在 Toast Web 中可见,用于登录 POS 系统。请参阅 Toast Payroll:员工编号和 POS 访问代码常见问题解答,了解两者区别。
本内容仅供参考,不作为法律、税务、人力资源或其他专业建议。请咨询律师或其他专业人士以获取建议。