說明
登入

擷取訂單資料

在需要訂單資料的工作流程中，您可以使用「擷取訂單資料」動作，從商店擷取訂單資訊。

本頁內容

設定

欄位

「擷取訂單資料」動作包含下列欄位，用於建立查詢：

擷取資料動作使用的欄位。
欄位說明
排序依據必填。用來決定搜尋查詢傳回資料排序的參數。
結果數上限必填。您選取的搜尋查詢一次可傳回的結果數上限。每次最多可傳回 100 筆。
查詢必填。可從常用查詢中選擇，或選取「進階」自行建立。

查詢字串

以下是擷取過去 1 天內更新之訂單的查詢範例：

updated_at:<='{{ scheduledAt }}' AND updated_at:>'{{ scheduledAt | date_minus: "1 day" }}'

updated_at 變數是 Orders query 提供的篩選條件，可重複使用，或與其他變數搭配。scheduledAt 為可在使用 Scheduled time trigger 的工作流程中使用的 Liquid 變數。date_minus 為 Shopify Flow 的特殊 Liquid 標籤，可讓您從日期減去時間。

在查詢資料時，瞭解以下事項會很有幫助：

  • List of available order filters
  • 查詢必須遵循 certain syntax。
  • 查詢欄位的值不一定都有文件說明。有時您可以在 API docs 中找到這些值。或者，您常可在管理介面篩選時，從網址中找到欄位值。例如，若要找出部分 Order 查詢的值，請在管理介面的「訂單」頁面套用篩選，然後查看網址。
  • 您可以使用 Shopify GraphiQL app 在商店中執行或測試查詢。
  • 請留意查詢失敗時的行為。API 通常會傳回所有結果 (而非不傳回任何結果)。

傳回的資料

所有「擷取資料」動作都會傳回 0 到 100 筆資源的清單。依您的使用情境，您可以用以下方式運用這些資料：

  • 若需要逐一處理清單中的每個項目，例如為每個項目新增標籤，您可以使用 For each 動作。
  • 若需要彙總資料，例如計算傳回了多少筆結果，您可以使用 Count 或 Sum 動作。
  • 若需要輸出清單，例如寄送包含所有項目的電子郵件，您可以在後續動作中直接使用傳回的資料。

若要在此動作後續的步驟中存取傳回的資料，請使用名為「擷取訂單資料」的變數，該變數是一份訂單清單。此變數可用於條件與動作。例如，您可以在「寄送內部電子郵件」動作中如下傳送訂單清單：

{% for single_order in GetOrderData %}
* {{ single_order.name }}
{% endfor %}

觸發條件

此動作可用於任何工作流程，包括「排程時間」觸發條件。使用「排程時間」觸發條件的工作流程會在您指定的時間開始，而不是因事件而啟動。由於不是由商店或 app 中的特定事件啟動，工作流程不會自動包含任何資料。

API 詳細資訊

範本

為經常退貨的顧客取消訂單

針對過去 6 個月內退貨達 5 次以上的顧客，自動取消其訂單。此工作流程會擷取訂單資料、統計退貨次數，並取消目前的訂單，同時退款並將品項重新入庫。此範本可用於：降低慣性退貨帶來的損失、預先處理潛在退貨以簡化訂單管理，以及藉由抑制過度退貨以維持獲利能力。View template

顧客今日下單超過 5 筆時取消訂單

若顧客在一天內下單超過 5 筆，便會取消訂單。此工作流程會檢查顧客在過去 24 小時內的下單數，並取消超出此上限的任何訂單，同時將顧客標記為可能詐騙。View template

針對有拒付紀錄的顧客保留出貨訂單

當訂單準備出貨時，工作流程會擷取同一位顧客在過去 60 天內有拒付的任何訂單。若有此類訂單，系統會將每筆貨件的出貨作業設為保留，並寄送內部電子郵件通知您的營運團隊。View template

顧客 24 小時內多次下單時保留出貨作業

檢查顧客是否在 24 小時內多次下單。若是，則保留出貨作業並合併運送。View template

顧客過去 24 小時內下單超過 1 筆時保留訂單

當建立訂單時，檢查該顧客在過去 24 小時內是否還有其他訂單。若有，將所有訂單設為保留。View template

過去 1 小時內訂單數少於 10 筆時傳送通知

傳送訂單心跳通知。每小時擷取最多 10 筆新建立的訂單並計算數量。若少於 10 筆，則透過電子郵件傳送通知。使用「排程時間」、「擷取訂單資料」與「計數」步驟。 View template

寄送過去 1 天於線上商店的所有訂單電子郵件摘要

每天擷取過去 1 天的訂單，並針對於網路商店成立的訂單寄送電子郵件摘要。 View template

寄送超過 2 天的所有未出貨訂單電子郵件摘要

每天彙整超過 2 天的所有未出貨訂單摘要，並運用排程、擷取訂單資料、計數與加總。 View template

標記延遲出貨並寄送每日摘要

每天標記並寄送每日電子郵件摘要，統計所有未達 2 天出貨保證之訂單的總數與金額。 View template

標記有交易退單的顧客

此工作流程每小時會擷取發生拒付的訂單，並為該訂單的顧客加上標籤。使用排程時間觸發條件、擷取訂單資料與 for each 迴圈。 View template

標記超過 2 天的未出貨訂單

每天擷取所有超過 2 天的未出貨訂單，並在訂單上加上標籤。 View template

使用標籤依過去 6 個月的訂單分群顧客

建立新訂單時，擷取該顧客過去 6 個月的訂單總金額與訂單數，然後替顧客加上標籤。使用「擷取訂單資料」、「計數」、「加總」。 View template