ヘルプ
ログイン

注文データを取得

注文データを必要とするワークフローでは、「注文データを取得」アクションを使用して、ストアから注文情報を取得できます。

このページの内容

設定

フィールド

「注文データを取得」アクションには、クエリの作成に使用される以下のフィールドがあります。

「データを取得」アクションで使用されるフィールド。
フィールド説明
データの並べ替え順必須。検索クエリによって返されるデータを並べ替えるためのパラメーターです。
最大結果数必須。選択した検索クエリによって返される結果の最大数です。一度に最大 100 件を返すことができます。
クエリ必須。一般的なクエリから選択するか、[詳細設定] を選択して独自のクエリを作成します。

クエリ文字列

過去 1 日間に更新された注文を取得するためのクエリの例を次に示します。

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

updated_at 変数は、注文クエリで利用できるフィルターで、複数回使用したり、他の変数と組み合わせたりすることができます。scheduledAt Liquid 変数は、[スケジュールされた時間] トリガーを使用したワークフローで利用できます。date_minus Liquid タグは、日付から時間を減算できる特別な Flow タグです。

データをクエリする際は、以下の点を知っておくと役立ちます。

  • 利用可能な注文フィルターのリスト
  • クエリは特定の構文に従う必要があります
  • クエリフィールドの値は、常にドキュメントに記載されているとは限りません。場合によっては、APIドキュメントで値が見つかることがあります。また、管理画面で絞り込みを行った際に、URLでフィールド値が見つかることもよくあります。たとえば、注文クエリの値をいくつか見つけるには、管理画面の [注文管理] ページで絞り込みを行い、URLを確認します。
  • Shopify GraphiQLアプリを使用して、ストアでクエリを実行またはテストすることができます。
  • クエリが失敗した場合にどうなるかに注意してください。多くの場合、APIは (結果を何も返さないのではなく) すべての結果を返します。

返されたデータ

すべての「データを取得」アクションは、0～100件のリソースのリストを返します。ユースケースによっては、このデータをさまざまな方法で使用できます。

  • それぞれにタグを追加するなど、各リストアイテムを個別に処理する必要がある場合は、[For each] アクションを使用できます。
  • 返された結果の数をカウントするなど、データを集計する必要がある場合は、「カウント」アクションまたは「合計」アクションを使用できます。
  • すべてのアイテムを含むメールを送信するなど、リストを出力する必要がある場合は、後続のアクションで返されたデータを直接使用できます。

このアクションに続くステップで返されたデータにアクセスするには、注文のリストである「注文データを取得」という名前の変数を使用します。この変数は、条件とアクションの両方で使用できます。たとえば、次のように「内部メールを送信する」アクションで注文のリストを送信できます。

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

トリガー

このアクションは、「スケジュールされた時間」トリガーを含む、あらゆるワークフローで使用できます。「スケジュールされた時間」トリガーを使用するワークフローでは、ワークフローはイベントの結果としてではなく、指定した時間に開始されます。ストアやアプリからのワークフローを開始する特定のイベントがないため、データは自動的には含まれません。

APIの詳細

テンプレート

返品頻度の高いお客様の注文をキャンセルする

過去6か月間に商品を5回以上返品したお客様からの注文をキャンセルします。注文データを取得し、返品数をカウントして、現在の注文をキャンセルして返金を行い、商品を在庫に補充します。このテンプレートを使用すると、常習的な返品者からの損失を減らし、潜在的な返品に事前に対処することで注文管理を効率化し、過剰な返品を抑制することで収益性を維持することができます。テンプレートを表示

お客様が本日5件を超える注文を行った場合に注文をキャンセルする

お客様が1日以内に5件を超える注文を行った場合に注文をキャンセルします。過去24時間にお客様が行った注文数を確認し、この上限を超える注文をキャンセルして、不正注文の可能性があるとしてお客様にタグ付けします。テンプレートを表示

チャージバックのあるお客様のフルフィルメント注文を保留する

注文のフルフィルメント準備が整うと、ワークフローは過去60日間に同じお客様から行われたチャージバックのある注文を取得します。そのような注文が存在する場合、各荷物のフルフィルメントを保留にし、社内メールを送信して業務部門に通知します。テンプレートを表示

お客様が24時間以内に複数の注文を行った場合にフルフィルメントを保留する

お客様が24時間以内に複数の注文を行ったかどうかを確認します。当てはまる場合は、フルフィルメントを保留にして発送を統合します。テンプレートを表示

お客様が過去24時間以内に1件を超える注文を行った場合に注文を保留する

注文が作成されると、過去24時間以内にお客様が他の注文を行っているかどうかを確認します。当てはまる場合は、すべての注文を保留にします。テンプレートを表示

過去1時間の注文数が10件未満の場合に通知を送信する

注文のハートビート通知を送信します。1時間ごとに、作成された注文を最大10件取得してカウントし、10件未満の場合はメールで通知を送信します。「時間で起動」トリガー、「注文データを取得」アクション、「カウント」ステップを使用します。テンプレートを表示する

過去1日間のオンラインストアの全注文のサマリーをメールで送信する

毎日、過去1日間の注文を取得し、オンラインストアで受け付けた注文のメールサマリーを送信します。テンプレートを表示する

2日以上経過した未発送の注文すべてのサマリーをメールで送信する

2日以上経過したすべての未発送注文の日次サマリーを取得します。スケジュール、「注文データを取得」、「カウント」、「合計」のステップを使用します。テンプレートを表示する

発送が遅れている注文にタグ付けし、日次サマリーを送信する

毎日、2日間の発送保証期間を過ぎたすべての注文にタグ付けを行い、それらの合計件数と合計金額を記載した日次メールサマリーを送信します。テンプレートを表示する

チャージバックが発生したお客様にタグ付けする

このワークフローは、1時間ごとにチャージバックのあった注文を取得し、その注文のお客様にタグを追加します。「時間で起動」トリガー、「注文データを取得」、「項目ごとループ」を使用します。テンプレートを表示する

2日以上経過した未発送の注文にタグ付けする

毎日、2日以上経過したすべての未発送の注文を取得し、その注文にタグを追加します。テンプレートを表示する

タグを使用して、過去6か月間の注文に基づいてお客様をセグメント化する

新しい注文が作成されると、過去6か月間のお客様の注文合計金額と注文数を取得し、お客様にタグを追加します。「注文データを取得」、「カウント」、「合計」の各アクションを使用します。テンプレートを表示する