取得現金追蹤工作階段資料

在需要現金追蹤工作階段資料的工作流程中，您可以使用 取得現金追蹤工作階段資料 動作，從您的 POS Pro 擷取現金追蹤工作階段資訊。現金追蹤工作階段 可用來追蹤商店收銀機中的現金。

設定

欄位

「取得現金追蹤工作階段資料」動作包含以下欄位。

查詢字串

以下是查詢過去一天內已關閉的現金追蹤工作階段的範例：

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

closing_time 變數是 CashTrackingSessions query 中可用的篩選條件，可重複使用，或與其他變數搭配。使用 Scheduled time 觸發條件 的工作流程可使用 scheduledAt Liquid 變數。date_minus Liquid 標籤是 Flow 的特殊標籤，可讓您從日期減去一段時間。

查詢資料時，請注意：

• 可用的現金追蹤工作階段篩選條件清單

• 查詢必須遵循特定語法

• 查詢欄位值不一定都有文件說明。有些情況下，您可以參考API 文件取得這些值。或者，您也常可在管理介面套用篩選器時，從網址找出欄位值。舉例來說，若要找出部分訂單查詢的值，請在管理介面的「訂單」頁面套用篩選條件，然後查看網址。

• 您可以使用 Shopify GraphiQL app 在您的商店執行或測試查詢。

• 請留意查詢失敗時的情況。API 通常會回傳所有結果（而非零筆）。

回傳的資料

所有 Get data 動作都會回傳 0 到 100 個資源的清單。依您的使用情境，您可以以下列方式運用這些資料：

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

若要在此動作後續的步驟中存取回傳資料，請使用名為 Get cash tracking session data 的變數，這是一份現金追蹤工作階段清單。您可以在條件與動作中使用此變數。例如，您可以在 Send internal email 動作中這樣傳送這份現金追蹤工作階段清單：

{% for single_cash_tracking_session in GetCashTrackingSessionData %}
* {{ single_cash_tracking_session.id }}
{% endfor %}

觸發條件

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

API 參考

如需此動作所用 API 的更多資訊，請參閱 CashTrackingSessions query。