# 請求書を編集する

確定後の請求書を編集する方法をご紹介します。

*サブスクリプション* (A Subscription represents the product details associated with the plan that your customer subscribes to. Allows you to charge the customer on a recurring basis)に関連付けられている請求書を確定後に改訂することはできません。このタイプの請求書では、**請求書を編集**ボタンが無効になっています。

Stripe では、ステータスが `open` または `uncollectible` の確定済み請求書は改訂できます。ただし、ステータスが `void` または `paid` の請求書は改訂できません。請求書の改訂が考えられるのは、次のような場合です。

- 請求書の説明を編集する。
- 顧客を編集して、連絡先情報を更新する。
- ラインアイテムを追加、削除、または編集する。
- 割引を追加するか、税金を適用する。

内容やブランディングを変更する必要がある場合は、[請求書をカスタマイズ](https://docs.stripe.com/invoicing/customize.md)することもできます。

> 請求書の法令遵守プロセスは国によって異なる場合があります。たとえば、欧州連合 (EU) を拠点としている場合、元の請求書を改訂する代わりに、請求書を無効にしてクレジットノートを発行することができます。Stripe では、お客様のビジネスに固有のアドバイスについては、弁護士に相談することをおすすめしています。

# ダッシュボード

> This is a ダッシュボード for when testing-method is without-code. View the full page at https://docs.stripe.com/invoicing/invoice-edits?testing-method=without-code.

[ダッシュボード](https://dashboard.stripe.com/test/dashboard)を使用して、確定後の請求書を改訂できます。請求書を改訂して顧客に通知する方法、顧客のメールアドレスの更新方法、支払いの回収手段の変更方法などをご紹介します。

## 請求書を改訂して顧客に通知する

請求書を改訂して顧客に通知するには、次の手順を実行します。

1. **請求書の詳細**ページに移動して、**請求書を編集**をクリックします。**請求書エディター**が開き、新しい請求書の下書きが作成されます (改訂を中断した場合は、後で戻って下書きの編集を続行できます)。エディターの上部に、最後に送信された請求書を示す通知が表示されます。

   > [請求書ページ](https://dashboard.stripe.com/test/invoices)に移動して、オーバーフローメニュー (⋯) をクリックし、**請求書を編集**をクリックすることもできます。

1. エディターで、改訂するフィールドを更新します。請求書フィールドはすべて改訂可能ですが、顧客を切り替えたり、商品を変更することはできません。

1. **請求書を審査**をクリックして、顧客にメールで通知するかどうかを決定します。
![請求書の更新を顧客に通知する](https://b.stripecdn.com/docs-statics-srv/assets/invoice-revisions-notify-customer.68b421b920fc5e85f06d8a4acfbcc3ec.png)
   
   請求書の更新を顧客に通知する

1. **請求書を更新**をクリックすると、Stripe は新しい請求書を確定し、古いものを無効にします。エディターが閉じて、新しい請求書の詳細ページにリダイレクトされます。埋め込まれたタイムラインにすべての改訂版が表示されます。

**請求書の詳細**ページで、**履歴**セクションまで下に移動して、新旧の請求書を確認します。改訂が原因で Stripe が無効にした請求書をクリックすると、詳細ページに移動し、そこで改訂のタイムラインを確認できます。
![請求書の改訂履歴を表示する](https://b.stripecdn.com/docs-statics-srv/assets/invoice-revisions-history-section.79e3d40e3ae874352d91cb7478250647.png)

請求書の改訂履歴を表示する

## 顧客のメールアドレスを変更する

請求書に関連付けられているメールアドレスを更新するには、以下のようにします。

1. エディターで、**顧客**にある**編集**ボタン (✏) をクリックします。

1. **メールアドレス**フィールドを使用してメールアドレスを変更します。以前の受取人は、以前の請求書メールから引き続きこの請求書にアクセスできます。**顧客情報を更新**ダイアログを使用して、顧客のメールアドレスを変更することもできます。
![顧客のメールアドレスを更新する](https://b.stripecdn.com/docs-statics-srv/assets/invoice-revisions-update-email-address.abc3f10a991006065c5132fc6e1ec704.png)
   
   顧客のメールアドレスを更新する

1. **請求書を審査**をクリックした後に、**請求書を更新**をクリックします。**請求書を更新**ダイアログに、以前の (コピーされた) 顧客のメールアドレスも含め、以前の請求書に関連付けられているすべてのメールアドレスが表示されます。

## 支払いの回収方法を更新する

請求書を改訂して顧客に自動的に請求する場合は、**登録されている支払い方法に自動的に請求する**をクリックして、請求書を確認します。顧客に対する自動請求を先に進める前に、この変更を顧客が認識しているかどうかを確認するダイアログが表示されます。このダイアログでは、将来の参照のために内部メモを追加することもできます。

## 改訂版にリンクされた請求書の下書きを編集する

改訂版に関連付けられている請求書の下書きに戻る場合は、次の手順を実行します。

1. エディターを終了します。

1. 編集を再開する準備ができたら、**請求書の詳細**ページの**履歴**セクションの請求書の下書きをクリックするか、**請求書を編集**ボタンを使用します。Stripe が前回の未確定の変更を下書きに保存したことを示すダイアログが表示されます。

1. 下書きの編集を続行するか、新規作成するかを選択します。

## 顧客と改訂後の請求書

請求書を改訂して、顧客への通知を選択する場合は、以下のようにします。

1. Stripe は新しいメールを送信します。メールの件名には、更新が行われたことが示され、以前の請求書番号も記載されます。

1. 顧客がメールをクリックすると、新しい請求書番号が付けられた改訂後の請求書が表示されます。改訂後の請求書では、**以前のバージョン**セクションに以前の請求書が表示されます。顧客は、以前の請求書もすべて、PDF 形式で記録としてダウンロードできます。
![更新後の請求書のメール](https://b.stripecdn.com/docs-statics-srv/assets/invoice-revisions-customer-email.929ab2abffa15f996eedd5245543e36c.png)
   
   更新後の請求書のメール

Stripe は、**Older versions (以前のバージョン)** にすべての請求書のバージョンをリストします。最新のメールには関連する請求書の情報がすべて記載されているため、顧客は受信箱で以前の請求書を検索する必要はありません。顧客が以前のメールで**この請求書を支払う**をクリックした場合は、最新のオンライン請求書ページに自動的にリダイレクトされます。


# API

> This is a API for when testing-method is with-code. View the full page at https://docs.stripe.com/invoicing/invoice-edits?testing-method=with-code.

確定後の請求書の編集には、[API](https://docs.stripe.com/api/invoices.md) を使用できます。

## 請求書を改訂する

確定後の改訂プロセスを開始するには、`from_invoice` パラメーターを指定して[作成](https://docs.stripe.com/api/invoices/create.md)エンドポイントを使用します。このリクエストにより、元の請求書に関連付けられた新しい請求書の下書きが改訂版として作成されます。また、請求書に関連付けられている請求書のラインアイテムがすべて複製されます。ただし、請求金額が変更される可能性があるため請求書のクレジットノートは複製されません。また、このリクエストは、請求書の作成とは異なり、保留中の請求書アイテムを引き出しません。

> 金額、割引、顧客情報など、請求書の大部分のフィールドは、確定後、[更新](https://docs.stripe.com/api/invoices/update.md)エンドポイントを使用して編集することはできません。

```curl
curl https://api.stripe.com/v1/invoices \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d "from_invoice[invoice]={{ORIGINAL_INVOICE_ID}}" \
  -d "from_invoice[action]=revision"
```

`from_invoice` パラメーターを使用して請求書を作成するリクエストを送信すると、Stripe は以下のように応答します。

```json
{
  "id": "{{FIRST_REVISION_INVOICE_ID}}",
  "status": "draft",
  "from_invoice": {
    "invoice": "{{ORIGINAL_INVOICE_ID}}",
    "action": "revision",
  },
}
```

この新しい請求書の下書きには、次のようないくつかの例外を除き、元の請求書とほぼ同じフィールドが含まれています。

- 元の請求書を確定した後に、請求書の顧客を更新した場合、新しい請求書には更新された顧客情報が使用されます。[税金の自動計算](https://docs.stripe.com/tax/invoicing.md)を使用する場合、これによって税額の再計算が行われる可能性があります。
- 元の請求書に `auto_advance == true` が指定されていても、改訂請求書では false に設定されます。
- 改訂請求書の `starting_balance` と `amount_due` には、元の請求書に適用されているすべての[顧客残高](https://docs.stripe.com/invoicing/customer/balance.md)と、Customer オブジェクトで使用可能なすべての追加残高が反映されます。

ここでは、下書きの場合と同じように、請求書に変更を加えることができます。次の例では、請求書の説明を更新しています。

```curl
curl https://api.stripe.com/v1/invoices/{{FIRST_REVISION_INVOICE_ID}} \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d "description=Updated maintenance contract"
```

改訂後の請求書に新しいラインアイテムを追加するには、以下のようにします。

```curl
curl https://api.stripe.com/v1/invoiceitems \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d "customer={{CUSTOMER_ID}}" \
  -d invoice={{FIRST_REVISION_INVOICE_ID}} \
  -d "pricing[price]={{PRICE_ID}}" \
  -d quantity=100 \
  --data-urlencode "description=Additional Stripe swag!"
```

請求書の改訂では、顧客情報を更新して、確定された請求書の PDF とオンライン請求書ページに反映することができます。

```curl
curl https://api.stripe.com/v1/customers/{{CUSTOMER_ID}} \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d "name=John Doe"
```

必要な変更をすべて行ったら、改訂後の請求書を確定します。

```curl
curl -X POST https://api.stripe.com/v1/invoices/{{FIRST_REVISION_INVOICE_ID}}/finalize \
  -u "<<YOUR_SECRET_KEY>>:"
```

改訂後の請求書を確定すると、ステータスは `open` に変わり、`finalized_at` パラメーターが (元の請求書の `finalized_at` タイムスタンプではなく) 現在のタイムスタンプに設定されます。請求書を確定すると、Stripe は以下を実行します。

- 元の請求書を無効にします。
- 元の請求書に `latest_revision` パラメーターを追加します。

## 請求書の複数の改訂版

場合によっては、1 つの請求書に対して複数の改訂版を作成する必要があります。その場合のプロセスは最初の改訂で使用されるものと同じですが、Stripe が以前の改訂版すべての `latest_revision` パラメーターを更新する点が異なります。`latest_revision` パラメーターが更新されるのは、請求書の改訂版の作成時ではなく、確定時だけです。

```curl
curl https://api.stripe.com/v1/invoices \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d "from_invoice[invoice]={{FIRST_REVISION_INVOICE_ID}}" \
  -d "from_invoice[action]=revision"
```

`from_invoice` パラメーターを使用してリクエストを送信すると、次のようなレスポンスを受信します。

```json
{
  "id": "{{LATEST_REVISION_INVOICE_ID}}",
  "status": "draft",
  "from_invoice": {
    "invoice": "{{FIRST_REVISION_INVOICE_ID}}",
    "action": "revision",
  },
  # ... more fields
}
```

新しい請求書を確定して、改訂を完了します。

```curl
curl -X POST https://api.stripe.com/v1/invoices/{{LATEST_REVISION_INVOICE_ID}}/finalize \
  -u "<<YOUR_SECRET_KEY>>:"
```

元の請求書を取得しようとすると、その請求書が無効であることを示すレスポンスを受信します。Stripe は、最初の改訂版が確定されるとすぐに元の請求書を無効にします。

```json
{
  "id": "{{ORIGINAL_INVOICE_ID}}",
  "status": "void",
  "latest_revision": "{{LATEST_REVISION_INVOICE_ID}}", # This has changed from "{{FIRST_REVISION_INVOICE_ID}".
}
```

## 請求書の改訂に関する制約

Stripe は、請求書の改訂に対していくつかの制約を適用します。

- **請求書に設定できる下書きの改訂は最大で 1 つです**: 同じ `from_invoice[invoice]` パラメーターが指定された `draft` の請求書が別に存在しているときに、`/v1/invoices` エンドポイントに対して `POST` を実行すると、Stripe は 400 ステータスコードを返します。

- **open または uncollectible のステータスの請求書の改訂版のみを作成できます**: `/v1/invoices` エンドポイントに対して `POST` を実行し、`from_invoice[invoice]` が `open` または `uncollectible` 以外の状態の請求書に合致する場合、Stripe は 400 ステータスコードを返します。

- **請求書が open または uncollectible であるが、処理中の payment intent がある場合は、改訂版を作成または確定することはできません**: 支払いの試行が開始されたときに請求書のステータスが `paid` に更新されない支払い方法 (`us_bank_account` など) を顧客が使用している場合、Stripe は 400 ステータスコードを返します。

- **open または uncollectible の請求書に改訂版の下書きがある間に paid または void のステータスになった場合、あるいは処理中の payment intent がある場合、改訂を確定することはできません**: Stripe は、請求書の確定が発生し得るすべてのエンドポイント (`/v1/invoices/:id/finalize`、`/v1/invoices/:id/pay`、`/v1/invoices/:id/send` など) で 400 ステータスコードを使用してこれを適用します。

- **サブスクリプションに関連付けられている請求書は改訂できません**: サブスクリプション ID が設定されている請求書を確定後に編集することはできません。これらのタイプの請求書については、Stripe は、最初の請求書の後のすべての請求書に対して `invoice.created` Webhook を[確定の 1 時間前に](https://docs.stripe.com/billing/subscriptions/webhooks.md#understand)送信します。また、サブスクリプションのラインアイテムが含まれているスタンドアロンの請求書を編集することもできません。こうしたスタンドアロンの請求書は通常、保留中の比例配分のラインアイテムをプルすることによって作成されます。

- **クレジットノートがある請求書は改訂できません**: [クレジットノート](https://docs.stripe.com/api/credit_notes.md)がある請求書の改訂を作成することはできません。


## See also

- [ダッシュボードを使用する](https://docs.stripe.com/invoicing/dashboard.md)
- [API を実装する](https://docs.stripe.com/invoicing/integration.md)
- [オンライン請求書ページ](https://docs.stripe.com/invoicing/hosted-invoice-page.md)