草案順序觸發機制，逐步說明
「草稿訂單」是 B2B 報價、批發訂單及電話訂單的存放處，而 Shopify Flow 針對這些內容幾乎沒有提供任何功能。這十項觸發條件涵蓋了草稿的整個生命週期：編輯、狀態、標籤、備註，以及（若已啟用）聯絡人資料。
本頁內容：訂單草稿更新, 訂單草稿狀態變更, 訂單草稿明細變更, 訂單草稿標籤新增, 訂單草稿標籤移除, 訂單草稿備註變更, 訂單草稿屬性變更, 訂單草稿電子郵件變更, 訂單草稿寄送地址變更, 訂單草稿帳單地址變更
《命令草案》最新動態
每當選秀順序被保存時，都會觸發一次。
| 火災源自 | Shopify webhook |
| 權限 | 命令草案資料存取 |
| 已開啟 | 啟用一個使用該功能的 Flow 工作流程，即可開啟該功能。其專屬開關位於應用程式的「**觸發器」**頁面上 |
用於
- 將引言同步至 CRM。
- 在您釐清哪種更精確的觸發條件適用之前，這是一個通用的解決方案。
「草稿順序更新」會將哪些內容傳送至您的工作流程
| 流量中的變量 | 類型 | 內容為何 |
|---|---|---|
draftOrder |
對象 | 已更新的命令草案 |
draftOrder.id |
ID | |
draftOrder.name |
文字 | |
draftOrder.status |
文字 | |
draftOrder.totalPrice |
文字 | |
draftOrder.currencyCode |
文字 | |
draftOrder.tags |
文字 | |
draftOrder.note |
文字 | |
draftOrder.invoiceUrl |
文字 | |
draftOrder.updatedAt |
文字 | |
payload |
文字 | 包含已更新草稿訂單 GID 的 JSON 物件（例如：{"id":"gid://shopify/DraftOrder/123"}） |
eventId |
文字 | 此事件的 ID。請在應用程式的「事件記錄」中搜尋此 ID，以查看確切的傳送內容。 |
範例：將每筆報價變更同步至 CRM
- 選擇「**選秀順序更新」**作為觸發條件。
- 新增「**傳送 HTTP 請求」功能，**並支援
{{draftOrder.id}}、{{draftOrder.name}}、{{draftOrder.status}}及{{draftOrder.totalPrice}} {{draftOrder.currencyCode}}。 - 開啟此工作流程。
草案命令狀態已變更
當草案指令在 open、invoice_sent 和 completed 之間移動時觸發。
| 火災源自 | Shopify Webhook 加上變更偵測 |
| 權限 | 命令草案資料存取 |
| 已開啟 | 啟用一個使用該功能的 Flow 工作流程，即可開啟該功能。其專屬開關位於應用程式的「**觸發器」**頁面中 |
用於
- 在發送發票時啟動一連串的提醒通知。
- 當報價轉為訂單時，請告知客戶經理。
「草稿狀態變更」會將哪些資訊傳送至您的工作流程
| 流量中的變量 | 類型 | 內容為何 |
|---|---|---|
draftOrder |
對象 | 該命令草案的狀態已發生變更 |
draftOrder.id |
ID | |
draftOrder.name |
文字 | |
draftOrder.status |
文字 | |
oldStatus |
文字 | 該訂單草稿的先前狀態（已開啟／已發送發票／已完成） |
newStatus |
文字 | 訂單草稿的新狀態（已開啟／已發送發票／已完成） |
eventId |
文字 | 此事件的 ID。請在應用程式的「事件歷史紀錄」中搜尋此 ID，以查看確切的傳送內容。 |
範例：在發票開立後三天提醒客戶
- 將「**選秀順序狀態變更」**設為觸發條件。
- 新增條件：
newStatus等於invoice_sent。 - 新增「等待 3 天」，然後透過
{{draftOrder.name}}向您的電子郵件工具發送 HTTP 請求。 - 開啟此工作流程。
訂單明細項目草案已變更
當草稿訂單中的商品發生變更（新增、移除、數量、價格或變體）時觸發。其結構與訂單觸發器相同，皆採用 changes.items 格式。
| 火災源自 | Shopify Webhook 加上變更偵測 |
| 權限 | 命令草案資料存取 |
| 已開啟 | 啟用一個使用該功能的 Flow 工作流程，即可開啟該功能。其專屬開關位於應用程式的「**觸發器」**頁面中 |
用於
- 當業務代表降低報價金額時，須經核准。
- 確保預約系統與報價系統保持同步。
「草稿訂單明細項目的變更」會將哪些內容傳送至您的工作流程
| 流量中的變量 | 類型 | 內容為何 |
|---|---|---|
draftOrder |
對象 | 該草案中的各項內容已有所變更 |
draftOrder.id |
ID | |
draftOrder.name |
文字 | |
draftOrder.status |
文字 | |
changes |
對象 | 明細項目的變更：新增、刪除、數量、價格及變體變更，連同其舊值與新值 |
changes.items |
物件清單 | 偵測到的變更清單 |
changes.items (each).changeType |
文字 | 變更類型：新增、移除、數量變更、價格變更、變體變更 |
changes.items (each).lineItemId |
ID | 明細項目編號（如有） |
changes.items (each).productTitle |
文字 | 產品名稱 |
changes.items (each).variantTitle |
文字 | 替代標題 |
changes.items (each).oldVariantId |
ID | 舊版 GID（適用於已移除或 variant_changed 情況） |
changes.items (each).newVariantId |
ID | 新變體 GID（適用於「新增」或「變體變更」） |
changes.items (each).oldProductId |
ID | 舊產品 GID（適用於已移除或變體變更的情況） |
changes.items (each).newProductId |
ID | 新產品 GID（適用於新增或變更變體的情況） |
changes.items (each).oldQuantity |
數字 | 舊數量（適用於 quantity_changed） |
changes.items (each).newQuantity |
數字 | 新數量（適用於 quantity_changed） |
changes.items (each).oldPrice |
文字 | 舊價格（適用於 price_changed） |
changes.items (each).newPrice |
文字 | 新價格（適用於 price_changed） |
changes.items (each).lineItemData |
文字 | 完整的明細資料（JSON 格式） |
eventId |
文字 | 此事件的 ID。請在應用程式的「事件歷史紀錄」中搜尋此 ID，以查看確切的傳送內容。 |
範例：當報價金額有所變更時，應徵求核准
- 將「**選秀順序明細項目變更」**設為觸發條件。
- 新增一項條件：
changes.items中至少有一項的changeType等於price_changed。 - 新增「
needs-approval」草稿訂單標籤，並向銷售負責人發送內部電子郵件，內容包含已變更記錄的「oldPrice」與「newPrice」（透過 Liquidfor迴圈遍歷changes.items）。 - 開啟此工作流程。
已新增「草案」標籤
當草稿訂單中至少新增一個標籤時觸發。
| 火災源自 | Shopify Webhook 加上變更偵測 |
| 權限 | 命令草案資料存取 |
| 已開啟 | 啟用一個使用該功能的 Flow 工作流程，即可開啟它。其專屬開關位於應用程式的「**觸發器」**頁面上 |
用於
- 請讓銷售團隊透過為報價單加上標籤來啟動流程：
approved、rush。
「新增草稿順序標籤」功能會將什麼內容傳送至您的工作流程
| 流量中的變量 | 類型 | 內容為何 |
|---|---|---|
draftOrder |
對象 | 標籤發生變更的命令草案 |
draftOrder.id |
ID | |
draftOrder.name |
文字 | |
draftOrder.status |
文字 | |
draftOrder.tags |
文字 | |
addedTags |
文字 | 以逗號分隔的標籤清單，這些標籤已新增至草稿訂單中 |
removedTags |
文字 | 在同一更新中從草稿訂單中移除的標籤清單（以逗號分隔；可能為空） |
currentTags |
文字 | 草稿訂單中所有現行標籤的逗號分隔清單 |
previousTags |
文字 | 此更新之前，草稿訂單上所有先前標籤的以逗號分隔清單 |
eventId |
文字 | 此事件的 ID。請在應用程式的「事件歷史紀錄」中搜尋該 ID，以查看確切的傳送內容。 |
範例：當報價單獲批時，通知財務部門
- 將「**選秀順序標籤已新增」**設為觸發條件。
- 新增條件：
addedTags包含approved。 - 新增「透過
{{draftOrder.name}}向財務部門發送內部電子郵件」的選項。 - 開啟此工作流程。
已移除草案標籤
當草擬訂單中至少有一個標籤被移除時觸發。
| 火災源自 | Shopify Webhook 加上變更偵測 |
| 權限 | 命令草案資料存取 |
| 已開啟 | 啟用一個使用該功能的 Flow 工作流程，即可開啟此功能。其專屬開關位於應用程式的「**觸發器」**頁面中 |
用於
- 撤銷「匹配標籤」工作流程所執行的操作。
「已移除的草稿順序標籤」會將哪些內容傳送至您的工作流程
| 流量中的變量 | 類型 | 內容為何 |
|---|---|---|
draftOrder |
對象 | 標籤發生變更的命令草案 |
draftOrder.id |
ID | |
draftOrder.name |
文字 | |
draftOrder.status |
文字 | |
draftOrder.tags |
文字 | |
addedTags |
文字 | 在同一更新中新增至草稿訂單的標籤清單（以逗號分隔；可能為空） |
removedTags |
文字 | 從草稿訂單中移除的標籤清單（以逗號分隔） |
currentTags |
文字 | 草稿訂單中所有現行標籤的以逗號分隔清單 |
previousTags |
文字 | 此更新之前，草稿訂單上所有先前標籤的以逗號分隔清單 |
eventId |
文字 | 此事件的 ID。請在應用程式的「事件歷史紀錄」中搜尋此 ID，以查看確切的傳送內容。 |
範例：當批准被撤銷時，通知銷售部門
- 將「**移除選秀順序標籤」**設為觸發條件。
- 新增條件：
removedTags包含approved。 - 新增「寄送內部電子郵件給業務代表」這項功能。
- 開啟此工作流程。
命令草案註釋已修改
當草擬訂單的票據被新增、變更或結清時觸發。
| 火災源自 | Shopify Webhook 加上變更偵測 |
| 權限 | 命令草案資料存取 |
| 已開啟 | 啟用一個使用該功能的 Flow 工作流程，即會將其開啟。其專屬開關位於應用程式的「**觸發器」**頁面上 |
用於
- 將報價單上的內部備註轉交給下一支團隊。
「草稿順序備註」變更會傳送至您的工作流程中的內容
| 流量中的變量 | 類型 | 內容為何 |
|---|---|---|
draftOrder |
對象 | 那份備註內容有所變更的命令草案 |
draftOrder.id |
ID | |
draftOrder.name |
文字 | |
draftOrder.status |
文字 | |
draftOrder.note |
文字 | |
oldNote |
文字 | 關於該命令草案的先前註記（若先前未設定該註記，則為空） |
newNote |
文字 | 命令草案上的新備註（若備註已被清除，則為空） |
eventId |
文字 | 此事件的 ID。請在應用程式的「事件歷史紀錄」中搜尋此 ID，以查看確切的傳送內容。 |
範例：將報價備註轉發至帳戶通訊管道
- 將「**選秀順序備註已變更」**設為觸發條件。
- 新增「透過
{{draftOrder.name}}: {{newNote}}向 Slack 發送 HTTP 請求」功能。 - 開啟此工作流程。
草案訂單屬性已變更
當草稿訂單上的自訂屬性被新增、移除或變更時觸發。
| 火災源於 | Shopify Webhook 加上變更偵測 |
| 權限 | 命令草案資料存取 |
| 已開啟 | 啟用一個使用該功能的 Flow 工作流程，即可開啟它。其專屬開關位於應用程式的「**觸發器」**頁面上 |
用於
- 根據儲存為屬性的採購單號或預定交貨週進行處理。
「草稿順序屬性變更」會將哪些內容傳送至您的工作流程
| 流量中的變量 | 類型 | 內容為何 |
|---|---|---|
draftOrder |
對象 | 該草稿命令的自訂屬性已變更 |
draftOrder.id |
ID | |
draftOrder.name |
文字 | |
draftOrder.status |
文字 | |
changes |
對象 | 偵測到屬性變更。每個項目包含 changeType（新增、移除或變更）、鍵值，以及舊值與新值。 |
changes.items |
物件清單 | 偵測到的屬性變更清單 |
changes.items (each).changeType |
文字 | 變更類型：新增、刪除、修改 |
changes.items (each).key |
文字 | 屬性鍵 |
changes.items (each).oldValue |
文字 | 先前值（當 changeType 為 'added' 時為空字串） |
changes.items (each).newValue |
文字 | 新值（當 changeType 為 'removed' 時為空字串） |
eventId |
文字 | 此事件的 ID。請在應用程式的「事件歷史紀錄」中搜尋此 ID，以查看確切的傳送內容。 |
範例：擷取採購單編號
- 將「**選秀順序屬性變更」**設為觸發條件。
- 新增一項條件：
changes.items中，至少有一項的key等於po_number。 - 新增「向 ERP **發送 HTTP 請求」**並填入新值。
- 開啟此工作流程。
「草案訂單」電子郵件地址已變更
當草稿訂單中的電子郵件地址變更時觸發。該通知會包含當前的電子郵件地址。
| 火災源自 | Shopify Webhook 加上變更偵測 |
| 權限 | 命令草案資料存取 |
| 已開啟 | 啟用一個使用該功能的 Flow 工作流程，即可開啟它。其專屬開關位於應用程式的「**觸發器」**頁面上 |
用於
- 請確保發票寄往正確的地址。
「草稿順序變更」電子郵件會將什麼內容傳送至您的工作流程
| 流量中的變量 | 類型 | 內容為何 |
|---|---|---|
draftOrder |
對象 | 那份電子郵件地址有所變更的命令草案 |
draftOrder.id |
ID | |
draftOrder.name |
文字 | |
draftOrder.status |
文字 | |
draftOrder.note |
文字 | |
email |
文字 | 該命令草案目前的電子郵件地址 |
eventId |
文字 | 此事件的 ID。請在應用程式的「事件歷史紀錄」中搜尋此 ID，以查看確切的傳送內容。 |
範例：在修正電子郵件內容後重新寄送發票
- 「選秀順序」電子郵件在流程中已變更。
- 新增一個條件：
draftOrder.status等於invoice_sent。 - 新增「發送內部電子郵件，請業務代表重新寄送發票」。
- 開啟此工作流程。
「草稿訂單」寄送地址已變更
當草稿訂單的寄送地址變更時觸發。
| 火災源自 | Shopify Webhook 加上變更偵測 |
| 權限 | 命令草案資料存取 |
| 已開啟 | 啟用一個使用該功能的 Flow 工作流程，即可開啟此功能。其專屬開關位於應用程式的「**觸發器」**頁面中 |
用於
- 當目的地變更時，重新計算報價中的運費或稅金。
「運送地址變更」草稿指令會向您的工作流程傳送什麼內容
| 流量中的變量 | 類型 | 內容為何 |
|---|---|---|
draftOrder |
對象 | 那份寄送地址有所變更的訂單草稿 |
draftOrder.id |
ID | |
draftOrder.name |
文字 | |
draftOrder.status |
文字 | |
draftOrder.note |
文字 | |
shippingAddress |
文字 | 訂單草稿目前的寄送（配送）地址，以單行格式呈現（可能為空） |
shippingAddressDetails |
對象 | 訂單草案的當前運送（送達）地址，以結構化欄位形式呈現（可能為空） |
shippingAddressDetails.firstName |
文字 | 地址上的名字 |
shippingAddressDetails.lastName |
文字 | 地址上的姓氏 |
shippingAddressDetails.name |
文字 | 全名，由 firstName 和 lastName 衍生而來 |
shippingAddressDetails.company |
文字 | 公司或組織名稱 |
shippingAddressDetails.address1 |
文字 | 第一行 - - 街道地址或郵政信箱號碼 |
shippingAddressDetails.address2 |
文字 | 第二行 - 公寓、套房或單位 |
shippingAddressDetails.city |
文字 | 市、區、村或鎮 |
shippingAddressDetails.province |
文字 | 地區 - - 省、州或區 |
shippingAddressDetails.provinceCode |
文字 | 地區代碼（例如 ON） |
shippingAddressDetails.zip |
文字 | 郵遞區號或郵政編號 |
shippingAddressDetails.country |
文字 | 國家名稱 |
shippingAddressDetails.countryCode |
文字 | 兩字母國家代碼（例如 US） |
shippingAddressDetails.phone |
文字 | 地址上的電話號碼 |
eventId |
文字 | 此事件的 ID。請在應用程式的「事件歷史紀錄」中搜尋此 ID，以查看確切的傳送內容。 |
範例：標記目標國家有所變更的報價
- 在流程中變更揀貨順序與寄送地址。
- 在內部電子郵件中，請新增草稿訂單標籤
recheck-shipping，並標記{{shippingAddressDetails.countryCode}}。 - 開啟此工作流程。
「草案訂單」的帳單地址已變更
當草稿訂單的帳單地址發生變更時，會觸發此事件。
| 火災源自 | Shopify Webhook 加上變更偵測 |
| 權限 | 命令草案資料存取 |
| 已開啟 | 啟用一個使用該功能的 Flow 工作流程，即可開啟該功能。其專屬開關位於應用程式的「**觸發器」**頁面中 |
用於
- 在開立發票之前，請確保 ERP 系統中的債務人記錄保持最新。
「草稿訂單帳單地址變更」會將哪些內容傳送至您的工作流程
| 流量中的變量 | 類型 | 內容為何 |
|---|---|---|
draftOrder |
對象 | 該草案的帳單地址已變更 |
draftOrder.id |
ID | |
draftOrder.name |
文字 | |
draftOrder.status |
文字 | |
draftOrder.note |
文字 | |
billingAddress |
文字 | 訂單草稿目前的帳單地址，以單行格式呈現（可能為空） |
billingAddressDetails |
對象 | 訂單草稿目前的帳單地址（以結構化欄位形式呈現，可能為空） |
billingAddressDetails.firstName |
文字 | 地址上的名字 |
billingAddressDetails.lastName |
文字 | 地址上的姓氏 |
billingAddressDetails.name |
文字 | 全名，由 firstName 和 lastName 推算得出 |
billingAddressDetails.company |
文字 | 公司或組織名稱 |
billingAddressDetails.address1 |
文字 | 第一行 - - 街道地址或郵政信箱號碼 |
billingAddressDetails.address2 |
文字 | 第二行 - - 公寓、套房或單位 |
billingAddressDetails.city |
文字 | 市、區、村或鎮 |
billingAddressDetails.province |
文字 | 地區 - - 省、州或區 |
billingAddressDetails.provinceCode |
文字 | 地區代碼（例如 ON） |
billingAddressDetails.zip |
文字 | 郵遞區號或郵政編碼 |
billingAddressDetails.country |
文字 | 國家名稱 |
billingAddressDetails.countryCode |
文字 | 兩字母國家代碼（例如 US） |
billingAddressDetails.phone |
文字 | 地址上的電話號碼 |
eventId |
文字 | 此事件的 ID。請在應用程式的「事件歷史紀錄」中搜尋此 ID，以查看確切的傳送內容。 |
範例：在開立發票前更新 ERP 系統
- 在流程中選擇選秀順序及變更帳單地址。
- 新增「透過
{{draftOrder.id}}傳送 HTTP 請求」，並填入billingAddressDetails中的各項欄位。 - 開啟此工作流程。
下一步
草稿訂單並非 Flow 的參考類型，因此這些觸發器會傳回一個包含 id、name 和 status 的 draftOrder 物件。若需處理其他項目，請新增「傳送管理 API 請求」或「**執行程式碼」**步驟，並傳入 draftOrder.id。
- 完整的觸發器參考指南 - 所有觸發器都集中在一頁上。
- 選擇合適的扳機 - 哪一種適合您的情況。
- 自訂觸發器 - 若沒有合適的內建觸發器，請自行撰寫。
- 事件歷史紀錄與疑難排解 - 查看發射了什麼以及攜帶了什麼。
- 在記錄的管理頁面上觸發事件 - 某筆紀錄的最新動態，位於 Shopify 管理介面中的專屬頁面。