帮助
登录

获取发货订单数据

您可以使用获取发货订单数据操作从商店中检索 发货订单信息。

在此页面上

配置

字段

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

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

查询字符串

以下是获取当前处于暂停状态的发货订单的查询示例：

status:ON_HOLD

status 变量是发货订单查询中可用的筛选条件，可以多次使用或与其他变量结合使用。

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

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

返回的数据

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

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

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

{% for fulfillment_order in GetFulfillmentOrderData %}
* Order: {{ fulfillment_order.order.name }} Location: {{ fulfillment_order.assignedLocation.name }}
{% endfor %}

触发器

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

API 详细信息

模板

发送每日电子邮件摘要以及处于暂停状态的发货订单列表

此工作流将每天查询所有处于暂停状态的发货订单（一次最多 100 个）。它将发送一封电子邮件摘要，其中包含订单名称和分配的发货地点。查看模板