导入礼品卡

上次更新时间:2026年5月20日 17:10

要将礼品卡导入(上传)到 Toast,您需要在采取行动之前准备一份包含活动和非活动礼品卡的逗号分隔值(.csv)文件。

在本文中:

 

礼品卡导入概述

本文中的步骤旨在将礼品卡从其他销售点(POS)平台或礼品卡提供商导入到Toast礼品卡中。如果您需要有关第三方礼品卡的指导,请参阅以下文章:


如果您有来自其他销售点(POS)或礼品卡提供商的现有礼品卡并且正在切换到Toast礼品卡,您必须导入您的礼品卡负债报告才能在我们的系统中使用它们。要获取您的礼品卡负债报告,您必须联系您之前的礼品卡提供商。 

如果您的入职包包含礼品卡导入:请按照准备和格式化 CSV 文件的说明操作,然后将这些文件的副本发送给您的入职顾问,他们将确保文件正确导入。如果您自己导入这些数据,请按照本文中的所有步骤操作,以确保成功导入。 

注意:并非所有导入的礼品卡都能在 Toast POS 上刷卡兼容。如果您无法刷卡,您可以手动输入所有导入卡类型的卡号。 

返回顶部

格式化您的礼品卡负债报告以便导入

导入时有两种不同的礼品卡状态:

  • 活跃的礼品卡:余额的礼品卡。
  • 非活跃的礼品卡:未售出或未加载价值的礼品卡。

 

活跃和非活跃的礼品卡必须分别提交在不同的文件中。这些文件的列上不应有标题(例如:礼品卡余额、卡号等)。

  • 您的活跃礼品卡文件必须包括:
    • 一列包含完全未掩码的礼品卡号
    • 一列包含当前礼品卡余额
  • 您的非活跃礼品卡文件必须包括:
    • 一列包含完全未掩码的礼品卡号

注意:完全未掩盖意味着数字中不得包含星号或字母。它必须是一个完整的数字值。

附加格式要求:

  • 余额必须以美元列出,而不是以分为单位。
  • 卡号必须完整列出,不应以科学计数法(例如,作为指数)出现。
  • 您卡片上的任何前导零应包含在文件中列出的卡号中。
  • 每个负债报告不得超过15,000行。如果您有超过15,000张未使用的礼品卡,请将数据拆分为多个文件。
  • 报告必须以Excel(.xlsx)或CSV(.csv)格式提交。不接受PDF格式。


注意:如果您同时拥有活动非活动礼品卡,您需要先格式化并导入您的活动礼品卡。不同的电子表格工具(例如Excel、Google表格)对CSV文件的处理方式不同。要了解更多信息,请参阅本文的CSV文件最佳实践部分,以确保您正确格式化文件并避免任何导入错误。


要了解如何将礼品卡导入Toast,请观看以下视频或阅读下面列出的步骤。




返回顶部
 

CSV文件的礼品卡导入最佳实践

通常,当您从之前的礼品卡提供商那里获取礼品卡负债报告时,文件将以CSV(逗号分隔值)格式提供。CSV文件可以使用电子表格工具(如Google表格或Excel)打开,但有时这可能导致错误,例如自动四舍五入数字、删除数字开头的零或缩短(截断)文件中的某些数字。

为防止这种情况,请确保您将CSV文件导入电子表格,而不是仅仅用电子表格工具打开CSV文件。 

如果您使用Google表格:

  1. 打开一个空白的Google表格,然后选择文件> 导入.
  2. 选择上传选项卡,并选择您保存在计算机上的文件。
  3. 将会出现导入文件弹出窗口。
    1. 导入位置下,选择替换当前工作表
    2. 对于分隔符类型,使用逗号
    3. 取消勾选将文本转换为数字、日期和公式
  4. 选择导入数据以继续。

    谷歌表格导入文件

如果您使用的是Excel,可以查看此帮助文档(外部链接)以获取说明。

 

导入文件后,检查您的数据以确保没有数字被截断(缩短),并且数据看起来符合预期。如果您看到缺失的零、缩短或四舍五入的数字,或科学计数法,请打开一个新的电子表格,并按照上述步骤再次尝试导入您的CSV文件。


返回顶部

活跃卡片:准备和格式化CSV文件

  1. 将礼品卡负债报告的CSV文件导入您选择的电子表格工具(例如Excel、谷歌表格)。查看CSV文件最佳实践部分,以获取如何正确执行此操作并避免文件格式错误的提示。 

    注意:遵循这些步骤很重要,而不是仅仅用Excel或谷歌表格打开CSV文件,以避免对您的文件(如去掉前导零)造成任何更改,从而导致导入失败。

  2. 确保您的活跃卡片文件恰好有两列(没有标题),列出每个卡号及其余额。 删除任何其他包含不必要数据的行或列。删除任何关于非活跃卡片的信息。

    电子表格设置

  3. 完成后,通过选择文件>下载将文件保存为逗号分隔值(.csv)格式。选择 逗号分隔值。 请注意,所有卡号和余额应在同一个标签上,并且不应有任何重复信息(或之前上传的卡号)。否则,导入将产生错误。 Toast建议将您的文件命名为"[餐厅名称] 活动礼品卡 [日期]"。例如,模糊青柠 活动礼品卡 2023年8月22日。

