說明
登入

取得出貨訂單資料

您可以使用 取得出貨訂單資料 動作，從您的商店擷取 出貨訂單 資訊。

本頁內容

設定

欄位

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

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

查詢字串

以下為擷取目前處於保留狀態的出貨訂單的查詢範例：

status:ON_HOLD

status 變數是 出貨訂單查詢 可用的篩選條件，可重複使用或與其他變數搭配。

查詢資料時，建議先瞭解：

  • 可用的出貨訂單篩選條件清單
  • 查詢必須遵循特定語法
  • 查詢欄位的可用值不一定都有文件說明。有些情況下，您可以在 API 文件 中找到這些值。或者，您也常常可以在管理介面篩選時，從網址中找到欄位值。舉例來說，若要找出部分訂單查詢的值，請在管理介面的「訂單」頁面套用篩選條件，然後查看網址。
  • 您可以使用 Shopify GraphiQL app 在您的商店中執行或測試查詢。
  • 請留意查詢失敗時的行為。API 通常會傳回所有結果，而非不傳回任何結果。

傳回的資料

所有擷取資料動作都會傳回一個清單，包含 0 到 100 個資源。依您的使用情境，您可以用不同方式處理這些資料：

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

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

{% for fulfillment_order in GetFulfillmentOrderData %}
* Order: {{ fulfillment_order.order.name }} Location: {{ fulfillment_order.assignedLocation.name }}
{% endfor %}

觸發條件

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

API 詳細資訊

範本

每天傳送保留中出貨訂單清單的電子郵件摘要

此工作流程每天會查詢所有保留中的出貨訂單，每次最多 100 筆。系統會傳送電子郵件摘要，內容包含訂單名稱與指派的出貨地點。檢視範本