注文項目を追加
「注文項目を追加」アクションでは、ワークフローを開始する注文に商品バリエーションが追加されます。このアクションを使用して、請求する予定の無料または有料の商品バリエーションを追加できます。
「注文項目を追加」アクションはチェックアウトの完了後に実行されるため、お客様が自分の注文を表示した場合にのみ、その項目に気づくことになります。
フィールド
「注文項目を追加」アクションには、以下のフィールドが含まれています。
| フィールド | 説明 |
|---|---|
| 商品バリエーション | 必須。このフィールドの Browse ボタンをクリックして、ショップから商品バリエーションを選択します。このフィールドは、手動で入力された商品バリエーションの GID にも対応しており、注文に追加する商品を特定できます。GID の形式は gid://shopify/ProductVariant/ の後にバリエーションID番号が続きます。たとえば、管理画面でバリエーションのページにアクセスしたとします。ブラウザのアドレスバーにある URL は https://admin.shopify.com/store/shopname/products/1234567/variants/36485954240671 です。バリエーションIDは 36485954240671 で、商品バリエーションの GID は gid://shopify/ProductVariant/36485954240671 になります。 |
| 数量 | 必須。ワークフローが注文に追加する商品の数量です。数量は0より大きい必要があります。このフィールドでは Liquid がサポートされています。Liquid は数値として評価される必要があります。そうでない場合、ランタイムエラーが発生します。 |
| 重複したバリエーションを許可する | オンにすると、バリエーションがすでに注文に含まれている場合でも、ワークフローによって注文にバリエーションの数量が追加されます。 |
| 無料で追加する | 項目に 100% のディスカウントを適用します。 |
| 注文の更新をお客様にメールで送信する | オンにすると、ワークフローによって、追加の決済を含む注文のすべての変更がお客様に通知されます。 |
| 注文タイムラインのメモ | テキストを入力すると、ワークフローによって注文タイムラインにメモとして追加されます。 |
トリガー
「注文項目を追加」アクションには、トリガーによって追加される非表示フィールドがあります。このフィールド「注文 ID」で、項目を追加する注文を特定します。注文 ID はデフォルトで設定されており、変更することはできません。
「注文項目を追加」アクションは、「注文データを取得する」アクションを含むワークフロー、または以下のような注文を含むトリガーで使用できます。
- 注文がキャンセルされたとき
- 注文が作成されたとき
- 注文がフルフィルメントされたとき
- 注文の支払い済み
- 注文リスクが分析されたとき
- 注文の取引が作成されたとき
- フルフィルメントが作成されたとき
- フルフィルメントイベントが作成されたとき
- 返金が作成されたとき
- 支払い取引が作成されたとき
制限事項
このアクションでは、在庫を考慮せずに項目が追加されます。商品が在庫にある場合にのみ項目を追加するには、アクションの前に条件を追加して、追加するバリエーションの在庫を確認してください。
APIの詳細
詳細については、orderEditAddVariant ミューテーションをご確認ください。