返回顶部

非活动卡:准备和格式化CSV文件

  1. 将非活动礼品卡的CSV文件导入您选择的电子表格工具(例如Excel,Google表格)。查看CSV文件最佳实践部分,以获取如何正确执行此操作并避免文件格式错误的提示。

    注意:遵循这些步骤很重要,而不是仅仅用Excel或谷歌表格打开CSV文件,以避免对您的文件(如去掉前导零)造成任何更改,从而导致导入失败。

  2. 此文件将仅包含一列卡号(A列)。确保您没有将非活动数据添加到单独的标签中,而是创建一个单独的文件。 删除任何其他包含不必要数据的行或列。删除有关活动卡的任何信息。

    电子表格设置

  3. 完成后,通过选择文件>下载将文件保存为逗号分隔值(.csv)格式。选择 逗号分隔值。 请注意,所有卡号应在同一个标签上,否则导入将产生错误。 Toast建议将您的文件命名为"[餐厅名称] 非活动礼品卡 [日期]"。例如: 模糊青柠 非活动礼品卡 2023年8月22日。

 

返回顶部

将礼品卡文件导入Toast

首先,请确保在导入非活动礼品卡之前导入活动礼品卡到Toast

  1. Toast Web中,导航到财务 >支付 > 礼品卡 > 导入现有礼品卡
  2. 对于卡片类型设置,请确保选择活动卡 - 包括所有卡的标识符和现金余额
  3. 选择选择文件旁边的上传CSV,并选择您创建的第一个CSV列表(活动卡列表)。
  4. 输入活动卡的总预期余额的值。

    注意:
    您可以通过打开电子表格并使用公式计算包含卡余额的列中所有值的总和来找到预期的余额。了解有关求和函数的更多信息 在这里 (外部链接)。
  5. 在页面底部选择 验证 以便系统可以对数据进行双重检查。
  6. 在收到验证成功完成的确认后,您可以选择 提交
  7. 对不活跃的礼品卡文件重复上述步骤,但请确保将 卡类型 更改为 不活跃卡 - 仅包括卡标识符。您无需输入 预期总余额 值,因为文件应仅包含一列礼品卡号码。

在完成对活跃和不活跃礼品卡号码的导入后,Toast团队的一名成员需要为您的餐厅启用导入的礼品卡查找功能。这将允许客人使用您的Toast礼品卡查找网站查找他们的导入礼品卡余额,并找到可以用于在线订单的Toast礼品卡号码。有关更多信息,请查看此支持中心文章: 通过您的Toast礼品卡查找网站查找导入的礼品卡


返回顶部

礼品卡导入工具的限制

请记住,您将 无法 执行以下操作:

  • 批量更改礼品卡值
  • 批量删除礼品卡
  • 读取任何其他不是.csv格式(逗号分隔)的导入文件


如果您在导入礼品卡时出现错误(例如,您不小心上传了所有余额为零的礼品卡),请联系客户服务以获取帮助。您无法在Toast Web中自行删除或撤销礼品卡导入。

返回顶部

 

常见问题解答

我在导入礼品卡时遇到此错误:请修复文件中的以下行,然后重新上传。我该如何修复它? 

请修复文件中的以下行,然后重新上传 错误通常是由于您的礼品卡导入文件中的信息不正确。请查看本文的概述和最佳实践部分,以确保您遵循了正确的格式指南。一旦您修正了文件,请重试导入。如果您仍然遇到问题,请联系客户服务寻求帮助。

 

我在导入礼品卡时遇到此错误:活动卡缺少余额。我该如何修复它? 

活动卡缺少余额错误发生是因为您导入的CSV文件中列出的某个活动卡没有列出余额。请检查您尝试导入的CSV文件,以确保所有活动卡都有相关的余额。

 

注意:活动卡和非活动卡必须在不同的文件中导入。 

我在导入礼品卡时遇到此错误:预期的总余额最多只能有两位小数,并且必须仅包含数字值。我该如何修复它?

预期的总余额最多只能有两位小数,并且必须仅包含数字值错误意味着Toast Web中的总预期余额字段中的数字不正确。首先,确认该数字的格式正确,并且仅包含适当的货币金额。如果这正确,但您仍然遇到问题,请联系客户服务寻求帮助。 

 

“Toast无法确认导入的礼品卡号码是不可猜测的”是什么意思?Toast不建议启用下面的设置”是什么意思?

如果您的礼品卡号码以顺序、易于猜测的格式分配给您的餐厅,您在尝试启用Toast礼品卡查找网站上的公共查找页面的按导入号码搜索卡片时将收到此错误,以防止欺诈。有关此设置的更多信息,请参见查找礼品卡余额


返回顶部

附加资源 


返回顶部