Shopify Flow

Shopify Flow

複製頁面

Shopify Flow 的「訂單更新」觸發器能監控哪些內容,以及會傳送哪些資料,此外還有十種訂單觸發器,會記錄每次變更前後的數值。

當 Shopify Flow 的「訂單更新」觸發器偵測到多達五個訂單欄位中的任一欄位發生變更時,便會啟動工作流程。Shopify 的說明頁面以兩句話說明了工作流程能取得哪些資料:「『訂單更新』觸發器僅提供訂單及其明細項的當前值。」以及「工作流程中無法取得已變更欄位的先前值。」

此應用程式針對現有訂單的變更設有十種觸發器。每種觸發器會針對某種變更觸發,並包含變更前與變更後的數值。本頁面將這兩組數值逐欄並列顯示,以便您根據工作流程進行選擇。

《What Order》更新後可以觀看

截至 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:新的狀態 訂單處理狀態變更,訂單顯示狀態變更 前後的狀態、每個已完成或未完成的訂單明細、每筆包含編號、網址及承運商的追蹤更新,以及每筆貨件在前後的配送狀態
自訂屬性 customAttributes:變更後的屬性 訂單屬性已變更 changes.items 中的每個屬性:changeType(新增、移除、變更)、key、oldValue、newValue
明細項目 lineItems.quantity、lineItems.currentQuantity 以及另外九項的當前值 訂單明細項目已變更 在 changes.items 中,每行包含:changeType(新增、移除、數量變更、價格變更、變體變更),並附有舊值與新值的數量、價格及變體
收貨地址 不在清單上 訂單寄送地址已變更 shippingAddress 和 oldShippingAddress,以及這兩者的每個部分,均作為獨立的欄位
metafield 順序 metafield.value:新值 「元字段更新」指令 metafield.value, metafield.previousValue
總計 總共十個欄位,每個欄位皆包含兩種貨幣 訂單更新,或自訂觸發器範本「訂單總額變更(變更前後)」 前後的總數
電子郵件、電話、取消、航運公司 email, phone, cancellation, shippingLines 當發生以下更新時,會觸發「訂單更新」事件。此應用程式的任何觸發器均不會保留其舊值
在單一工作流程中可包含任意數量此類項目 最多五個 訂單更新,僅顯示您勾選的欄位 changes.fields 和 changes.items 包含 field、oldValue、newValue

訂單觸發機制,逐步解說 中針對這十種訂單觸發器,各提供了一個實作範例。

當兩者以相同的順序執行時,我們所觀察到的現象

2026 年 11 月 20 日,我們在開發環境商店中建立了一筆訂單,並在預定時間點對其進行修改,同時啟用了「訂單更新」工作流程,並讓此應用程式的觸發器並行運作。完整表格請參閱 Shopify Flow。對於訂單工作流程而言,有三項結果至關重要:

  • 建立訂單被視為一次變更。該訂單是從訂單草稿建立而來。在任何人編輯該訂單之前,「訂單已更新」觸發器已觸發兩次,一次是針對財務狀態,另一次是針對出貨狀態。此應用程式的觸發器會記住新訂單,並從其首次實際變更時開始觸發。
  • 每次寫入都算作一次執行。一秒內新增的三個標籤觸發了三次執行。其中兩次執行已顯示這三個標籤,因此相同狀態被處理了多次。此應用程式發送了一則事件,其中列出了這三個標籤。
  • 「執行」會顯示執行時的實際順序。一秒內發生的兩次音符變更觸發了兩次執行,兩者均顯示了最終音符。「音符變更順序」則發送了一個事件,其中包含首次變更前的音符以及最後一次變更後的音符。
Shopify Flow 觸發事件區塊在訂單頁面上顯示:付款狀態從「待處理」變更為「已付款」,以及新增了一則備註
Shopify 管理後台中的訂單頁面,顯示了本應用程式的「事件」區塊:狀態的變更前後對比,以及新增的備註。

需要預先取得該值的工作流程

當收到待處理付款時,釋放該訂單。當訂單財務狀態變更時,若 oldFinancialStatus 等於 pending 且 newFinancialStatus 等於 paid,則觸發此條件。若工作流程僅能偵測到「已付款」狀態,便無法將此訂單與結帳時即已付款的訂單區分開來。可直接使用:在收到待處理付款時標記訂單。

結帳後若地址有所變更,請通知倉庫。「訂單寄送地址變更」會包含變更前與變更後的地址,因此訊息中可說明包裹原先的寄送地點以及目前的寄送地點。可直接使用:當結帳後寄送地址變更時,請為訂單加上標籤。

檢視已編輯的訂單。「訂單明細變更」清單會列出所有新增、移除或變更的明細項目,並顯示變更前後的數量。透過 changeType 的條件,可將移除的項目與數量變更區分開來。可直接使用:當標籤的明細項目被編輯時,標記該標籤的訂單。

針對單一標籤進行操作。Order Tags Added 和 Order Tags Removed 會列出已變更的標籤名稱。請參閱 當某個特定標籤被新增或移除時,執行工作流程。

針對禮物訊息或送達日期的變更做出反應。「訂單屬性變更」會包含每個已變更屬性的鍵值,以及其舊值與新值,因此工作流程可以針對某個屬性採取行動,同時忽略其他屬性。

Shopify Flow 中的工作流程:在收到待處理付款時為訂單加上標籤
待處理付款送達的範本:觸發條件、針對舊狀態與新狀態的條件,以及一項動作。

何時選擇「更新訂單」才是正確的決定

  • 您希望在幾個特定欄位中的任一欄位發生變更時,能立即收到通知,且僅需當前值即可。
  • 您可以查看以單一貨幣計價的總額、小費、關稅、稅項或運費。
  • 請留意訂單的電子郵件、電話或取消詳情。
  • 工作流程必須在變更發生後一兩秒內啟動。

兩者皆可在同一儲存區中執行。當任一監控器偵測到變更時,都會觸發兩個工作流程,因此請將每個工作指派給其中一個監控器。

「Order updated」會顯示先前的值嗎?

不,Shopify 的說明頁面指出,該觸發器僅提供訂單及其明細項的當前值。此應用程式的訂單觸發器則會包含觸發前與觸發後的值。

當建立訂單時,「訂單已更新」功能會執行嗎?

Shopify 針對新訂單指定了「訂單已建立」觸發器。在我們的測試中,從草稿訂單建立的訂單,仍會觸發兩次「訂單已更新」事件,分別對應財務狀態和履約狀態。若工作流程基於狀態欄位運作,請新增條件以確保其不會對新訂單採取行動。

在 Shopify Flow 中,我可以取得某筆訂單的舊寄送地址嗎?

是的,透過「訂單寄送地址變更」功能即可。該功能會以格式化文字的形式,分段顯示變更前後的地址。寄送地址並不在「訂單更新」可監控的欄位之中。

「Order updated」能告訴我新增了哪個標籤嗎?

不。它顯示的是變更後的標籤清單。「新增的標籤」列出新增的標籤,「移除的標籤」則列出已移除的標籤。

這個應用程式會監控哪些訂單?

預設顯示過去 60 天的訂單。您可以在應用程式中將範圍擴大至 180 天、12 個月、24 個月,或您指定的日期。

我可以在同一家商店同時使用這兩者嗎?

是的。它們不會互相干擾。請根據工作流程決定由哪個觸發器來啟動它。

後續步驟