# 見積もりを作成して送信する

見積もりを作成、送信、承認する方法をご紹介します。

> 見積もりは*サンドボックス* (A sandbox is an isolated test environment that allows you to test Stripe functionality in your account without affecting your live integration. Use sandboxes to safely experiment with new features and changes)で使用できます。API またはダッシュボードを使用して本番環境で 1 回限りの請求書の見積もりを確定、ダウンロード、承認するには、[Invoicing Plus](https://stripe.com/invoicing/pricing) にアップグレードする必要があります。どのプランが[お客様に適しているか](https://support.stripe.com/questions/how-to-access-quotes)をご覧ください。

# ダッシュボード

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

見積もりは、見込み顧客または既存の顧客に商品およびサービス一式のコストを示すために使用できます。見積もりは、1 回限りの*請求書* (Invoices are statements of amounts owed by a customer. They track the status of payments from draft through paid or otherwise finalized. Subscriptions automatically generate invoices, or you can manually create a one-off invoice)または*サブスクリプション* (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 は関連するすべての請求書とサブスクリプションを自動的に作成します。この共通ツールは多くのセールスワークフローで使用されています。

## 見積もりを作成する

Stripe ダッシュボードで見積もりを作成するには、以下の手順に従います。

1. [Billing タブ](https://dashboard.stripe.com/billing)に移動します。
1. **クイックアクション** > **見積もりを作成**をクリックします (または[見積もりエディター](https://dashboard.stripe.com/test/quotes/create)に直接移動します)。
1. **+ 新しい顧客を追加**を選択します。少なくとも、顧客の**名前**と**アカウントのメールアドレス**を入力してください。**顧客を追加**をクリックします。
1. **項目**で、商品を追加または選択します (クーポンを追加することもできます)。
1. 有効期限を選択します。
1. (オプション) メモを書き、カスタムのヘッダーとフッターを追加します。ヘッダーとフッターの将来のデフォルトテキストは、[見積もりテンプレート](https://dashboard.stripe.com/settings/billing/quote)で設定できます。
1. 見積もり PDF (生成された見積もり番号が表示される) をプレビューするには、**プレビューをダウンロードする** をクリックします。
1. **見積もりを確定**をクリックします。

見積もりを確定した後で、顧客に送信します。

1. 見積もりをダウンロードするには、**見積もりの詳細ページ** > **見積もり PDF** に移動します。
1. 外部のメールアドレスを使用して、顧客の確認用に PDF を送信します。

## 見積もりを承認済みとしてマークする

顧客が見積もりを承認したら、その見積もりを請求書またはサブスクリプションに変換し、請求を行います。

見積もり_「のみ」_に 1 回限りの価格が含まれている場合に、1 回限りの請求書を作成できます。

見積もりに 1 つ以上の継続的な価格が含まれる場合は、サブスクリプションにのみ変換できます。

### 見積もりを請求書に変換する

1. 見積もりを承認済みとしてマークし、請求書の下書きを作成するには、**請求書に変換** > **見積もりの詳細**に移動します。

1. 必要に応じて、[請求書エディター](https://dashboard.stripe.com/test/invoices/create)を使用して請求書の下書きを修正します。

1. 顧客に請求書をメールで送信するか、自動的に請求します。

### 見積もりをサブスクリプションに変換する

1. 見積もりエディターで顧客を選択し、継続価格の商品を作成または選択します。

1. 見積もりの詳細を入力して、**サブスクリプションを今すぐ開始**または**サブスクリプションの開始日をスケジュール**を選択します。

1. 見積もりを確定します。これにより、見積もりは**承認済み**としてマークされます。

1. **サブスクリプションに変換** > **見積もりの詳細**に移動します。

1. サブスクリプションの詳細を入力または修正して、**サブスクリプションを作成**をクリックします。

サブスクリプションをすぐに開始するようにスケジュール設定する場合、Stripe は初回の支払いに対する下書きの請求書とともに、有効なサブスクリプションを作成します。Stripe は、下書きの請求書を 1 時間後に自動的に確定します。それ以外の場合には、サブスクリプションはスケジュール設定された開始日に開始されます。Stripe はサブスクリプションの支払い条件に応じて、登録された顧客の決済手段で請求するか、顧客に請求書を送信して、支払いを回収します。


# API

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

見積もりは、見込み顧客または既存の顧客に商品およびサービス一式のコストを示すために使用できます。見積もりは、1 回限りの*請求書* (Invoices are statements of amounts owed by a customer. They track the status of payments from draft through paid or otherwise finalized. Subscriptions automatically generate invoices, or you can manually create a one-off invoice)または*サブスクリプション* (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 は関連するすべての請求書とサブスクリプションを自動的に作成します。この共通ツールは多くのセールスワークフローで使用されています。

## 顧客を作成する [サーバー側]

> #### Accounts v2 API を使用した顧客の表現
> 
> Accounts v2 API では、Connect ユーザーには一般提供され、その他の Stripe ユーザーには公開プレビューで提供されます。Accounts v2 プレビューの一部である場合は、コードで[プレビューバージョン](https://docs.stripe.com/api-v2-overview.md#sdk-and-api-versioning)を指定する必要があります。
> 
> Accounts v2 プレビューへのアクセスをリクエストするには、
> 
> ほとんどのユースケースでは、[Customer](https://docs.stripe.com/api/customers.md) オブジェクトを使用するのではなく、[顧客を顧客設定済みの Account オブジェクトとしてモデル化する](https://docs.stripe.com/accounts-v2/use-accounts-as-customers.md)ことをお勧めします。

見積もりを作成するには、見積もりに関連付ける顧客を表すオブジェクト ([Account](https://docs.stripe.com/api/v2/core/accounts/object.md#v2_account_object-configuration-customer) または [Customer](https://docs.stripe.com/api/customers/object.md)) が必要です。前者は顧客が設定したもの、後者は Customer オブジェクトです。顧客を作成したら、その ID をデータベースに保存して、後で見積もりの作成に使用できるようにします。

## 見積もりを作成する [サーバー側]

見積もりを作成するには、[customer_account](https://docs.stripe.com/api/quotes/create.md#create_quote-customer_account) または [customer](https://docs.stripe.com/api/quotes/create.md#create_quote-customer) と [line_items](https://docs.stripe.com/api/quotes/create.md#create_quote-line_items) を渡します。価格を使用して、ビジネスが提供するサービスをモデル化できます。見積もりで価格を使用するには、[商品カタログを設定する方法](https://docs.stripe.com/products-prices/overview.md)をご覧ください。

[Price (価格)](https://docs.stripe.com/api/quotes/create.md#create_quote-line_items-price) と [Quantity (数量)](https://docs.stripe.com/api/quotes/create.md#create_quote-line_items-quantity) を指定することで、ビジネスが提供するサービス/商品をそれぞれラインアイテムとして見積もりに追加できます。たとえば、ソフトウェアのインストールに対する 1 回限りのコンサルティング手数料を含む、月単位のソフトウェアライセンスの見積もりを作成するとします。見積もりには次の 2 つのラインアイテムが含まれます。

- 最初のラインアイテムは、1 ライセンスあたり月額ライセンス料金 100 USD の、5 件のソフトウェアライセンスを表しています。
- 2 番目のラインアイテムは、1 回限りのコンサルティング手数料、1000 USD を表しています。

新しく作成された見積もりは `draft` ステータスとなります。下書きの見積もりは、[ラインアイテム](https://docs.stripe.com/api/quotes/update.md#update_quote-line_items)を追加または削除して変更できます。

#### Accounts v2

```curl
curl https://api.stripe.com/v1/quotes \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d "customer_account={{CUSTOMERACCOUNT_ID}}" \
  -d "line_items[0][price]=price_CBb6IXqvTLXp3f" \
  -d "line_items[0][quantity]=5" \
  -d "line_items[1][price]=price_HGd7M3DV3IMXkC"
```

#### Customers v1

```curl
curl https://api.stripe.com/v1/quotes \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d "customer={{CUSTOMER_ID}}" \
  -d "line_items[0][price]=price_CBb6IXqvTLXp3f" \
  -d "line_items[0][quantity]=5" \
  -d "line_items[1][price]=price_HGd7M3DV3IMXkC"
```

## 見積もりを送信する [サーバー側]

見積もりを顧客に送る準備が整ったら、[見積もりを確定](https://docs.stripe.com/api/quotes/finalize.md)することで `open` 状態にできます。見積もりは特定の顧客を対象とするため、新しいステージに移行するには、見積もりに `Customer object` を関連付ける必要があります。

```curl
curl -X POST https://api.stripe.com/v1/quotes/qt_1HDGlYClCIKljWvsIGaAA06B/finalize \
  -u "<<YOUR_SECRET_KEY>>:"
```

見積もりを確定した後で、見積もりの概要が含まれた PDF をダウンロードできます。これをメールに添付して、顧客に送信します。

#### curl

```bash
curl https://files.stripe.com/v1/quotes/qt_1HDGlYClCIKljWvsIGaAA06B/pdf \
  -u <<YOUR_SECRET_KEY>>: \
  -G 
```

PDF に表示される見積もりに [header](https://docs.stripe.com/api/quotes/create.md#create_quote-header)、[footer](https://docs.stripe.com/api/quotes/create.md#create_quote-footer)、[description](https://docs.stripe.com/api/quotes/create.md#create_quote-memo) を設定することもできます。`header`、`footer`、`description` のデフォルト設定は、[見積もりテンプレート](https://dashboard.stripe.com/settings/billing/quote)で指定できます。顧客が見積もりを確認する間は、必ずステータスを `open` にしてください。

## 見積もりを承認済みとしてマークする [サーバー側]

顧客が見積もりに同意した後で、`accepted` 状態に進めます。これにより、(継続的な価格が設定されたラインアイテムを追加したかどうかに応じて) 請求書またはサブスクリプションが自動的に作成されます。1 回限りの支払いに対して見積もりを使用すると、Stripe は `draft` 状態の請求書を作成します。[顧客に送信](https://docs.stripe.com/invoicing/integration.md)するまでは請求書に変更を加えることができます。

```curl
curl -X POST https://api.stripe.com/v1/quotes/qt_1HDGlYClCIKljWvsIGaAA06B/accept \
  -u "<<YOUR_SECRET_KEY>>:"
```

## Optional: 見積もりをサブスクリプションに変換する [サーバー側]

見積もりを使用してサブスクリプションを作成するには、継続的な価格が設定されたラインアイテムを 1 つ以上追加する必要があります。これを追加することで、見積もりが `accept` 状態になるとサブスクリプションが確実に作成されます。見積もりの [recurring](https://docs.stripe.com/api/quotes/object.md#quote_object-recurring) パラメーターが `null` ではない場合、顧客が見積もりを承認した後で、Stripe はサブスクリプションまたはサブスクリプションスケジュールを作成します。

サブスクリプションをカスタマイズするには、[subscription_data](https://docs.stripe.com/api/quotes/create.md#create_quote-subscription_data) を使用して設定を指定できます。たとえば、サブスクリプションにトライアル期間を設定できます。トライアル日数を指定するには、[trial_period_days](https://docs.stripe.com/api/quotes/create.md#create_quote-subscription_data-trial_period_days) を設定します。

```curl
curl https://api.stripe.com/v1/quotes/qt_1HDGlYClCIKljWvsIGaAA06B \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d "subscription_data[trial_period_days]=7"
```

顧客の[決済情報](https://docs.stripe.com/payments/save-and-reuse.md?platform=checkout)は事前に回収できます。顧客にデフォルトの決済手段が登録されておらず、自動的に請求する予定の場合は、見積もりの [collection_method](https://docs.stripe.com/api/quotes/create.md#create_quote-collection_method) を `charge_automatically` に設定します。

Stripe は、`draft` 状態の最初の請求書を `auto_advance=true` に設定して、`active` なサブスクリプションを作成します。請求書は 1 時間後に自動的に確定され、それに従ってサブスクリプションのステータスが更新されます。

### 見積もりからサブスクリプションスケジュールを作成する

将来の日付でサブスクリプションを開始する場合は、[サブスクリプションスケジュール](https://docs.stripe.com/billing/subscriptions/subscription-schedules.md)を作成します。たとえば、翌月の 1 日にサブスクリプションを開始したい場合は、[effective_date](https://docs.stripe.com/api/quotes/create.md#create_quote-subscription_data-effective_date) を設定して、サブスクリプションスケジュールの開始日を指定します。

```curl
curl https://api.stripe.com/v1/quotes/qt_1HDGlYClCIKljWvsIGaAA06B \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d "subscription_data[effective_date]=1641013200"
```