So funktionieren Angebote
Erfahren Sie mehr über den Lebenszyklus von Angeboten.
Notiz
Sie können Angebote in einer Sandbox verwenden. Um im Live-Modus Angebote für einmalige Rechnungen über die API oder das Dashboard finalisieren, herunterladen oder annehmen zu können, müssen Sie ein Upgrade auf Invoicing Plus durchführen. Finden Sie heraus, welcher Plan der Richtige für Sie ist.
Mit Angeboten können Sie einen ungefähren Preis für angeforderte Waren oder Dienstleistungen angeben und die Verhandlungen vor Beginn eines Abonnements oder einer Rechnung vereinfachen.
Wir haben die Angebotsstatus so konzipiert, dass sie einen typischen Angebotsablauf widerspiegeln, dem ein/e Vertriebsmitarbeiter/in folgt: Er/sie erstellt Angebot mit Einzelposten, welche die zum Kauf angebotenen Artikel angeben. Dies umfasst auch eventuell angewendete Rabatte oder Steuern, das Absenden des Angebots an eine/n potenzielle/n Kund/in und die Bereitstellung der entsprechenden Dienstleistungen nach der Annahme.
| Status | Beschreibung | Mögliche Maßnahmen |
|---|---|---|
draft | Ausgangsstatus für alle Angebote – das Angebot kann zu diesem Zeitpunkt noch bearbeitet werden. | Finalisieren Sie das Angebot, damit es in den Status open übergeht oder stornieren Sie es. |
open | Dias Angebot wurde finalisiert und erwartet jetzt eine Aktion des/der Kund/in – das Ablaufdatum kann nur zum jetzigen Zeitpunkt bearbeitet werden. | Markieren Sie das Angebot als accepted oder stornieren Sie es. |
accepted | Der/die Kund/in hat das Angebot angenommen. Das Angebot erstellt eine Rechnung, ein Abonnement oder einen Abonnementplan. | k.A. |
canceled | Dieses Angebot ist abgelaufen oder wurde storniert. Sie können es nicht länger annehmen. | k.A. |
Stornierte Angebote
Wenn ein/e Kund/in ein Angebot ablehnt oder Sie möchten, dass es seine Gültigkeit verliert, können Sie es stornieren. Stornierte Angebote können nicht mehr angenommen werden. Angebote, die sich im Status draft oder open befinden, werden bei Erreichen des Ablaufdatums automatisch storniert und Stripe erstellt den Webhook quote..
Angenommene Angebote
Nachdem der/die Kund/in Ihr Angebot angenommen hat, können Sie es dementsprechend markieren. Angenommene Angebote generieren automatisch eine Rechnung, ein Abonnement oder einen Abonnementplan, je nachdem, ob das Angebot wiederkehrende Preise enthält oder nicht bzw. ob das Datum des Inkrafttretens in der Zukunft liegt.
Wechsel innerhalb des Ablaufs
Angebote können zwischen den folgenden Status hin- und herwechseln:
| Status | API-Endpunkt | Ausgegebener Webhook | Endstatus |
|---|---|---|---|
draft | POST /v1/quotes/:id/cancel | quote. | canceled |
draft | POST /v1/quotes/:id/finalize | quote. | open |
open | POST /v1/quotes/:id/cancel | quote. | canceled |
open | POST /v1/quotes/:id/accept | quote. | accepted |
Angebotsentwürfe finalisieren
Angebote werden zunächst als draft erstellt. In diesem Status können Sie das Angebot bearbeiten und ggf. Änderungen vornehmen. Sie können ein Angebot finalisieren, sobald Sie es an den/die Kund/in senden möchten. Dadurch geht es in den Status open über, während Sie auf eine Aktion von ihm/ihr warten.
Beim Finalisieren eines Angebots wird ihm auch eine number zugewiesen. Diese Nummer besteht aus vier Teilen: dem Präfix QT, dem Rechnungspräfix des/der Kund/in, der Angebotssequenz und der Revisionssequenz. QT-68BB114-0001-1 zum Beispiel ist das erste Angebot für eine/n Kund/in und das Angebot wird zum ersten Mal überarbeitet. Angebotsnummer QT-68BB114-0001-2 ist das gleiche Angebot, befindet sich jedoch in der zweiten Überarbeitung. QT-68BB114-0002-1 wäre das zweite Angebot für den/die Kund/in.
Im folgenden Beispiel sehen Sie, wie Sie ein Angebot über die API finalisieren können.
Angebot annehmen
Sie können ein Angebot nur dann als angenommen markieren, wenn es sich im Status open befindet. Dadurch geht das Angebot in den Status accepted über und die Rechnung, das Abonnement oder der Abonnementplan wird erstellt.
Hat das Angebot keinen wiederkehrenden Preis für einen seiner Einzelposten, wird ein Rechnungs-draft anhand des Angebots erstellt und auto_ ist auf false festgelegt. Bevor Sie die Rechnung finalisieren und zur Zahlung an Ihre/n Kund/in senden, können Sie Änderungen an ihr vornehmen.
Hat das Angebot mindestens einen wiederkehrenden Preis für einen Einzelposten, wird ein Abonnement oder ein Abonnementplan erstellt. Ein Abonnementzeitplan wird erstellt, wenn das Datum des Inkrafttretens des Angebots in der Zukunft liegt, ansonsten wird ein Abonnement erstellt. Die erste Rechnung des Abonnements befindet sich im Status draft und auto_ ist auf true festgelegt.
Im Dashboard können Sie ein Angebot über die Schaltflächen In Rechnung umwandeln und In Abonnement umwandeln auf der Angebotsdetailseite als angenommen markieren. Im folgenden Beispiel sehen Sie, wie Sie ein Angebot über die API als angenommen markieren können.
Angebot stornieren
Sie können ein Angebot stornieren, wenn sein Status draft oder open ist. Stornieren Sie ein Angebot über das Dashboard auf der Angebotsdetailseite oder über die API-Integration, wie das folgende Beispiel zeigt.
Angebot als PDF herunterladen
Die PDF-Methode funktioniert anders als die meisten SDK-Methoden, die Sie gewöhnt sind, die Daten normalerweise im JSON-Format zurückgeben. Die PDF-Methode hat ein spezielles Ausgabeformat.
Sie gibt direkt einen Datenstrom zurück, der die Byte-Sequenzen der eingehenden Daten darstellt.
Anstatt zu warten, bis der gesamte Datensatz geladen ist, bevor er verfügbar wird, können die Byte-Sequenzen beim Dateneingang in Blöcken oder Segmenten gelesen werden.
Diese Methode ist besonders nützlich für den Umgang mit großen Datenmengen oder für die Datenverarbeitung in Echtzeit, da Sie mit der Verarbeitung eingehender Daten beginnen können, bevor alle Daten vorhanden sind.