帮助
登录

获取订单数据

在需要订单数据的工作流中，您可以使用 获取订单数据 操作从您的商店中检索订单信息。

在此页面上

配置

字段

获取订单数据操作包含以下用于构建查询的字段：

在“获取数据”操作中使用的字段。
字段描述
数据排序依据必需。搜索查询返回的数据的排序所依据的参数。
最大结果数必需。您选择的搜索查询可返回的最大结果数。一次最多可返回 100 个结果。
查询必需。从常见查询中进行选择或选择高级以创建您自己的查询。

查询字符串

以下是用于获取在过去一天内更新的订单的查询示例：

updated_at:<='{{ scheduledAt }}' AND updated_at:>'{{ scheduledAt | date_minus: "1 day" }}'

updated_at 变量是订单查询上可用的筛选条件，可以多次使用或与其他变量组合使用。scheduledAt Liquid 变量适用于使用预定时间触发器的工作流。date_minus Liquid 标记是一种特殊的 Flow 标记，可用于从日期中减去时间。

在查询数据时，了解以下信息会很有帮助：

  • 可用订单筛选条件列表
  • 查询必须遵循特定的语法
  • 查询字段值并非始终都有记录。在某些情况下，可通过查看 API 文档来找到这些值。或者，您通常可以在后台中进行筛选时在 URL 中找到字段值。例如，若要查找某些订单查询值，请在后台中筛选“订单”页面，然后检查 URL。
  • 您可以使用 Shopify GraphiQL 应用在您的商店中运行或测试查询。
  • 请注意，如果查询失败会发生什么情况。API 通常会返回所有结果（而不是不返回任何结果）。

返回的数据

所有获取数据操作都会返回一个包含 0 到 100 个资源的列表。根据您的用例，您可能希望以各种方式使用这些数据：

  • 如果您需要单独处理每个列表项（例如为每个列表项添加标记），则可以使用 For each 操作。
  • 如果您需要聚合数据（例如对返回了多少结果进行计数），则可以使用计数或求和操作。
  • 如果您需要输出列表（例如发送一封包含所有商品的电子邮件），则可以直接在后续操作中使用返回的数据。

若要在该操作之后的步骤中访问返回的数据，请使用名为获取订单数据的变量，该变量是一个订单列表。您可以在条件和操作中使用此变量。例如，您可以像这样在发送内部电子邮件操作中发送订单列表：

{% for single_order in GetOrderData %}
* {{ single_order.name }}
{% endfor %}

触发器

您可以在任何工作流中使用此操作，包括 预定时间 触发器。在使用 预定时间 触发器的工作流中，工作流在您指定的时间开始，而不是由某个事件导致。由于您的商店中或来自应用的任何特定事件都不会启动工作流，因此不会自动包含任何数据。

API 详细信息

模板

取消频繁退货者的订单

取消在过去六个月内退货五次或更多次的客户的订单。此模板会获取订单数据，统计退货次数，并取消当前订单，同时发放退款和重新入库商品。此模板可用于：减少因习惯性退货者造成的损失，通过预先处理潜在退货来简化订单管理，以及通过阻止过度退货来保持盈利能力。查看模板

如果客户今天下单超过 5 次，则取消订单

如果客户在一天内下单超过五次，则取消订单。此模板会检查客户在过去 24 小时内的下单数量，取消超出此限制的任何订单，并为客户添加潜在欺诈标记。查看模板

为有拒付记录的客户暂停发货订单

当订单准备好发货时，工作流会检索同一客户在过去 60 天内发起的任何有拒付的订单。如果存在任何此类订单，工作流会暂停每个货件的发货，并发送一封内部电子邮件来通知您的运营团队。查看模板

如果客户在 24 小时内下了多个订单，则暂停发货

检查客户是否在 24 小时内下了多个订单。如果为是，则暂停发货并合并货件。查看模板

如果客户在过去 24 小时内下单超过 1 次，则暂停订单

创建订单后，检查客户在过去 24 小时内是否下过任何其他订单。如果是，则将所有订单都置于暂停状态。查看模板

当过去一小时的订单量少于 10 个时发送通知

发送订单心跳通知。每小时获取最多 10 个已创建的订单并对其进行计数。如果少于 10 个，则通过电子邮件发送通知。使用“计划时间”、“获取订单数据”和“计数”步骤。查看模板

发送过去一天在线商店所有订单的电子邮件摘要

每天获取过去一天的订单，并发送一封电子邮件摘要，其中包含在线商店中的订单。查看模板

发送超过 2 天的所有未发货订单的电子邮件摘要

获取所有超过 2 天的未发货订单的每日摘要，此模板利用了计划、获取订单数据、计数和求和步骤。查看模板

标记并发送延迟发货的每日摘要

每天对所有未满足 2 天发货保证的订单进行标记，并发送一封每日电子邮件摘要，其中统计了这些订单的总数和总金额。查看模板

标记有拒付的客户

此工作流每小时获取一次有拒付的订单，并为相应订单的客户添加标记。此模板使用“计划时间”触发器、“获取订单数据”和 for each 循环。查看模板

标记超过 2 天的未发货订单

每天，该工作流都会获取所有超过 2 天的未发货订单，并为这些订单添加标记。查看模板

使用标记根据客户过去 6 个月的订单对其进行细分

创建新订单时，获取客户在过去 6 个月内的订单总额和订单总数，然后为该客户添加标记。此模板使用了“获取订单数据”、“计数”和“求和”功能。查看模板