# So funktionieren Angebote Erfahren Sie, wie Sie Kunden/Kundinnen vor dem Start eines Abonnements oder einer Rechnung einen Kostenvoranschlag zur Verfügung stellen können. Angebote („Quotes“) ermöglichen es Ihnen, Ihren Kunden/Kundinnen einen Kostenvoranschlag für angefragte Waren oder Dienstleistungen zu unterbreiten. Sie können wiederkehrende und einmalige Posten kombinieren und Rabatte oder Steuern einschließen. Nachdem Ihr Kunde das Angebot akzeptiert hat, können Sie es in ein wiederkehrendes *Abonnement* (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) oder eine einmalige *Rechnung* (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) umwandeln. ## Angebote senden und annehmen Um Angebote für einmalige Rechnungen zu versenden und anzunehmen: 1. Melden Sie sich bei Ihrem Stripe-Dashboard an. 1. Auf der Seite [Ihre Pläne](https://dashboard.stripe.com/settings/plans?utm_source=docs-quotes) registrieren Sie sich für [Invoicing Plus](https://stripe.com/invoicing/pricing). Erfahren Sie mehr darüber [, indem Sie auf die Angebote](https://support.stripe.com/questions/how-to-access-quotes) zugreifen. ## Status der Angebote Angebote können zwischen den folgenden Status hin- und herwechseln: Wie sich der Status eines Angebots ändert (See full diagram at https://docs.stripe.com/quotes) | Status | Beschreibung | Mögliche Maßnahmen | | ---------- | ------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `draft` | Der Anfangsstatus für alle Angebote. Sie können die Rechnung noch bearbeiten, wenn sie sich im Status Entwurf befindet. | - [Schließen Sie](https://docs.stripe.com/quotes.md#finalize) das Angebot ab, um es in den Status `open` zu setzen. - [Stornieren Sie](https://docs.stripe.com/quotes.md#cancel) das Angebot, um es in den Status `canceled` zu versetzen. | | `open` | Das Angebot ist fertiggestellt und wartet auf die Bearbeitung durch die/den Kundin/Kunden. Sie können nur das Ablaufdatum bearbeiten. | - [Akzeptieren](https://docs.stripe.com/quotes.md#accept) Sie das Angebot, um es in den Status `accepted` zu versetzen. - [Stornieren Sie](https://docs.stripe.com/quotes.md#cancel) das Angebot, um es in den Status `canceled` zu versetzen. | | `accepted` | Die/Der Kunde/Kundin hat das Angebot angenommen. Das Angebot erzeugt eine Rechnung, ein Abonnement oder einen Abonnementplan. | k. A. | | `canceled` | Das Angebot ist abgelaufen oder wurde storniert. Sie können es nicht mehr annehmen. | k. A. | ### Entwurf eines Angebots fertigstellen Angebote werden zunächst als `draft` erstellt. In diesem Status können Sie das Angebot bearbeiten und alle erforderlichen Änderungen vornehmen. Sie können das Angebot fertigstellen, wenn Sie es an Ihre Kunden/Kundinnen senden möchten. Wenn Sie das Angebot abschließen, wird ihm eine `number` zugewiesen. Die Nummer besteht aus vier Teilen: - Das Präfix `QT` - Präfix für die Rechnung der/des Kunden/Kundin - Die Reihenfolge der Angebote - Die Reihenfolge der Überarbeitung Zum Beispiel ist `QT-68BB114-0001-1` das erste Angebot für eine Kundin/einen Kunden, und das Angebot befindet sich in der ersten Überarbeitung. Die Angebotsnummer `QT-68BB114-0002-2`ist das gleiche Angebot, aber in der zweiten Überarbeitung. `QT-68BB114-0001-2` ist das zweite Angebot für eine/n Kundin/Kunden. Sie können die API verwenden, um ein Angebot abzuschließen, wie im folgenden Beispiel gezeigt: ```curl curl -X POST https://api.stripe.com/v1/quotes/qt_1HDGlYClCIKljWvsIGaAA06B/finalize \ -u "<>:" ``` Angebote können vom Status `draft` in einen der folgenden Endstatus übergehen: - `open`: Der API-Endpoint [POST /v1/quotes/:id/finalize](https://docs.stripe.com/api/quotes/finalize.md) sendet einen `quote.finalized`-Webhook. - `canceled`: Der API-Endpoint [POST /v1/quotes/:id/cancel](https://docs.stripe.com/api/quotes/cancel.md) sendet einen `quote.canceled`-Webhook. ### Ein Angebot annehmen Nachdem Ihr/e Kunde/Kundin dem Angebot zugestimmt hat, können Sie das `open` Angebot als `accepted` markieren. Akzeptierte Angebote erzeugen automatisch eine Rechnung, ein Abonnement oder einen Abonnementplan. - **Angebote mit wiederkehrenden Preisen**: Ein Abonnementplan wird erstellt, wenn das Gültigkeitsdatum des Angebots in der Zukunft liegt. Andernfalls wird ein Abonnement erstellt. Die erste Rechnung für das Abonnement befindet sich im Status `draft` mit `auto_advance` auf `true` eingestellt. - **Angebote ohne wiederkehrende Preise**: Eine `draft`-Rechnung wird erstellt, wobei `auto_advance` auf `false` eingestellt ist. Sie können die Rechnung ändern, bevor Sie sie abschließen und zur Zahlung an Ihre Kundinnen/Kunden senden. #### Dashboard Sie können das Dashboard verwenden, um ein Angebot als akzeptiert zu markieren. 1. Gehen Sie im Stripe-Dashboard auf die Seite [Angebote](https://dashboard.stripe.com/quotes). 1. Wählen Sie das Angebot, das Sie als akzeptiert markieren möchten. 1. Klicken Sie auf der Detailseite des Angebots auf **In Rechnung umwandeln** oder **In Abonnement umwandeln**. #### API Sie können die API verwenden, um ein Angebot als akzeptiert zu markieren, wie im folgenden Beispiel gezeigt: ```curl curl -X POST https://api.stripe.com/v1/quotes/qt_1HDGlYClCIKljWvsIGaAA06B/accept \ -u "<>:" ``` Wenn ein Angebot vom Status `open` in `accepted` übergeht, sendet der API-Endpoint [POST /v1/quotes/:id/accept](https://docs.stripe.com/api/quotes/accept.md) einen `quote.accepted`-Webhook. ### Ein Angebot stornieren Wenn Ihr/e Kundin/Kunde das Angebot ablehnt oder Sie nicht mehr möchten, dass es gültig ist, können Sie das Angebot stornieren. Markieren Sie dazu das Angebot des Typs `draft` oder `open` als `canceled`, oder warten Sie, bis diese Angebote automatisch storniert werden, wenn sie das Ablaufddatum erreichen. Sie können keine stornierten Angebote annehmen. #### Dashboard Sie können das Dashboard verwenden, um ein Angebot zu stornieren. 1. Gehen Sie im Stripe-Dashboard auf die Seite [Angebote](https://dashboard.stripe.com/quotes). 1. Wählen Sie das Angebot, das Sie stornieren möchten. 1. Klicken Sie auf der Detailseite des Angebots auf das Überlaufmenü (⋯) und dann auf **Angebot stornieren**. #### API Sie können die API verwenden, um ein Angebot zu stornieren, wie im folgenden Beispiel gezeigt: ```curl curl -X POST https://api.stripe.com/v1/quotes/qt_1HDGlYClCIKljWvsIGaAA06B/cancel \ -u "<>:" ``` Wenn ein Angebot vom Status `draft` oder `open` zu `canceled` übergeht, sendet der API- Endpoint [POST /v1/quotes/:id/cancel](https://docs.stripe.com/api/quotes/cancel.md) einen `quote.canceled`-Webhook. ## Angebot als PDF herunterladen Verwenden Sie die PDF-Methode, um [ein Angebot als PDF herunterzuladen](https://docs.stripe.com/api/quotes/pdf.md): ```curl curl https://files.stripe.com/v1/quotes/qt_0J1EnX589O8KAxCGEdmhZY3r/pdf \ -u "<>:" ``` Anstatt Daten im JSON-Format zurückzugeben, gibt die PDF-Methode einen Datenstrom zurück, der die Bytefolgen der eingehenden Daten darstellt. Der Bytestrom wird beim Eintreffen der Daten in Stücken oder Segmenten gelesen, so dass Sie mit der Verarbeitung der eingehenden Daten beginnen können, bevor der gesamte Datenstrom abgeschlossen ist. Diese Methode ist besonders nützlich für die Verarbeitung großer Datenmengen oder die Verarbeitung von Daten in Echtzeit. ![PDF mit Angebot](https://b.stripecdn.com/docs-statics-srv/assets/generated-quote-pdf.712c5fe734adfbfbc1a7efc136e00636.png) Die generierte Angebots-PDF