获取发货订单数据

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

配置

字段

获取发货订单数据操作包含以下字段,这些字段可用于构建查询:

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

查询字符串

下方的示例查询用于获取当前暂停的发货订单:

status:ON_HOLD

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

查询数据时,了解以下内容将有所帮助:

  • [可用发货订单筛选条件的列表- 查询必须遵循特定语法
  • 可在 QueryRoot 对象的开发人员文档中找到所有查询的查询字段名称。
  • 查询字段值并不总是有相应记录。在某些情况下,可以通过查看 API 文档来找到值。或者,在筛选时,您通常可以在后台的 URL 中找到字段值。例如,若要查找一些“订单”查询值,请筛选后台中的“订单”页面,然后检查 URL。
  • 您可以使用 Shopify GraphiQL 应用在商店中运行或测试查询。
  • 请注意查询失败时发生的情况。通常,API 将返回所有结果(而不是没有任何结果)。 ](https://shopify.dev/docs/api/admin-graphql/latest/queries/fulfillmentOrders#argument-query-filter-default)

返回的数据

所有获取数据操作都将返回包含 0 到 100 个资源的列表。根据您的用例,您可能需要以多种方式使用此数据:

  • 如果您需要单独处理每个列表项,例如为每个项目添加标签,则您可以使用针对每项操作。
  • 如果您需要聚合数据,例如计算返回的结果数,则您可以使用计数求和操作。
  • 如果您需要输出该列表,例如发送包含所有项目的电子邮件,则可以直接使用在后续操作中返回的数据。

若要访问此操作后的步骤中返回的数据,请使用名为获取发货订单数据的变量,这将获取发货订单列表。您可在条件和操作中使用此变量。例如,您可在类似下方的发送内部电子邮件操作中发送发货订单列表:

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

触发器

您可以在任何工作流中使用此操作,包括已安排时间触发器。在使用已安排时间触发器的工作流中,工作流在您指定的时间启动,而不是因事件而启动。由于您的商店或应用中没有可启动工作流的特定事件,因此不会自动包含任何数据。

示例

一天重复一次的工作流的示例,该工作流检查暂停的发货订单并发送电子邮件摘要

在此示例工作流中,工作流已被安排在每天下午 4:34 运行。获取发货订单数据操作用于收集已暂停订单的数据。系统会通过电子邮件向为您商店工作的人员发送已暂停订单的列表。

API 参考

没有找到您需要的答案?我们将为您提供帮助。