Shopify Flow 的“订单更新”触发器以及此应用的订单触发器

Shopify Flow 的“订单更新”触发器以及此应用的订单触发器

复制页面

Shopify Flow 的“订单更新”触发器可以监听哪些内容以及会发送什么信息,此外还有十个订单触发器,它们会记录每次变更前后的值。

Flow 的“订单更新”触发器会在最多五个订单字段中的任意一个发生变化时启动一个工作流程。Shopify 的帮助页面用两句话描述了工作流程能获取哪些数据:“‘订单更新’触发器仅提供订单及其订单项的当前值。”以及“工作流程中无法获取已发生变化的字段的先前值。”

该应用针对现有订单的变更设有十个触发器。每个触发器对应一种变更类型,并记录变更前后的值。本页面将变更前后的值按字段逐一并列显示,以便您根据工作流程进行选择。

《霹雳游侠》更新后可以观看

截至 2026 年 11 月 20 日,Shopify 帮助页面的字段如下:

组 字段
订单 cancellation, customAttributes, displayFinancialStatus, displayFulfillmentStatus, email, metafield.value, note, phone, tags
合计 subtotalPriceSet, totalCapturableSet, totalDiscountsSet, totalPriceSet, totalReceivedSet, totalRefundedSet, totalRefundedShippingSet, totalShippingPriceSet, totalTaxSet, totalTipReceivedSet
订单项 lineItems.currentQuantity, lineItems.customAttributes, lineItems.discountedTotalSet, lineItems.discountedUnitPriceAfterAllDiscountsSet, lineItems.discountedUnitPriceSet, lineItems.duties, lineItems.merchantEditable, lineItems.originalTotalSet, lineItems.priceAfterAllDiscountsBeforeTaxesSet, lineItems.quantity, lineItems.taxLines
航运公司 shippingLines

Shopify 该页面补充了以下内容:

  • 您至少需选择一个字段,最多可选择五个。一个元字段定义或整个命名空间均计入这五个字段之中。
  • 以Set结尾的字段包含两种货币的金额。任一金额发生变化都会触发工作流程。若要监控其中一种货币,请选择其shopMoney或presentmentMoney字段。
  • 添加一个订单项即视为对该订单项的修改,而添加或删除一条发货行会触发一个监听 shippingLines 的工作流程。
  • 当同时监视订单字段和订单项字段时,在工作流程运行时,“订单项”变量可能会为空。
  • 对于新订单,Shopify 会触发“订单创建”触发器。

未列入清单的内容包括:发货地址和账单地址、客户信息、订单发货信息和物流单号,以及交易记录。

逐字段

发生了什么变化 Shopify Flow 的订单已更新 此应用的触发器 工作流程还能带来什么
标签 tags:更改后的标签列表 已添加订单标签,已移除订单标签 addedTags, removedTags, previousTags, currentTags
注 note:新笔记 订单备注已更改 oldNote, newNote
付款状态 displayFinancialStatus:新状态 订单财务状态已变更 oldFinancialStatus, newFinancialStatus
发货状态 displayFulfillmentStatus:新状态 订单发货状态已变更,订单显示状态已变更 状态的变化(前后对比)、每笔已完成或未完成的订单项明细、每条包含编号、URL 和承运商的物流更新,以及每笔货物的配送状态(前后对比)
自定义属性 customAttributes:更改后的属性 订单属性已更改 changes.items 中的每个属性:changeType(添加、删除、修改)、key、oldValue、newValue
订单项 lineItems.quantity、lineItems.currentQuantity 以及另外九个字段的当前值 订单项已更改 changes.items 中每行包含:changeType(添加、移除、数量变更、价格变更、变体变更),并附有旧值和新值的数量、价格及变体
收货地址 不在列表中 订单收货地址已更改 shippingAddress 和 oldShippingAddress,以及这两个字段的每个部分,均作为独立的字段
元字段排序 metafield.value:新值 元字段更新顺序 metafield.value, metafield.previousValue
合计 总共10个字段,每个字段包含两种货币 订单更新,或自定义触发器模板订单总额发生变化(变化前与变化后) 前后总计
电子邮件、电话、取消、航运公司 email, phone, cancellation, shippingLines “订单更新”会在以下更新时触发。该应用的任何触发器均不保留其旧值。
在一个工作流程中可以包含任意数量的此类操作 至多五个 订单更新,仅显示您勾选的字段 changes.fields 和 changes.items 包含 field、oldValue、newValue

订单触发器,分步指南 中为这十个订单触发器分别提供了一个示例。

