新しい有料注文（トリガー）
このピースでできること
- Shopifyで注文の支払い完了が通知されたときに、ワークフローを起動します。
- 英語名：。
接続方式について（v0.10.0）
- 既存の旧カスタムアプリを使う場合は、接続方式 を選びます。以下の接続手順は、Shopify管理画面で作成済みの旧カスタムアプリ向けです。
- 2026年1月1日以降、Shopify管理画面から旧カスタムアプリを新規作成することはできません。新規アプリでは を選び、Shopify Dev Dashboardで必要な権限を設定・インストールしたアプリのClient ID・Client secretとショップ名を使って接続します。アプリとストアは同じShopify組織に所属している必要があります。
- 新規作成時は下記の旧手順内の「アプリを作成」を使わず、Shopify公式の案内と組織内ストア向けの認証条件を確認してください。
Shopify の接続方法
以下の2つを入力して接続します。
ショップ名（Shop Name）
Shopify 管理画面の URL からショップ名を確認します。
例: URL が の場合、ショップ名は example です。
管理者トークン（Admin Token）
Shopify のカスタムアプリから管理者アクセストークンを発行します。
- Shopify 管理画面にログインします
- 設定（Settings）→ アプリと販売チャネル（Apps and sales channels） を開きます
- 「アプリを開発する（Develop apps）」 をクリックします
- 「アプリを作成する（Create an app）」 をクリックし、アプリ名を入力します
- 「Admin API の設定（Configure Admin API scopes）」 をクリックします
- 以下のスコープにチェックを入れます
- ,
- ,
- ,
- ,
- 「アプリをインストール（Install app）」 をクリックします
- 表示された Admin API アクセストークン をコピーし、接続画面の 「Admin Token」 欄に貼り付けます
トークンはインストール直後にのみ表示されます。必ずコピーして保管してください。
ピースの設定項目
- このトリガーには設定項目がありません。
取得できる情報
支払い完了が通知された注文1件の情報を取得します。Shopifyから届いた注文情報をそのまま利用し、主な項目は次のとおりです。
- / / ：注文ID・注文名・注文番号。
- / ：通知に含まれる注文者の連絡先。
- / / ：注文金額・小計・通貨。金額は文字列で返る場合があります。
- / ：決済状態・配送処理の状態。
- ：注文明細の配列。各要素の ・・・・ などを利用できます。
- / ：注文の作成日時・更新日時。
取得条件と注意点
- の通知が対象です。項目の有無・空欄は通知内容やアクセス可能な顧客情報の範囲によります。
- 注文明細は の配列です。複数商品を扱う場合は、各要素を取り出して後続処理に渡してください。
利用例
注文番号・金額を通知し、注文明細を別のシステムへ登録する処理に利用できます。
出力例（抜粋）
キーの使い方を示す架空例です。実際の値や全項目を示すものではありません。