取得訂單資料
在需有訂單資料的工作流程中,可以使用取得訂單資料動作,從您的商店擷取訂單資訊。
設定
欄位
「取得訂單資料」動作包含下列用於建立查詢的欄位:
欄位 | 說明 |
---|---|
資料排序依據 | 必填。對搜尋查詢返回資料進行排序的參數。 |
結果數量上限 | 必填。您選取的搜尋查詢可傳回的結果數量上限。一次最多可以傳回 100 筆。 |
查詢 | 必填。從一般查詢中選擇,或選取 Advanced (進階) 建立自己的查詢。 |
查詢字串
此為範例查詢,目的是取得前一天更新的訂單:
updated_at
參數是訂單查詢中的篩選條件,可多次使用或與其他變數合併使用。scheduledAt
Liquid 變數適用於使用「排定時間」(Scheduled time) 觸發條件的工作流程。date_minus
Liquid 標籤是特殊 Flow 標籤,可讓您從日期中減去時間。
查詢資料時,瞭解以下資訊會有所助益:
- 可用的訂單篩選條件清單 - 查詢必須依照特定語法
- 您可以在 QueryRoot 物件的開發人員說明文件 中,查看所有查詢的查詢欄位名稱。
- 查詢欄位值不一定都有記錄。在某些情況下,可以查看 API 文件找到這些值。此外,通常您可以在管理介面進行篩選時,於網址中找到欄位值。例如,若要尋找某些訂單查詢值,可以在管理介面中篩選「訂單」頁面,然後檢查網址。
- 您可以使用 Shopify GraphiQL 應用程式在商店中執行或測試查詢。
- 請特別留意,查詢失敗時會發生什麼情況。一般來說,API 將傳回所有結果 (而非未傳回任何結果)。
傳回的資料
所有「取得資料」動作都會傳回一份包含 0 到 100 個資源的清單。依使用案例而定,您可以透過多種方式使用這份資料:
- 如果需要單獨處理每個清單項目,例如為每個清單項目新增標籤,則可以使用 For each (每個) 動作。
- 如果需要彙總資料,例如計算傳回的結果筆數,則可以使用 Count (計數) 或 Sum (總和) 動作。
- 如果需要輸出清單,例如傳送包含所有項目的電子 郵件,可以在後續動作直接使用傳回的資料。
若要存取此動作之後的步驟中傳回的資料,請使用名稱為「取得訂單資料」的變數,該變數是一份訂單清單。您可以在條件和動作中同時使用此變數。例如,您可以在「傳送內部電子郵件」動作中傳送訂單清單,如下所示:
觸發條件
您可以在任何工作流程 (包含排程時間觸發條件) 中使用此動作。在使用排程時間觸發條件的工作流程中,工作流程會在您指定的時間啟動,而非因為事件的結果而啟動。由於您的商店或應用程式沒有啟動工作流程的特定事件,因此系統不會自動包含任何資料。
API 詳細資訊
範本
取消經常退貨的顧客的訂單
取消過去六個月退貨至少五次的顧客所下的訂單。系統會擷取訂單數據、計算退貨並取消目前的訂單,同時發放退款並將品項重新入庫。此範本可用於:減少習慣性退貨顧客造成的損失;透過預先處理潛在退貨情況,簡化訂單管理;以及透過打擊過度退貨,維持營利能力。檢視範本
如果顧客一天提交超過 5 筆訂單,系統會取消訂單
如果顧客在一天內提交超過五筆訂單,系統會取消訂單。系統會檢查顧客在過去 24 小時內提交的訂單數量,並取消超出此上限的訂單,同時將顧客標記為潛在詐騙。檢視範本
針對有交易退單的顧客擱置訂單出貨作業
在訂單已準備好出貨時,工作流程擷取同一顧客在過去 60 天內有交易退單的訂單。如果存有此類訂單,系統會擱置貨件出貨作業,並寄送內部電子郵件以就通知您的操作團隊。檢視範本
若顧客在 24 小時內提交多筆訂單,則擱置出貨作業
檢查顧客是否在 24 小時內提交多筆訂單。若是如此,則擱置出貨作業並合併運送。檢視範本
若顧客在過去 24 小時內提交超過 1 筆訂單,則擱置訂單
訂單建立時,確認顧客是否曾在過去 24 小時內提交其他訂單。若是如此,則擱置所有訂單。檢視範本
最近一小時訂單量少於 10 筆時傳送通知
傳送訂單 heartbeat 通知。每小時獲取最多 10 筆已建立的訂單並進行計數。如果少於 10 筆,則透過電子郵件傳送通知。使用排程時間、取得訂單資料和計數步驟。檢視範本
寄送電子郵件摘要以列出網路商店前一天的所有訂單
每天取得網路商店在前一天收到的訂單並寄送電子郵件摘要。檢視範本
將超過 2 天未出貨的訂單列入電子郵件摘要並寄出
為所有已超過 2 天未出貨的訂單取得每日 摘要、善用排程功能,取得訂單資料、數量和總計。檢視範本
標記延遲出貨並寄送每日摘要
每天標記並寄送每日電子郵件摘要,用以計算所有不符 2 天運送保證的訂單總數和價值(以美元計)。檢視範本
標記有交易退單記錄的顧客
此工作流程每小時都會取得有交易退單記錄的訂單,並對提交該訂單的顧客新增標籤。使用排程時間觸發條件、取得訂單資料動作,以及 For Each 迴圈。檢視範本
標記超過 2 天的未出貨訂單
此工作流程每天都會擷取所有超過 2 天的未出貨訂單,並為這些訂單加上標籤。檢視範本
使用標籤並根據過去 6 個月的訂單來區隔顧客
新訂單建立時,取得該顧客最近 6 個月的訂單總額和訂單數量,然後對顧客新增標籤。運用「取得訂單資料」(Get order data)、「計數」(Count)、「加總」(Sum)。檢視範本