当两者按相同顺序运行时,我们看到的情况是

2026年11月20日,我们在一个开发商店中创建了一笔订单,并在已知时间点对其进行了修改,同时启用了“订单更新”工作流程,并让该应用的触发器并行运行。完整的表格见Shopify Flow 的更新版触发器和 Workflow Trigger Extensions。对于订单工作流程而言,有三个结果值得关注:

  • 创建操作被视为一次变更。该订单是从订单草稿创建而来的。在任何人对其进行编辑之前,“订单已更新”触发器已触发两次,一次是针对财务状态,一次是针对发货状态。该应用的触发器会记录新订单,并从其首次实际变更开始触发。
  • 每次写入都算作一次运行。一秒钟内添加的三个标签触发了三次运行。其中两次已经显示了全部三个标签,因此同一状态被处理了多次。该应用发送了一个事件,其中列出了这三个标签。
  • 运行显示的是实际运行时的音符顺序。一秒钟内发生的两次音符变化分别触发了两次运行,且两次运行均显示了最终的音符。“音符顺序变化”事件发送了一个事件,其中包含首次变化前的音符和最后一次变化后的音符。
订单页面上的“Flow”触发器:财务状态从“待处理”变为“已支付”,以及添加了一条备注
Shopify 管理后台中的订单页面,显示了本应用的“事件”模块:状态的变更情况(变更前和变更后),以及添加的备注。

需要提前获取该值的工作流程

当收到待处理付款时,释放订单。当oldFinancialStatus等于pending且newFinancialStatus等于paid时,订单财务状态发生变更。仅显示“已支付”的工作流程无法区分该订单与在结账时已支付的订单。可直接使用:在收到待处理付款时标记订单。

结账后地址发生变更时,请告知仓库。订单发货地址变更通知中会包含变更前后的地址,因此消息中可以说明包裹原先的寄送地址和现在的寄送地址。可直接使用:当结账后收货地址发生变更时,对订单进行标记。

查看已编辑的订单。 “订单项变更”列表会列出所有被添加、删除或修改的订单项,并显示其修改前后的数量。通过changeType条件可区分被删除的项目与数量发生变更的项目。 即可使用:在编辑订单项时标记订单。

针对一个标签进行操作。Order Tags Added 和 Order Tags Removed 分别指出了发生变化的标签名称。参见 在添加或移除某个特定标签时触发工作流程。

对礼品留言或配送日期发生变更作出响应。“订单属性变更”事件包含每个发生变更的属性的键值,以及该属性的旧值和新值,因此工作流程可以针对某个属性采取行动,同时忽略其他属性。

Shopify Flow 中的工作流程:在收到待处理付款时为订单添加标签
待处理付款到达时的模板:触发器、针对旧状态和新状态的条件,以及一项操作。

何时选择“更新订单”才是正确之选

  • 当几个字段中的某个发生变化时,您希望收到快速提醒,且当前值即可满足需求。
  • 您可以查看以某种货币计价的总金额、小费、关税、税费或运费。
  • 请留意订单的电子邮件、电话或取消详情。
  • 工作流程必须在发生变更后一两秒内启动。

两者都可以在同一个商店中运行。当其中一个进行更改时,两个工作流程都会被触发,因此请将每个任务分配给其中一个。

“订单更新”会返回之前的值吗?

不,Shopify 的帮助页面指出,该触发器仅提供订单及其订单项的当前值。而该应用的订单触发器则包含触发前和触发后的值。

创建订单时,“订单已更新”是否会触发?

Shopify 将新订单的触发器设为“订单创建”。在我们的测试中,从订单草稿创建的订单仍会触发两次“订单更新”事件,分别对应财务状态和发货状态。如果工作流程基于状态字段,请添加条件,以避免对新订单执行操作。

在 Shopify Flow 中,我能查询到某笔订单的旧收货地址吗?

是的,通过“订单收货地址已更改”功能可以实现。该功能会以格式化文本的形式分段显示更改前后的地址。收货地址并不在“订单更新”可监控的字段范围内。

“订单更新”能告诉我添加了哪个标签吗?

不。它显示的是更改后的标签列表。“已添加的标签”列出了新增的标签,“已移除的标签”列出了被移除的标签。

这款应用会监控哪些订单?

默认显示最近60天的订单。您可以在应用中将时间范围扩展至180天、12个月、24个月或您指定的日期。

我可以在同一家商店里同时使用这两个功能吗?

是的。它们不会相互干扰。请根据工作流程决定由哪个触发器启动它。

下一步