导入礼品卡
上次更新时间：2026年10月2日 15:36
礼品卡导入概述
| 本文中的步骤旨在将礼品卡从其他销售点 (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 表格：
- 打开一个空白的 Google 表格，然后选择 文件 > 导入。
- 选择 上传 选项卡，然后选择您保存在计算机上的文件。
- 将会出现一个 导入文件 弹出窗口。
- 在 导入位置 下，选择 替换当前工作表。
- 对于 分隔符类型，使用 逗号。
- 取消勾选 将文本转换为数字、日期和公式。
- 选择 导入数据 以继续。
如果您正在使用 Excel，可以查看此 帮助文档（外部链接）以获取说明。
导入文件后，扫描您的数据以确保没有数字被截断（缩短），并且数据看起来符合您的预期。如果您看到缺失的零、缩短或舍入的数字，或者科学计数法，请打开一个新的电子表格，并按照上述步骤再次尝试导入您的 CSV 文件。
有效卡片：准备和格式化 CSV 文件
- 将礼品卡负债报告的 CSV 文件导入到您选择的电子表格工具（例如 Excel、Google 表格）中。查看 CSV 文件最佳实践 部分，获取有关如何正确执行此操作并避免文件格式错误的提示。
注意：遵循这些步骤而不是直接用 Excel 或 Google 表格打开 CSV 文件非常重要，这样可以避免对文件进行任何更改（例如删除前导零），从而导致导入失败。
- 确保有效卡片的文件恰好有两列（不含标题），分别列出每张卡号及其余额。 删除任何其他包含不需要数据的行或列。删除有关无效卡片的任何信息。
- 完成后，通过选择 文件>下载，以 逗号分隔值 (.csv) 格式保存文件。选择 逗号分隔值。 请注意，所有卡号和余额都应位于单个选项卡上，并且不应有任何重复信息（或之前已上传的卡号）。否则，导入将产生错误。 Toast 建议将您的文件命名为“[餐厅名称] 已激活礼品卡 [日期]”。例如，Blurred Limes 已激活礼品卡 8/22/2023。
未激活卡片：准备和格式化 CSV 文件
- 将未激活礼品卡的 CSV 文件导入到您选择的电子表格工具（例如 Excel、Google Sheets）中。查看 CSV 文件最佳实践 部分，获取有关如何正确执行此操作并避免文件格式错误的提示。
注意：遵循这些步骤而不是直接用 Excel 或 Google 表格打开 CSV 文件非常重要，这样可以避免对文件进行任何更改（例如删除前导零），从而导致导入失败。
- 此文件仅包含一列卡号（A 列）。请确保您没有将未激活的数据添加到单独的选项卡中，而是创建一个单独的文件。 删除任何其他包含不需要数据的行或列。删除有关已激活礼品卡的任何信息。
- 完成后，通过选择 文件>下载，以 逗号分隔值 (.csv) 格式保存文件。选择 逗号分隔值。 请注意，所有卡号都应位于单个选项卡上，否则导入将产生错误。 Toast 建议将您的文件命名为“[餐厅名称] 未激活礼品卡 [日期]”。例如： Blurred Limes 未激活礼品卡 8/22/2023。
将礼品卡文件导入 Toast
首先，请务必在导入未激活礼品卡之前，先将 已激活礼品卡导入 Toast。
- 在 Toast Web 中，导航至 财务 >付款 > 礼品卡 > 导入现有礼品卡。
- 对于 卡片类型 设置，请确保选中 已激活卡片 - 包含所有卡片的标识符和现金余额。
- 选择 上传 CSV 旁边的 选择文件，然后选择您创建的第一个 CSV 列表（已激活卡片列表）。
- 输入已激活卡片的 预期总余额 值。
注意： 您可以通过打开电子表格并使用公式计算包含卡片余额的列中所有值的总和，来找到预期的余额。了解有关 sum 函数的更多信息，请 点击此处 (外部链接)。 - 选择页面底部的 验证，以便系统可以对数据进行二次检查。
- 在收到验证已成功完成的确认后，您可以选择 提交。
- 对非活动礼品卡文件重复上述步骤，但请务必将 卡片类型 更改为 非活动卡片 - 仅包含卡片标识符。您无需输入 预期余额总计 值，因为该文件应仅包含一列礼品卡号码。
导入活动和非活动礼品卡后，顾客即可在 POS 上兑换他们导入的礼品卡号码。要让顾客在 Toast 线上点餐中使用导入的礼品卡，请选择以下选项之一：
- 启用 在公共查询页面上通过导入的号码搜索卡片 设置，以便顾客可以在您的 Toast 礼品卡查询网站上找到他们的 Toast 礼品卡号码。要了解具体方法，请参阅 查看或调整礼品卡余额 中的“为导入的卡片启用查询网站”部分。
- 请求直接兑换，以便顾客可以在 Toast 线上点餐结账时输入他们导入的礼品卡号码。餐厅所有者必须先接受书面风险确认。如需请求此功能，请联系 Toast 客户服务部。有关详细信息，请参阅 为线上订单和 Toast Local 兑换 Toast 礼品卡。
礼品卡导入工具的局限性
请注意，您将 无法 执行以下操作：
- 批量更改礼品卡金额
- 批量删除礼品卡
- 读取任何其他非 .csv 格式（逗号分隔）的导入文件
如果您在导入礼品卡时出错（例如，不小心上传了所有余额为零的礼品卡），请联系客户服务部寻求帮助。您无法在 Toast Web 中自行删除或撤消礼品卡导入。
回到顶部
常见问题解答
我在导入礼品卡时收到此错误：请修复文件中的以下行，然后重新上传。我该如何修复？
请修复文件中的以下行，然后重新上传 错误通常是由于您的礼品卡导入文件中的信息不正确所致。请查看本文的“概述和最佳实践”部分，确保您已遵循正确的格式指南。更正文件后，请重试导入。如果您仍然遇到问题，请联系客户服务部寻求帮助。
我在导入礼品卡时收到此错误：有效卡缺少余额。我该如何修复？
出现 有效卡缺少余额 错误是因为您用于导入的 CSV 文件中列出的某张有效卡没有列出余额。检查您尝试导入的 CSV 文件，确保所有有效卡都有关联的余额。
注意：有效卡和无效卡必须在单独的文件中导入。
我在导入礼品卡时收到此错误：预期总余额最多只能有两位小数，且只能包含数值。我该如何修复？
预期总余额最多只能有两位小数，且只能包含数值 错误意味着 Toast Web 中“预期总余额”字段中的数字不正确。首先，确认该数字采用正确的数字格式，并且仅包含正确的金额。如果确认无误但您仍然遇到问题，请联系客户服务部寻求帮助。
“Toast 无法确认导入的礼品卡号码是否不可猜测”是什么意思？“Toast 不建议启用以下设置”是什么意思？
如果您的礼品卡号码是以连续且容易猜到的格式分配给您的餐厅的，那么当您尝试在 Toast 礼品卡查询网站上的“公共查询页面”上启用“按导入的号码搜索卡片”功能时，您将收到此错误，以防止欺诈。有关此设置的更多信息，请参阅 检查或调整礼品卡余额。
顾客可以使用导入的礼品卡号码进行在线点餐吗？
当您的门店启用了导入礼品卡的直接兑换功能时，顾客可以将导入的礼品卡号码用于 Toast 线上点餐。直接兑换是可选功能，默认处于禁用状态。餐厅所有者必须在启用该功能前接受书面风险确认，因为导入的号码存在较高的欺诈风险。如需请求此功能，请联系 Toast 客户服务部。
如果未启用直接兑换，顾客可以在您的 Toast 礼品卡查询网站上找到他们的 Toast 礼品卡号码，并在结账时输入该号码。