导入礼品卡

上次更新时间:2026年3月25日 13:47

如要将礼品卡导入(上传)到 Toast,您需要在操作之前准备一个包含已激活和未激活礼品卡的逗号分隔值 (.csv) 文件列表。 

本文内容:

 

礼品卡导入概述

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


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

如果您的上线工具包中包括礼品卡导入:请按照有关准备并以一定格式呈现 CSV 文件的说明操作,然后将这些文件的副本发送给您的上线顾问,他们将确保文件正确导入。如果您打算自己导入此数据,请遵循本文中的所有步骤,确保成功导入。 

注意:并非所有导入的礼品卡都可以在 Toast POS 机系统上刷卡。如果您无法刷礼品卡,您可以手动输入卡号(适用于导入的所有类型礼品卡)。 

返回顶部

以一定格式呈现礼品卡负债报告以进行导入

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

  • 已激活的礼品卡:有余额的礼品卡。
  • 未激活的礼品卡:未售出或未加载余额的礼品卡。

 

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

  • 已激活礼品卡文件必须包括:
    • 一列完整未打码的礼品卡号
    • 一列当前礼品卡余额
  • 未激活礼品卡文件必须包括:
    • 一列完整未打码的礼品卡号

注意:完整未打码表示卡号不得包含星号或字母。它必须是一个完整的数字值。

其他格式要求:

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


注意: 如果您同时拥有已激活未激活的礼品卡,您需要先以一定格式呈现并导入您的已激活礼品卡。不同的电子表格工具(例如 Excel、Google Sheets)对 CSV 文件的处理方式不同。如要了解详情,请参阅本文的“CSV 文件最佳实践”部分,确保您以正确的格式呈现文件并避免出现任何导入错误。


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




返回顶部
 

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

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

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

如果您使用 Google Sheets:

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

    Google Sheet 导入文件

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

 

导入文件后,请扫描数据,确保没有数字被截断(缩短),并且数据符合预期。如果您看到缺少零,存在缩短或四舍五入的数字,或用科学计数法表示的数字,请打开新的电子表格,并按照上述步骤再次尝试导入您的 CSV 文件。


返回顶部
 

已激活的卡片:准备并以一定格式呈现 CSV 文件

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

    注意:请勿直接用 Excel 或 Google Sheets 打开 CSV 文件,而是要遵循这些步骤。这很重要,因为这能避免出现导致文件导入失败的任何更改(例如删除前导零)。

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

    电子表格设置

  3. 完成后,选择“文件”>“下载”,以逗号分隔值 (.csv) 格式保存文件。选择“逗号分隔值”。 请注意,所有卡号和余额应在一个工作表上,并且不应有任何重复信息(或之前上传的卡号)。否则,导入将出错。 Toast 建议将您的文件命名为“[餐厅名称] 已激活礼品卡 [日期]”。例如,Blurred Limes 已激活礼品卡 2023 年 8 月 22 日。

返回顶部
 

未激活的卡片:准备并以一定格式呈现 CSV 文件

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

    注意:请勿直接用 Excel 或 Google Sheets 打开 CSV 文件,而是要遵循这些步骤。这很重要,因为这能避免出现导致文件导入失败的任何更改(例如删除前导零)。

  2. 该文件将只有一列,该列用于填充卡号(A 列)。确保您没有将未激活的数据添加到单独的工作表中,而是要创建一个单独的文件。 删除任何其他包含不必要数据的行或列。删除任何关于已激活卡片的信息。

    电子表格设置

  3. 完成后,选择“文件”>“下载”,以逗号分隔值 (.csv) 格式保存文件。选择“逗号分隔值”。 请注意,所有卡号应在一个工作表上,否则导入将出错。 Toast 建议将您的文件命名为“[餐厅名称] 未激活礼品卡 [日期]”。例如: Blurred Limes 未激活礼品卡 2023 年 8 月 22 日。

 

返回顶部
 

将礼品卡文件导入 Toast

首先,请确保在导入未激活的礼品卡之前,先将已激活的礼品卡导入 Toast。

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

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

在完成对已激活和未激活礼品卡号码的导入后,Toast 团队的一名成员需要为您的餐厅启用导入的礼品卡查找功能。客人可借助该功能,使用您的 Toast 礼品卡查找网站查找他们导入的礼品卡余额,并找到可以用于在线订单的 Toast 礼品卡号码。有关更多信息,请参阅该 Toast Central 文章: 《通过 Toast 礼品卡查找网站查找导入的礼品卡》


返回顶部
 

礼品卡导入工具的限制

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

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

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

返回顶部

 

常见问题解答

我在导入礼品卡时遇到此错误:请修改文件中以下行的问题,然后重新上传。该如何解决这个问题?

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

 

我在导入礼品卡时遇到此错误:已激活卡片没有余额。该如何解决这个问题?

“已激活卡片没有余额”错误是因为您要导入的 CSV 文件中列出的某个已激活卡片没有列出余额。请检查您要导入的 CSV,确保所有已激活卡片都有相应的余额。 

 

注意:已激活和未激活的礼品卡必须分别导入不同的文件中。 

我在导入礼品卡时遇到此错误:预期总余额最多只能有两位小数,且只能包含数值。该如何解决这个问题?

“预期总余额最多只能有两位小数,且只能包含数值”错误表示 Toast Web 中的“总预期余额”字段中的数字不正确。首先,确认数字格式正确,并且仅包含适当的货币金额。如果这些信息正确,但您仍遇到问题,请联系客户服务中心以获取帮助。

 

“Toast 无法确认导入的礼品卡号码是否不容易被猜中。Toast 不建议启用下面的设置”是什么意思?

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


返回顶部

其他资源 


返回顶部