取得出貨訂單資料

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

設定

欄位

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

「取得資料」動作中使用的欄位。
欄位說明
資料排序依據必填。對搜尋查詢返回資料進行排序的參數。
結果數量上限必填。您選取的搜尋查詢可傳回的結果數量上限。一次最多可以傳回 100 筆。
查詢必填。從一般查詢中選擇,或選取 Advanced (進階) 建立自己的查詢。

查詢字串

此為範例查詢,目的是取得目前保留的出貨訂單:

status:ON_HOLD

status 參數是出貨訂單查詢中的篩選條件,可多次使用或與其他變數合併使用。

查詢資料時,瞭解以下資訊會有所助益:

  • 可用的出貨訂單篩選條件清單 - 查詢必須依照特定語法
  • 您可以在 QueryRoot 物件的開發人員說明文件中,查看所有查詢的查詢欄位名稱。
  • 查詢欄位值不一定都有記錄。在某些情況下,可以查看 API 文件找到這些值。此外,通常您可以在管理介面進行篩選時,於網址中找到欄位值。例如,若要尋找某些訂單查詢值,可以在管理介面中篩選「訂單」頁面,然後檢查網址。
  • 您可以使用 Shopify GraphiQL 應用程式在商店中執行或測試查詢。
  • 請特別留意,查詢失敗時會發生什麼情況。一般來說,API 將傳回所有結果 (而非未傳回任何結果)。

傳回的資料

所有「取得資料」動作都會傳回一份包含 0 到 100 個資源的清單。依使用案例而定,您可以透過多種方式使用這份資料:

  • 如果需要單獨處理每個清單項目,例如為每個清單項目新增標籤,則可以使用 For each (每個) 動作。
  • 如果需要彙總資料,例如計算傳回的結果筆數,則可以使用 Count (計數) 或 Sum (總和) 動作。
  • 如果需要輸出清單,例如傳送包含所有項目的電子郵件,可以在後續動作直接使用傳回的資料。

若要存取此動作之後的步驟中傳回的資料,請使用名稱為「取得出貨訂單資料」的變數,該變數是一份出貨訂單的清單。您可以在條件和動作中同時使用此變數。例如,您可以在「傳送內部電子郵件」動作中傳送出貨訂單的清單,如下所示:

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

觸發條件

您可以在任何工作流程 (包含排程時間觸發條件) 中使用此動作。在使用排程時間觸發條件的工作流程中,工作流程會在您指定的時間啟動,而非因為事件的結果而啟動。由於您的商店或應用程式沒有啟動工作流程的特定事件,因此系統不會自動包含任何資料。

範例

每天重複一次檢查擱置的出貨訂單,並發送電子郵件摘要的工作流程範例

在此工作流程範例中,工作流程會排定在每天的下午 04:34 執行。「取得出貨訂單資料」動作用於收集擱置訂單的資料。系統會以電子郵件發送擱置訂單清單給商店的員工。

API 參考

沒有找到您需要的答案嗎?我們很樂意為您提供協助。