Flow 自动化：通过执行器批量查询礼品卡 – SHOPLINE 常见问题

您可以在【Flow 自动化】中使用【批量查询礼品卡】执行器，按礼品卡状态、创建时间、到期时间等条件，一次性找出店铺内所有符合要求的礼品卡，并交由工作流的后续步骤处理。例如，您可以找出即将到期的礼品卡，提醒客服团队跟进顾客。

本文将说明该执行器的适用情况、字段定义、适用工作流、如何进行测试，并提供一个实用示例及使用限制。

注意：该执行器仅用于查询礼品卡信息，不会修改礼品卡的余额、状态或到期时间。有关礼品卡管理的详细信息，请参阅《礼品卡管理》。

何时使用批量查询礼品卡执行器

适用于以下情况：

【批量查询礼品卡】执行器允许您通过添加查询条件，设置需要查询的礼品卡。

字段

说明

【查询条件】

用于筛选需要查询的礼品卡。点击【+ 添加条件】，勾选所需条件并点击【确定】，然后填写对应的值，或点击【+ 添加变量】引用前序步骤中的参数。如未添加任何条件，执行器将查询店铺内的全部礼品卡，默认最多返回 50 张。

支持以下条件：

【code】： 礼品卡编码，用于查询指定编码的礼品卡。
【created_at_min】：指定要查询礼品卡的最早创建时间。返回在指定时间及之后创建的礼品卡。格式：ISO 8601（例如 2026-12-01T00:00:00+08:00）。
【created_at_max】：指定要查询礼品卡的最晚创建时间。返回在指定时间及之前创建的礼品卡。格式：ISO 8601。
【expires_on_min】：指定要查询礼品卡的最早到期时间。返回在指定时间及之后到期的礼品卡。格式：ISO 8601。
【expires_on_max】：指定要查询礼品卡的最晚到期时间。返回在指定时间及之前到期的礼品卡。格式：ISO 8601。
【fields】：指定需要返回的礼品卡信息字段，多个字段之间用英文逗号分隔。可指定的字段请参考响应数据结构。
【limit】：单次查询返回的礼品卡数量上限。取值范围：1–250，默认值为 50。
【page_info】：分页查询标识，用于定位指定页面。当查询结果需要分页时，可使用该参数获取对应页面的数据。
【since_id】：礼品卡 ID。填写后，将从指定的礼品卡 ID（包含该 ID）开始查询。
【status】：礼品卡的状态。支持 enabled（已启用，可用于结账）和 disabled（已禁用，无法用于结账））。

注意：对于查询到的每张礼品卡，您可以在后续步骤中点击【+ 添加变量】 使用以下信息：[卡号后四位]、[初始金额]、[当前余额]、[币种]、[到期时间]、[创建时间]、[备注]、[关联订单 ID]、[客户 ID]、[接收人昵称]、[接收人邮箱]、[赠送留言]。

【批量查询礼品卡】执行器主要用于由以下触发器启动的工作流：

若要测试工作流是否成功查询礼品卡，请按照以下步骤操作：

在 SHOPLINE 后台，前往【商品】>【礼品卡】，确认店铺内至少有一张已启用的礼品卡。如没有，请先创建一张。

注意： 有关创建礼品卡的详细信息，请参阅《礼品卡管理》。
在 【Flow 自动化】 中，使用【达到指定时间】触发器和【批量查询礼品卡】执行器设置一个工作流。将触发器的【首次触发时间】设为几分钟后，【重复触发】设为【不重复】。
在 【批量查询礼品卡】 执行器中添加【status】条件并填写 enabled，然后点击【发布】。
到达首次触发时间后，前往【Flow 自动化】查看执行结果。

注意： 有关如何监控工作流执行情况的更多信息，请参阅《Flow 自动化应用介绍》中的《如何查看 Flow 运行结果》章节。
打开该工作流的运行详情，确认【批量查询礼品卡】执行器已返回店铺内已启用的礼品卡。

以下是使用【批量查询礼品卡】执行器提醒客服团队跟进即将到期礼品卡的实用示例。

场景：在 12 月 1 日找出所有将于 12 月内到期且处于启用状态的礼品卡。对仍有余额的礼品卡，发送邮件给客服团队，由客服联系顾客提醒使用。

触发器：达到指定时间
- 首次触发时间：2026-12-01 09:00:00
- 重复触发：不重复
执行器：批量查询礼品卡
- status：enabled
- expires_on_min：2026-12-01T00:00:00+08:00
- expires_on_max：2026-12-31T23:59:59+08:00
执行器：【循环操作】（对查询到的每张礼品卡执行以下步骤）
条件：[当前余额] 不等于 0
执行器：发送邮件
- 邮件主题：礼品卡即将到期：尾号 [卡号后四位]
- 邮件内容：尾号为 [卡号后四位] 的礼品卡还有 [当前余额] [币种] 未使用，将于 [到期时间] 到期。接收人：[接收人昵称]（[接收人邮箱]）。请联系顾客提醒尽快使用。
- 收件邮箱：客服团队的邮箱地址
结果：客服团队会收到本月即将到期且仍有余额的每张礼品卡的提醒，可及时联系顾客使用，减少因礼品卡过期引起的售后问题。

注意：

单次查询数量：每次查询返回的礼品卡数量不会超过【limit】条件设置的上限（1–250 张。若无设定，默认返回 50 张）。如符合条件的礼品卡较多，建议缩小时间范围分多次处理，或使用【page_info】条件获取下一页结果。
仅查询不修改：该执行器不会修改任何礼品卡。如需对查询结果进行处理，请接续其他执行器。
卡号安全：查询结果仅提供礼品卡卡号的后四位。在邮件中，请使用 [卡号后四位] 识别礼品卡。
无查询结果：如没有符合条件的礼品卡，查询结果将为空。