# Vorlagen zum Darstellen von Rechnungen Verwenden Sie Vorlagen zum Darstellen von Rechnungen, um das Erscheinungsbild Ihrer Rechnung für verschiedene Kundinnen/Kunden zu personalisieren Sie können den Inhalt Ihrer Rechnungen für bestimmte Kundengruppen anpassen. Beispiele könnten sein: - Anzeige eines bestimmten Textes im Fußzeilenfeld Ihrer Rechnung für Kundinnen/Kunden aus einem bestimmten Land - Anzeigen eines bestimmten Vermerks für Kundinnen/Kunden mit einem bestimmten Umsatzkanal - Gruppieren von Einzelposten in einer bestimmten Art und Weise für Kundinnen/Kunden mit komplexen Transaktionen In diesem Leitfaden wird beschrieben, wie Sie Vorlagen zur Darstellung von Rechnungen für Folgendes verwenden können: - Gemeinsame Werte für Rechnungsfelder speichern und wiederverwenden, anstatt sie für jede relevante Rechnung einzugeben - Speichern, verwalten und aktualisieren Sie die Rechnungsfeldwerte, die für große Kundengruppen gelten - Regeln für die Gruppierung von Posten konfigurieren, die nicht außerhalb von Rechnungsvorlagen festgelegt werden können - Passen Sie bei Abonnementrechnungen die Rechnungswerte an, ohne direkt mit der Rechnung zu interagieren ## Vorlagen zum Darstellen von Rechnungen einrichten Vorlagen zum Darstellen von Rechnungen können nur im Dashboard erstellt werden. Sie können sie nicht über die API erstellen. 1. Wählen Sie in Ihren Billing-Einstellungen die Registerkarte [Rechnungen > Vorlagen](https://dashboard.stripe.com/settings/billing/invoice-templates). 1. Klicken Sie auf **+ Vorlage erstellen**. 1. Geben Sie einen Namen für Ihre Vorlage ein. 1. Geben Sie Werte für die Felder an, die Sie in die Vorlage aufnehmen möchten. Rechnungsvorlagen unterstützen Vermerke, Fußzeilen und benutzerdefinierte Felder. 1. Optional können Sie [eine oder mehrere Einzelpostengruppen mithilfe von CEL-Ausdrücken (Common Expression Language)](https://docs.stripe.com/invoicing/group-line-items.md) definieren. 1. Um eine Vorschau Ihrer Vorlage anzuzeigen, geben Sie die ID einer geeigneten Rechnung in das Feld **Rechnungs-ID** des Vorschaubereichs ein. Alle Werte, die direkt auf dieser Rechnung festgelegt werden, haben jedoch Vorrang vor dem entsprechenden Vorlagenwert. Wenn diese Rechnung beispielsweise einen Fußzeilenwert hat, wird in der Vorschau die Fußzeile der Rechnung und nicht die Fußzeile der Vorlage angezeigt. ## Vorlagen zum Darstellen von Rechnungen auf Rechnungen anwenden #### Dashboard Im Dashboard können Sie eine Vorlage für Rechnungen auf folgende Weise anwenden: - Im Rechnungseditor - Im Abonnement-Editor, gilt für alle mit dem Abonnement verknüpften Rechnungen - In den Rechnungseinstellungen eines Kunden/einer Kundin, gilt für alle zukünftigen Rechnungen, die mit diesem Kunden/dieser Kundin verbunden sind #### API > #### Verwenden Sie die Accounts v2 API zum Darstellen von Kundinnen und Kunden > > Die Accounts v2 API ist für Connect-Nutzer/innen allgemein verfügbar und befindet sich für andere Stripe-Nutzer/innen in der öffentlichen Vorschau. Alle Stripe-Nutzer/innen können Accounts v2 [in ihrem Dashboard](https://dashboard.stripe.com/settings/connect/platform-setup) aktivieren. Nutzer/innen der Vorschau müssen bei Aufrufen der Accounts v2 API jedoch [eine Vorschauversion angeben](https://docs.stripe.com/api-v2-overview.md#sdk-and-api-versioning). > > Für die meisten Anwendungsfälle empfehlen wir, [Ihre Kundinnen und Kunden als vom Kunden bzw. von der Kundin konfigurierte Account-Objekte abzubilden](https://docs.stripe.com/connect/use-accounts-as-customers.md), anstatt das [Kundenobjekt](https://docs.stripe.com/api/customers.md) zu verwenden. #### Accounts v2 Mit der API können Sie eine Vorlage für Rechnungen auf folgende Weise anwenden: - When you create a draft invoice using the [Invoicing API](https://docs.stripe.com/api/invoices/create.md#create_invoice-rendering-template): ```curl curl https://api.stripe.com/v1/invoices \ -u "<>:" \ -d "customer_account={{CUSTOMERACCOUNT_ID}}" \ -d collection_method=send_invoice \ -d days_until_due=30 \ -d "rendering[template]=inrtem_xxx" ``` - When you create or update a customer-configured `Account`, use [configuration.customer.billing.invoice.rendering.template](https://docs.stripe.com/api/v2/core/accounts/object.md#v2_account_object-configuration-customer-billing-invoice-rendering-template) to apply a template to all future invoices associated with that customer, including subscription-generated invoices: ```curl curl -X POST https://api.stripe.com/v2/core/accounts \ -H "Authorization: Bearer <>" \ -H "Stripe-Version: $latestPreviewApiVersion" \ --json '{ "contact_email": "jenny.rosen@example.com", "display_name": "Jenny Rosen", "configuration": { "customer": { "billing": { "invoice": { "rendering": { "template": "inrtem_xxx" } } } } }, "include": [ "configuration.customer" ] }' ``` #### Customers v1 Mit der API können Sie eine Vorlage für Rechnungen auf folgende Weise anwenden: - When you create a draft invoice using the [Invoicing API](https://docs.stripe.com/api/invoices/create.md#create_invoice-rendering-template): ```curl curl https://api.stripe.com/v1/invoices \ -u "<>:" \ -d customer=cus_xxx \ -d collection_method=send_invoice \ -d days_until_due=30 \ -d "rendering[template]=inrtem_xxx" ``` - When you create or update a `Customer`, use [invoice_settings.rendering_options.template](https://docs.stripe.com/api/customers/create.md#create_customer-invoice_settings-rendering_options-template) to apply a template to all future invoices associated with that customer, including subscription-generated invoices: ```curl curl https://api.stripe.com/v1/customers \ -u "<>:" \ -d "name=Jenny Rosen" \ -d "invoice_settings[rendering_options][template]=inrtem_xxx" ``` Sie können die API nicht verwenden, um Rechnungsvorlagen direkt auf Abonnements, Abonnementpläne oder Angebote anzuwenden. Stattdessen können Sie eine Vorlage an einen Kunden/eine Kundin anhängen, um sie auf alle zukünftigen Rechnungen anzuwenden, die mit diesem Kunden/dieser Kundin verbunden sind, oder eine Vorlage auf Rechnungen anwenden, während sie sich im Entwurfsstatus befinden. ## Vorlagen überschreiben und aktualisieren Sie können Werte für Rechnungsfußzeilen, Vermerke und nutzerdefinierte Felder an mehreren Stellen konfigurieren. Wenn mehrere Werte auf ein Rechnungsfeld angewendet werden können, werden sie in der folgenden Reihenfolge, vom höchsten zum niedrigsten Wert, priorisiert: | Priorität | Einstellung | Methode | | -------------------------------------- | ------------------------------------------- | ------------------ | | 1 | Auf der Rechnung | Dashboard oder API | | Auf das Abonnement | Nur Dashboard | | 2 | Auf die Rechnung angewendetes Vorlage | Dashboard oder API | | Auf das Abonnement angewendete Vorlage | Nur Dashboard | | 3 | Dem Kunden/der Kundin beigefügte Vorlage | Dashboard oder API | | 4 | Rechnungseinstellungen für Kundinnen/Kunden | Nur API | | 5 | Rechnungseinstellungen für das Konto | Nur Dashboard | > Definierte Einstellungen für Rechnungen gelten immer, es sei denn, sie werden durch eine Einstellung mit höherer Priorität außer Kraft gesetzt. Wenn Sie zum Beispiel eine einmalige Rechnung für eine Kundin/einen Kunden erstellen möchten, die die angehängte Vorlage der Kundin/des Kunden überschreibt, müssen Sie entweder eine andere Vorlage auf die Rechnung anwenden oder die Rechnungswerte direkt festlegen. Wenn Sie eine Vorlage aktualisieren oder ersetzen, gelten die neuen Werte für alle zukünftigen Rechnungen, die mit dieser Vorlage verknüpft sind. Wenn Sie zum Beispiel einen Wert in der Vorlage eines Kunden/einer Kundin aktualisieren, gilt der neue Wert für alle zukünftigen Rechnungen für die bestehenden Abonnements dieser Kundin/dieses Kunden, es sei denn, die Vorlage für die Abos überschreibt ihn.