# 請求書の自動進行

Stripe が請求書の状態を自動で進行させ、支払い回収を支援する仕組みをご紹介します。

すべての請求書は `draft` として開始し、支払いを受け付けるためには `open` に移行する必要があります。請求書の支払期限が過ぎた場合や支払いが失敗した場合、Stripe は自動的にリマインダーを送信したり、支払いを再試行したりできます。これらの状態遷移や回収試行を Stripe に自動管理させるか、ご自分で管理するかを選択できます。詳しくは、[請求のライフサイクル](https://docs.stripe.com/invoicing/overview.md#invoice-lifecycle) をご覧ください。

APIを使用して作成された請求書については、請求書の [auto_advance](https://docs.stripe.com/api/invoices/update.md#update_invoice-auto_advance) のプロパティを `true` に設定します。関連するイベントを受け取るために、Webhookエンドポイントを設定することも検討してください。`auto_advance` を `false` に設定した場合、請求書の状態遷移はご自身で管理する必要があります。詳しくは、[Webhookエンドポイントと請求書の確定](https://docs.stripe.com/billing/subscriptions/webhooks.md#understand) をご覧ください。

## 自動請求書進行を更新

自動進行の設定を更新するには、請求書が `draft` (下書き) または `open` (未決済) 状態である必要があります。`paid` (支払い済み)、`void` (無効)、または `uncollectible` (回収不能)の請求書は、常に自動進行がオフになっています。

#### ダッシュボード

ダッシュボードで作成された請求書には、自動請求書進行機能がデフォルトで有効になっています。

任意の請求書に対して、自動進行を手動でオンまたはオフに切り替えることができます。請求書詳細ページでオーバーフローメニュー、(⋯) をクリックし、**自動リマインダーのオン/オフ切り替え**を選択します。ファイルに保存された支払い方法に自動課金する設定の請求書には、自動的に**自動回収のオン/オフ切り替え**が表示されます。これにより、請求書の `auto_advance` プロパティが変更されます。このオン・オフの比較については、以下の機能表をご参照ください。

#### API

`draft` および `open` 状態の請求書で、`auto_advance` プロパティを切り替えることができます。

```curl
curl https://api.stripe.com/v1/invoices/id \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d auto_advance=false
```

## 自動進行を一時停止する

状況によっては、Stripe による請求書の回収処理の自動進行を停止しなければならないことがあります。以下に例を示します。

- 独自のビジネスロジックを使用して、請求書のライフサイクルを管理する。
- 請求書のメール送信をするかどうかとそのタイミングを請求書ごとに決定する。

これらのケースのいずれでも、`auto_advance` プロパティーを使用して自動進行と自動請求動作を無効化できます。

## 自動進行機能の比較

ダッシュボードで自動進行をオフにするか、`auto_advance` を `false` に設定すると、Stripe は請求書のほとんどの自動回収機能を無効にします。以下の表は、`auto_advance` を `true` または `false` に設定した場合の自動回収の動作の主な違いを示しています。

| 機能                                                              | True                                                                                                          | False        |
| --------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------- | ------------ |
| 請求書のメール送信                                                       | ✓ Yes ⚙ 設定可能                                                                                                  | ✗ 無効         |
| 再試行 (メールと請求)                                                    | ✓ Yes ⚙ 設定可能                                                                                                  | ✗ 無効         |
| 請求書のリマインドメール                                                    | ✓ Yes ⚙ 設定可能                                                                                                  | ✗ 無効         |
| 3D セキュアのリマインドメール                                                | ✓ Yes ⚙ 設定可能                                                                                                  | ✗ 無効         |
| メール領収書                                                          | ✓ Yes ⚙ 設定可能                                                                                                  | ✓ Yes ⚙ 設定可能 |
| 自動課金請求書の支払いを試みています                                              | ✓ はい                                                                                                          | ✗ 無効         |
| サブスクリプションの請求書下書きを確定し、請求可能にする                                    | ✓ Yes ⚙ 設定で変更可能 ([約 1 時間後](https://docs.stripe.com/billing/subscriptions/overview.md#subscription-lifecycle)) | ✗ 無効         |
| [Stripe による自動化](https://docs.stripe.com/billing/automations.md) | ✓ はい                                                                                                          | ✗ 無効         |

#### 凡例

- ✓ Yes = 設定に応じて有効化できます。
- ⚙ = 設定可能。
- ✗ Not enabled = 無効。請求書は自動的に移行しません。