Template-Variablen¶

Hier finden Sie eine Übersicht über die verfügbaren Variablen pro Anwendungsfall.

Zur Ausgabe von Variablen muss immer ein Dollar-Zeichen vorangestellt werden

Beispiel: $totalAmount

Templates (Dokumente und Kundencenter)¶

Anwendungsfall	Variablen	Einsatzbeispiel
Rechnung und Rechnungsversand: Hinweistext Reverse-Charge	ustid_reversecharge (USt-ID des Kunden)
Lastschrift (Hausbank): Rechnungstext	creditorIdentifier (Gläubiger ID) mandateNumber (Mandatsreferenz) mandateIssueDate (Datum Mandatserteilung) totalAmount (Abzubuchender Betrag) customerAccountOwner (Kontoinhaber Kunde) customerAccountIban (IBAN Kunde) directDebitDate (geplantes Abbuchungsdatum)	Wir buchen den Rechnungsbetrag in Höhe von $formatTool.currencyFormat($totalAmount, $invoice.currency) frühestens am $formatTool.dateFormat($directDebitDate), mit der Mandatsreferenz-Nr. $mandateNumber und unserer Gläubiger-ID $creditorIdentifier von Ihrem Konto ab.

E-Mail Texte¶

Anwendungsfall	Variablen	Einsatzbeispiel
Benachrichtigung über Rücklastschriften	chargebackprice_net (Bearbeitungsgebühr Rücklastschrift netto) chargebackprice_gross (Bearbeitungsgebühr Rücklastschrift brutto)	Formatierte Ausgabe Zahl + Währung: $formatTool.currencyFormat($chargebackprice_net.cost, $chargebackprice_net.currency)
Zustellung einer Mahnung	customer (Kundenobjekt für den von der Mahnung betroffenen Kunden) invoice (Die von der Mahnung betroffene Rechnung) dunningLevel (Mahnstufe bzw. Zählnummer der Mahnung (beginnend bei 1)) customText (Mahnstufen-spezifischer Text (aus der Mahnstufenverwaltung))
Userlogin für Kundencenter	kundencenterUrl (Vollständige URL zum Kundenportal z.B. https://meinprojekt.vertragscenter.com)
Vertrag aktivieren	account (Kundenkonto) contract (Vertrag) customer (Kunde) project (Projekt) order (Bestellung, falls vorhanden) subscriptionItems (Liste der gebuchten Aboartikel)

Die verfügbaren Attribute der einzelnen Entitäten z. B. für invoice oder customer finden Sie in der Sektion Schemas unserer REST-API-Dokumentation.

Velocity Scripting¶

Über die Scripting-Funktionalität haben Sie ein sehr mächtiges Werkzeug, um die Texte fallabhängig und ganz individuell zu gestalten. Da es sich um eine Standard-Skriptsprache handelt, ist die Einarbeitung relativ einfach.

Wir nutzen die Velocity Template Language (VTL).

→ Zur offiziellen Dokumentation

Sie haben ein komplexes Scripting-Szenario?

Fragen Sie uns unser Support-Team.
Wir unterstützen Sie bei Ihren Anpassungen.