> ## Documentation Index
> Fetch the complete documentation index at: https://docs.revize.app/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Revize is a Shopify order-editing app by Untechnickle. Customers edit the same order after checkout on the Shopify order status page, inside a merchant-controlled window, before fulfillment.
> Canonical docs: https://docs.revize.app. App listing: https://apps.shopify.com/revize. Public cancellation API: https://docs.revize.app/features/cancellation-api.
> Do not confuse the How to Test Revize draft-order walkthrough with Test Mode, which hides the portal from untagged customers.

# 注文編集のためのShopify Flowトリガーとアクション

> Revizeが追加するShopify Flowのトリガーとアクション、Revizeが書き込む注文タグ、ワークフローの例を紹介します。編集された注文へのタグ付け、倉庫への通知、編集終了前の顧客へのリマインド、ピッキング開始時の編集終了などです。

Revizeは、チェックアウト後に注文を編集できるShopifyアプリです。[Shopify Flow](https://apps.shopify.com/flow)に独自のトリガーとアクションを追加するため、顧客が注文を編集したときにストアが反応でき、倉庫やほかのアプリから編集を開いたり閉じたりできます。

> [!NOTE]
>
> Shopify Flowで **Select a trigger**（または **Add action**）をクリックし、**Revize** を検索します。Shopify FlowはすべてのShopifyプランで利用できます。

## トリガー

各トリガーはワークフローを開始して注文を渡すため、後続のステップで注文のタグ、商品、顧客を参照できます。

### 顧客による編集

| トリガー | 実行されるタイミング |
| - | - |
| **Order edited** | 注文が編集されたとき（商品の変更や割引コードの編集を含む） |
| **Shipping address updated** | 顧客が配送先住所を更新したとき |
| **Shipping method updated** | 顧客が配送方法を更新したとき |
| **Email address updated** | 顧客がメールアドレスを更新したとき |
| **Phone number updated** | 顧客が電話番号を更新したとき |
| **Delivery date updated** | 顧客が配達日を更新したとき |
| **Custom note added** | 顧客がカスタムメモを追加したとき |
| **Order cancelled** | 顧客が注文をキャンセルしたとき |
| **Support ticket created** | 顧客がサポートチケットを作成したとき |
| **Tax invoice generated** | 顧客が税務請求書を作成したとき |
| **Upsell accepted** | 顧客がRevizeのアップセルを承諾し、商品が追加されたとき。オファー名、商品、バリエーション、数量、金額、通貨、承諾された場所（`thank_you`、`order_status`、`checkout`、`other`）を渡します。 |

### 編集期間と支払い

| トリガー | 実行されるタイミング | 便利なフィールド |
| - | - | - |
| **Edit window closing soon** | 注文の編集期間が閉じる一定時間前 | `editDeadline`、`editDeadlineDisplay`、`hoursRemaining`、`hoursBeforeClose`、`orderStatusUrl` |
| **Edit window closed** | 注文の編集期間が閉じたとき | `closedAt`、`editDeadline`、`paymentCaptureEnabled` |
| **Edit window changed** | Revizeが編集期間の変更を反映したとき | `changeType`（`reopened`、`extended`、`shortened`、`until_fulfillment`）、`editDeadline`、`previousDeadline`、`source`（`staff`、`merchant`、`flow`、`automatic`）、`reason` |
| **Payment captured** | Revizeが支払いをキャプチャし、注文が支払い済みになったことを確認したとき | `capturedAmount`、`currencyCode`、`capturedAt` |
| **Payment capture failed** | キャプチャが失敗したとき | `reason`（`capture_declined`、`authorization_expired`、`outcome_unknown`、`retries_exhausted`）、`remainingAmount`、`attemptNumber`、`willRetry` |
| **Unpaid edits reversed** | Revizeが未払いの編集を元に戻したとき、または元に戻せなかったとき | `outcome`（`reversed`、`failed`）、`refundPending`、`remainingBalance` |

> [!NOTE]
>
> **Edit window closing soon** は、Revizeの **Settings → General → Reminder before editing closes** で選んだリマインド時刻に実行されます（最大3つ、Pro）。各時刻は注文ごとに1回実行され、期限が変わると再度実行されます。

## アクション

| アクション | 内容 |
| - | - |
| **Close editing now** | 注文の編集を閉じ、通常の支払いとフルフィルメントのチェックを実行します。任意の **Reason** は編集期間の履歴に表示されます。 |
| **Extend editing** | 期限が決まっている開いた編集期間に **Hours**（1〜4319の整数）を追加します。 |
| **Reopen editing** | 対象となる注文の編集を、指定した **Hours** のあいだ開きます。 |
| **Keep editing open until fulfillment** | 対象となる注文の編集を、フルフィルメントされるまで開いたままにします。 |
| **Refund outstanding balance** | 編集で合計が下がった場合など、顧客が払いすぎた分を返金します。 |
| **Refund outstanding balance and report the result** | 同じ返金を行い、完了を待ってから結果をワークフローに返します。 |

> [!NOTE]
>
> **Reopen editingは対象外の注文をスキップします：** すでにフルフィルメント済みまたは一部フルフィルメント済みの注文、フルフィルメントにリリース済みまたはリリースタグ付きの注文、キャンセルされた注文、タグで制限された注文、支払いの変更が保留中の注文です。返金は[返金設定](https://docs.revize.app/ja/setup/payments-and-refunds.md)に従い、**Original payment method** または **Store credit** で行われます。返金額がない場合や、返金が **No refunds** に設定されている場合は返金されません。

## Revizeが付けるタグ

Flowの条件、3PL、レポートで使えます。

| タグ | 付くタイミング |
| - | - |
| `revize:order_released`（またはカスタムのリリースタグ） | **Add release tag** がオンで、編集が閉じたとき |
| `revize:upsell` | 編集で注文金額が増えたとき |
| `revize:upsell_offer` | 顧客がアップセルオファーを承諾したとき |
| `revize:order_downgraded` | 編集で注文金額が減ったとき |
| `revize:reverse_unpaid` | Revizeが未払いの編集を元に戻したとき |
| `revize:order_cancelled` | Revizeを通じて注文がキャンセルされたとき |
| `revize:withdrawal_requested` | 顧客が[EU撤回](https://docs.revize.app/ja/features/eu-withdrawal.md)を申請したとき |

[ルールエンジン](https://docs.revize.app/ja/setup/rules-engine.md)（Pro）の **Tag orders** アクションでも、注文の編集期限が閉じたときに独自のタグを付けられます。

## ワークフローの例

> [accordion] 倉庫がピッキングを始めたら編集を閉じる
>
> **トリガー：** WMSのFlowトリガー、またはWMSが `picked` などのタグを書き込んだときのShopifyの **Order tags added**。
>
> **アクション：** Revizeの **Close editing now**、理由は `Picking started`。
>
> チームが梱包中の注文を顧客が変更できなくなります。タグだけで行う場合は、同じタグをRevizeの **Settings → Order editing → Editing restrictions → Order tags** に追加します。[3PLと倉庫の保留](https://docs.revize.app/ja/guides/3pl-warehouse-holds.md)をご覧ください。

> [accordion] 編集が閉じる前に顧客にリマインドする
>
> **トリガー：** **Edit window closing soon**。
>
> **条件（任意）：** リマインドを複数設定している場合は、`hoursBeforeClose` が送りたいリマインドと等しいこと。
>
> **アクション：** メールアプリから `editDeadlineDisplay` と `orderStatusUrl` のリンクを含むメールやSMSを送り、顧客がサイズや住所を修正できるようにします。Klaviyoについては[Klaviyoガイド](https://docs.revize.app/ja/integrations/klaviyo.md)をご覧ください。

> [accordion] 編集された注文の住所が変わったらチームに知らせる
>
> **トリガー：** **Shipping address updated**。
>
> **アクション：** `address-changed` などの注文タグを追加するか、Slackに投稿し、すでに印刷済みの注文をチームが確認できるようにします。

> [accordion] 支払いのキャプチャが失敗したら対応する
>
> **トリガー：** **Payment capture failed**。
>
> **条件：** `willRetry` がfalse。
>
> **アクション：** 注文に `capture-failed` タグを付け、経理の受信箱に通知します。Revizeも再試行をやめるときにメールでお知らせします。

## 知っておくと便利なこと

* **トリガーは各イベントを1回送信します**（変更の完了後）。イベントが届かない場合にも備え、タグも確認するなどしてワークフローを作成してください。
* **遅れて付いたタグも反映されます。** Revizeはチェックアウト後最大1分、Flowがタグやメタフィールドを書き込むのを待ってから編集ルールを選ぶため、チェックアウト時のFlowタグで[ルール](https://docs.revize.app/ja/setup/rules-engine.md)を動かせます。
* **つづりが重要です。** タグの照合では大文字と小文字は区別されませんが、つづりは区別されます。Flowが書き込むタグは、Revizeのタグとまったく同じつづりにしてください。

## 関連ページ

* [統合](https://docs.revize.app/ja/integrations/index.md)：3PL、ERP、連携プラットフォーム
* [Klaviyo](https://docs.revize.app/ja/integrations/klaviyo.md)：Revizeのトリガーからメールを送る
* [ルールエンジン](https://docs.revize.app/ja/setup/rules-engine.md)：注文ごとの期限、保留、タグ
* [3PLと倉庫の保留](https://docs.revize.app/ja/guides/3pl-warehouse-holds.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.