Rechnungsposten gruppieren
Sie können Ihren Kundinnen und Kunden dabei helfen, Ihre Rechnungen (einschließlich PDFs, gehostete Rechnungsseite und Rechnungs-E-Mails) besser zu verstehen, indem Sie die Rechnungsposten in Kategorien unterteilen und in verschiedenen Gruppen anzeigen. Sie können auch Gruppen von Einzelposten ausblenden. Dies ist hilfreich, wenn einige Einzelposten übermäßig detailliert sind: Sie können sie so konfigurieren, dass nur die Zwischensumme auf Gruppenebene für Ihre Kundinnen/Kunden sichtbar ist.
In diesem Leitfaden wird beschrieben, wie Sie einmalige Rechnungen und Abonnementrechnungen organisieren, indem Sie dynamische Filter und Gruppen im Stripe-Dashboard erstellen.
Gruppieren Sie Rechnungsposten dynamisch mit CEL-Ausdrücken.
Nicht gruppierte Posten
Gruppierte Posten mithilfe von Übersichtsposten (ausgeblendete Gruppe „Red items“)
Bevor Sie beginnen
Um diese Funktion zu verwenden, definieren Sie Regeln und Vorlagen mit Common-Expression-Language-(CEL-)Ausdrücken. Um mehr über CEL zu erfahren, lesen Sie die Einführung. Dieser Leitfaden enthält einige Beispiele im Zusammenhang mit Rechnungsvorlagen. Wir empfehlen jedoch, die offizielle Definition der Sprache auf GitHub zu lesen. Sie können mit einem gängigen Use case beginnen.
Nur mit Billing Scale verfügbar
Für die Gruppierung von Rechnungsposten mit CEL sind Billing Scale-Preise erforderlich.
Einschränkungen
Diese Funktion weist einige Einschränkungen auf:
- Sie können CEL-Ausdrücke nur auf Rechnungen anwenden, die über das Dashboard erstellt wurden.
- Jeder CEL-Ausdruck hat eine maximale Länge von 1024 Zeichen.
- Eine Vorlage verfügt über maximal 10 Gruppierungsrichtlinien für Posten.
- Für jeden CEL-Ausdruck gilt eine Beschränkung der Erweiterungstiefe von 1. So wird beispielsweise
line_item.invoice_item.expand().description
unterstützt, aber nichtline_item.subscription.expand().default_payment_method.expand().type
. - CEL-Ausdrücke unterstützen nicht jedes Feld im Rechnungspostenobjekt in der öffentlichen API.
- Für CEL-Ausdrücke wird die API-Version
2022-11-15
als zugrunde liegende Ressource verwendet. Spätere API-Versionen und Vorschaufunktionen werden für die Dauer der Beta nicht automatisch unterstützt.
Rechnungsposten gruppieren
Sie können Rechnungsposten im Dashboard gruppieren. Wenn Sie die API verwenden möchten, können Sie auf der Registerkarte „API“ frühzeitigen Zugriff auf die Beta anfordern.
Use cases
In der folgenden Tabelle finden Sie einige gängige Beispiele für Gruppierungsrichtlinien.
Use case | Details und Beispiel |
---|---|
Metadaten nach Rechnungsposten gruppieren | Möglicherweise haben Sie einen vertriebsorientierten Prozess, der verschiedene Bestellnummern mit jedem Ihrer Rechnungsposten mit Metadaten namens „PO“ verknüpft. In diesem Beispiel werden mithilfe des Felds Gruppieren nach Gruppen für jede Bestellnummer erstellt und die Einzelposten aufgelistet, die dieser Bestellnummer in ihrem Metadatenfeld entsprechen. Gruppieren nach:
Filtern nach:
|
Nach Preis-Metadaten gruppieren | Möglicherweise möchten Sie Rechnungsposten nach den Preis-Metadaten gruppieren, um die Rechnung nach der Art des Preises zu gliedern, zu dem gekauft wurde. Die Rechnung wird entsprechend der von Ihnen in den Preis-Metadaten angegebenen Zeichenfolge Gruppieren nach:
Filtern nach:
|
Nach Anteilen gruppieren | Möglicherweise haben Sie viele anteilige Einzelposten in Ihrer Abonnementrechnung und möchten Ihre Rechnung für Kundinnen und Kunden vereinfachen. In diesem Beispiel werden Einzelposten mit einem anteiligen Betrag von mehr als 0 USD in der Gruppe „Gutschriften“ und negative Einzelposten in der Gruppe „Lastschriften“ zusammengefasst. Gruppieren nach:
Filtern nach:
|
Posten nach Beschreibung gruppieren | Alle nicht gruppierten Posten werden standardmäßig unter dem Abschnitt Sonstiges einer Übersicht gruppiert. Wenn Sie ansonsten nicht gruppierte Posten nach ihrer Beschreibung auflisten möchten, können Sie den Abschnitt Sonstiges unter einer Übersicht erweitern. Um zu verhindern, dass andere Gruppierungsrichtlinien außer Kraft gesetzt werden, stellen Sie sicher, dass dies das letzte Element in der Richtlinienliste ist. Gruppieren nach:
|