# 見積もりの仕組み サブスクリプションまたは請求書を開始する前に、顧客に料金の見積もりを提示する方法をご紹介します。 見積もりを使用して、要求された商品またはサービスの価格を顧客に提示できます。継続および 1 回限りの項目を組み合わせることができるため、顧客に割引や税金を含めた見積もりを提供できます。顧客が見積もりを承認した後で、継続的な*サブスクリプション* (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)または 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)に見積もりを変換できます。 ## 見積もりを送信して受け付ける 1 回限りの請求書の見積もりを送信して受け付けるには: 1. Stripe ダッシュボードにログインします。 1. [プランページ](https://dashboard.stripe.com/settings/plans?utm_source=docs-quotes)で、[Invoicing Plus](https://stripe.com/invoicing/pricing) に登録します。 [見積もりへのアクセス](https://support.stripe.com/questions/how-to-access-quotes)についてもっと知る。 ## 見積もりステータス 見積もりは次のステータス間で移行できます。 見積もりステータスの変化 (See full diagram at https://docs.stripe.com/quotes) | ステータス | 説明 | 可能なアクション | | ---------- | -------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `draft` | すべての見積もりの開始ステータス。見積もりが下書きステータスの場合でも編集できます。 | - 見積もりを[確定](https://docs.stripe.com/quotes.md#finalize)して、`open` ステータスに移行します。 - 見積もりを[キャンセル](https://docs.stripe.com/quotes.md#cancel)して、`canceled` ステータスに移行します。 | | `open` | 見積もりは確定され、顧客によるアクションを待っています。編集できるのは有効期限のみです。 | - 見積もりを[承認](https://docs.stripe.com/quotes.md#accept)して、`accepted` ステータスに移行します。 - 見積もりを[キャンセル](https://docs.stripe.com/quotes.md#cancel)して、`canceled` ステータスに移行します。 | | `accepted` | 顧客が見積もりを承認しました。見積もりから、請求書、サブスクリプション、またはサブスクリプションスケジュールが生成されます。 | 該当なし | | `canceled` | 見積もりが期限切れまたはキャンセルされました。見積もりは承認できません。 | 該当なし | ### 下書きの見積もりを確定する 見積もりは最初に `draft` として作成されます。このステータスでは、見積もりを編集し、必要な変更を加えることができます。見積もりを顧客に送信する準備ができたら、確定できます。 見積もりを確定すると、見積もりに `number` が割り当てられます。番号は、次の 4 つの部分で構成されます。 - プレフィックス `QT` - 顧客の請求書プレフィックス - 見積もりシーケンス - 改訂シーケンス たとえば、`QT-68BB114-0001-1` は顧客の最初の見積もりで、見積もりは最初のリビジョンにあります。見積もり番号 `QT-68BB114-0001-2` は同じ見積もりですが、2 番目のリビジョンにあります。`QT-68BB114-0002-1` は顧客の 2 番目の見積もりです。 次の例に示すように、API を使用して見積もりを確定できます。 ```curl curl -X POST https://api.stripe.com/v1/quotes/qt_1HDGlYClCIKljWvsIGaAA06B/finalize \ -u "<>:" ``` 見積もりは `draft` ステータスから次のいずれかの最終ステータスに移行します。 - `open`: API エンドポイント [POST /v1/quotes/:id/finalize](https://docs.stripe.com/api/quotes/finalize.md) が `quote.finalized` Webhook を送信します。 - `canceled`: The API endpoint [POST /v1/quotes/:id/cancel](https://docs.stripe.com/api/quotes/cancel.md) emits a `quote.canceled` webhook. ### 見積もりを承認する 顧客が見積もりに同意した後、`open` の見積もりを `accepted` としてマークできます。承認済みの見積もりは、コンテキストに応じて請求書、サブスクリプション、またはサブスクリプションスケジュールを自動的に生成します。 - **継続価格の見積もり**: 見積もりの発効日が将来の日付である場合、サブスクリプションスケジュールが作成されます。それ以外の場合は、サブスクリプションが作成されます。サブスクリプションの最初の請求書は、`auto_advance` が `true` に設定された `draft` ステータスになります。 - **継続価格なしの見積もり**: `auto_advance` を `false` に設定した `draft` 請求書が作成されます。請求書を確定して決済のために顧客に送信する前に、請求書を変更できます。 #### ダッシュボード ダッシュボードを使用して、見積もりを承認済みとしてマークできます。 1. Stripe ダッシュボードで、[見積もり](https://dashboard.stripe.com/quotes)ページに移動します。 1. 承認済みとしてマークする見積もりを選択します。 1. 見積もりの詳細ページで、**請求書に変換**または**サブスクリプションに変換**をクリックします。 #### API 以下の例に示すように、API を使用して見積もりを承認済みとしてマークできます。 ```curl curl -X POST https://api.stripe.com/v1/quotes/qt_1HDGlYClCIKljWvsIGaAA06B/accept \ -u "<>:" ``` 見積もりが `open` ステータスから `accepted` ステータスに移行すると、API エンドポイント [POST /v1/quotes/:id/accept](https://docs.stripe.com/api/quotes/accept.md) は `quote.accepted` Webhook を送信します。 ### 見積もりをキャンセルする 顧客が見積もりを拒否した場合、または見積もりを有効にしたくない場合は、見積もりをキャンセルできます。キャンセルするには、`draft` または `open` の見積もりを `canceled` としてマークするか、有効期限に達したときにこれらの見積もりが自動的にキャンセルされるのを待ちます。キャンセル済みの見積もりを承認することはできません。 #### ダッシュボード ダッシュボードを使用して見積もりをキャンセルできます。 1. Stripe ダッシュボードで、[見積もり](https://dashboard.stripe.com/quotes)ページに移動します。 1. キャンセルする見積もりを選択します。 1. 見積もりの詳細ページで、オーバーフローメニュー (⋯) をクリックし、**見積もりをキャンセル**をクリックします。 #### API 次の例に示すように、API を使用して見積もりをキャンセルできます。 ```curl curl -X POST https://api.stripe.com/v1/quotes/qt_1HDGlYClCIKljWvsIGaAA06B/cancel \ -u "<>:" ``` 見積もりが `draft` または `open` のステータスから `canceled` ステータスに移行すると、API エンドポイント [POST /v1/quotes/:id/cancel](https://docs.stripe.com/api/quotes/cancel.md) から `quote.canceled` Webhook が送信されます。 ## 見積もり PDF をダウンロードする PDF メソッドを使用して[見積もり PDF をダウンロード](https://docs.stripe.com/api/quotes/pdf.md)します。 ```curl curl https://files.stripe.com/v1/quotes/qt_0J1EnX589O8KAxCGEdmhZY3r/pdf \ -u "<>:" ``` JSON 形式でデータを返す代わりに、PDF メソッドは、受信データのバイトシーケンスを表すデータストリームを返します。バイトストリームは、データストリームとしてチャンクまたはセグメントで読み込まれるため、データの読み込み全体が完了する前に受信データの処理を開始できます。この方法は、大容量のデータやリアルタイムのデータ処理に特に役立ちます。 ![見積もり PDF](https://b.stripecdn.com/docs-statics-srv/assets/generated-quote-pdf.712c5fe734adfbfbc1a7efc136e00636.png) 生成された見積もり PDF