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。對於訂單工作流程而言,有三項結果至關重要:
- 建立訂單被視為一次變更。該訂單是從訂單草稿建立而來。在任何人編輯該訂單之前,「訂單已更新」觸發器已觸發兩次,一次是針對財務狀態,另一次是針對出貨狀態。此應用程式的觸發器會記住新訂單,並從其首次實際變更時開始觸發。
- 每次寫入都算作一次執行。一秒內新增的三個標籤觸發了三次執行。其中兩次執行已顯示這三個標籤,因此相同狀態被處理了多次。此應用程式發送了一則事件,其中列出了這三個標籤。
- 「執行」會顯示執行時的實際順序。一秒內發生的兩次音符變更觸發了兩次執行,兩者均顯示了最終音符。「音符變更順序」則發送了一個事件,其中包含首次變更前的音符以及最後一次變更後的音符。

需要預先取得該值的工作流程
當收到待處理付款時,釋放該訂單。當訂單財務狀態變更時,若 oldFinancialStatus 等於 pending 且 newFinancialStatus 等於 paid,則觸發此條件。若工作流程僅能偵測到「已付款」狀態,便無法將此訂單與結帳時即已付款的訂單區分開來。可直接使用:在收到待處理付款時標記訂單。
結帳後若地址有所變更,請通知倉庫。「訂單寄送地址變更」會包含變更前與變更後的地址,因此訊息中可說明包裹原先的寄送地點以及目前的寄送地點。可直接使用:當結帳後寄送地址變更時,請為訂單加上標籤。
檢視已編輯的訂單。「訂單明細變更」清單會列出所有新增、移除或變更的明細項目,並顯示變更前後的數量。透過 changeType 的條件,可將移除的項目與數量變更區分開來。可直接使用:當標籤的明細項目被編輯時,標記該標籤的訂單。
針對單一標籤進行操作。Order Tags Added 和 Order Tags Removed 會列出已變更的標籤名稱。請參閱 當某個特定標籤被新增或移除時,執行工作流程。
針對禮物訊息或送達日期的變更做出反應。「訂單屬性變更」會包含每個已變更屬性的鍵值,以及其舊值與新值,因此工作流程可以針對某個屬性採取行動,同時忽略其他屬性。

何時選擇「更新訂單」才是正確的決定
- 您希望在幾個特定欄位中的任一欄位發生變更時,能立即收到通知,且僅需當前值即可。
- 您可以查看以單一貨幣計價的總額、小費、關稅、稅項或運費。
- 請留意訂單的電子郵件、電話或取消詳情。
- 工作流程必須在變更發生後一兩秒內啟動。
兩者皆可在同一儲存區中執行。當任一監控器偵測到變更時,都會觸發兩個工作流程,因此請將每個工作指派給其中一個監控器。
「Order updated」會顯示先前的值嗎?
不,Shopify 的說明頁面指出,該觸發器僅提供訂單及其明細項的當前值。此應用程式的訂單觸發器則會包含觸發前與觸發後的值。
當建立訂單時,「訂單已更新」功能會執行嗎?
Shopify 針對新訂單指定了「訂單已建立」觸發器。在我們的測試中,從草稿訂單建立的訂單,仍會觸發兩次「訂單已更新」事件,分別對應財務狀態和履約狀態。若工作流程基於狀態欄位運作,請新增條件以確保其不會對新訂單採取行動。
在 Shopify Flow 中,我可以取得某筆訂單的舊寄送地址嗎?
是的,透過「訂單寄送地址變更」功能即可。該功能會以格式化文字的形式,分段顯示變更前後的地址。寄送地址並不在「訂單更新」可監控的欄位之中。
「Order updated」能告訴我新增了哪個標籤嗎?
不。它顯示的是變更後的標籤清單。「新增的標籤」列出新增的標籤,「移除的標籤」則列出已移除的標籤。
這個應用程式會監控哪些訂單?
預設顯示過去 60 天的訂單。您可以在應用程式中將範圍擴大至 180 天、12 個月、24 個月,或您指定的日期。
我可以在同一家商店同時使用這兩者嗎?
是的。它們不會互相干擾。請根據工作流程決定由哪個觸發器來啟動它。
後續步驟
- 訂單觸發機制,逐步解說 - 每個訂單觸發器皆附有範例。
- 舊價值與新價值:工作流程能如何運用它們 - 依觸發器區分,顯示觸發前後的所有值。
- 訂單履行、退款與退貨的更新觸發條件,以及此應用程式新增的功能 - 訂單履約、退款與退貨。
