Variablen

Variablen sind Platzhalter in Textinhalten, die Unusual Suite durch echte Werte ersetzt, wenn eine Vorlage verarbeitet oder ein Dokument generiert wird. Sie verwenden sie in E-Mail-Vorlagen, Rechnungen und Angeboten.

Wie Variablen funktionieren

Jede Variable ist mit dem Zeichen $ umschlossen – zum Beispiel $Company.Name$. Wenn die Vorlage verarbeitet wird, ersetzt Unusual Suite jeden Platzhalter durch den entsprechenden Wert. Die Ihnen zur Verfügung stehenden Variablen hängen von der jeweiligen Vorlage und den bei der Generierung verwendeten Daten ab.

Adressvariablen

Adressvariablen werden typischerweise als Teil einer größeren Komponente verwendet, wie z. B. $Company...$ oder $Invoice...$. Die Adressabschnitts-Platzhalter sind:

  • .Address.City$ — Stadt, z. B. 'Bamberg'
  • .Address.Country$ — Land, z. B. 'Deutschland'
  • .Address.PostalCode$ — Postleitzahl, z. B. '96052'
  • .Address.State$ — Bundesland oder Region, z. B. 'Bayern'
  • .Address.Street$ — Straße, z. B. 'Heiliggrabstraße 11c'
  • .Address$ — die vollständige Adresse

Variablen für Ihr Unternehmen

Diese Variablen verwenden die Daten Ihres Unternehmens. Sie können diese Daten unter 'Mein Konto' ⟶ 'Weitere Tools' ⟶ 'Daten Ihres Unternehmens' bearbeiten.

  • $Company.<Address>$ — Adresse Ihres Unternehmens (siehe Adressvariablen oben)
  • $Company.Iban$ — IBAN Ihres Unternehmens
  • $Company.Logo$ — Ihr Unternehmenslogo als Base64-Zeichenfolge (PNG oder JPG)
  • $Company.Name$ — Ihr Unternehmensname, z. B. 'Unusual Software GmbH'

Kontaktvariablen

  • $Contact.<Name>$ — der Name des Kontakts (siehe Namensvariablen unten)
  • $Contact.Owner.<Name>$ — der Name des Kontaktinhabers (siehe Namensvariablen unten)

Rechnungsvariablen

  • $Invoice.<Address>$ — Adresse des Empfängers (siehe Adressvariablen oben)
  • $Invoice.InvoiceNumber$ — die Kundennummer des Empfängers, entnommen aus der Organisation, falls vorhanden, andernfalls aus dem Kontakt, z. B. 'Org-0024'
  • $Invoice.Discount$ — Rabattbetrag, z. B. '34,56€'
  • $Invoice.DueDate$ — Fälligkeitsdatum, z. B. '30.11.2025'
  • $Invoice.<Contact>$ — Empfängerkontakt (siehe Kontaktvariablen oben)
  • $Invoice.GrossTotal$ — Bruttobetrag nach Rabatt und MwSt, z. B. '34,56€'
  • $Invoice.IntroductionHtml$ — Einleitungstext der Rechnung als HTML
  • $Invoice.NetTotal$ — Nettobetrag vor Rabatt und MwSt, z. B. '32,56€'
  • $Invoice.NetTotalAfterDiscount$ — Nettobetrag nach Rabatt und vor MwSt, z. B. '31,56€'
  • $Invoice.<Organization>$ — Empfängerorganisation (siehe Organisationsvariablen unten)
  • $Invoice.Owner.<Name>$ — Name des Rechnungsinhabers (siehe Namensvariablen unten)
  • $Invoice.PageFooter$ — Seitenfußzeilentext
  • $Invoice.PaymentTermsHtml$ — Zahlungsbedingungen als HTML
  • $Invoice.VAT$ — MwSt-Betrag, z. B. '3,56€'

Rechnungspositionsvariablen

  • $InvoiceLineItem.DescriptionHtml$ — Positionsbeschreibung als HTML
  • $InvoiceLineItem.Position$ — Position des Eintrags, z. B. '3'
  • $InvoiceLineItem.Quantity$ — Menge, z. B. '2,5'
  • $InvoiceLineItem.NetPricePerUnit$ — Nettopreis pro Einheit, z. B. '4,78€'
  • $InvoiceLineItem.NetPrice$ — gesamter Nettopreis für die Position, z. B. '40,78€'
  • $InvoiceLineItem.Product.ProductId$ — Produkt-ID, z. B. 'P-0098'

Namensvariablen

Namensvariablen werden typischerweise als Teil einer größeren Komponente verwendet, wie z. B. $Contact...$. Die Namensabschnitts-Platzhalter sind:

  • .Name.First$ — Vorname, z. B. 'Jane'
  • .Name.Last$ — Nachname, z. B. 'Doe'
  • .Name.Middle$ — zweiter Vorname, z. B. 'Ann'
  • .Name$ — vollständiger Name, z. B. 'Jane Ann Doe'

Organisationsvariablen

  • $Contact.Iban$ — die IBAN der Organisation
  • $Organization.Name$ — Organisationsname, z. B. 'Unusual Software GmbH'
  • $Contact.Owner.<Name>$ — Name des Kontaktinhabers (siehe Namensvariablen oben)

Projektvariablen

  • $Project.DescriptionHtml$ — Projektbeschreibung als HTML
  • $Project.Name$ — Projektname, z. B. 'Unusual Suite'
  • $Project.Owner.<Name>$ — Name des Projektinhabers (siehe Namensvariablen oben)

Angebotsvariablen

  • $Quote.<Address>$ — Adresse des Empfängers (siehe Adressvariablen oben)
  • $Quote.CustomerNumber$ — Kundennummer des Empfängers, entnommen aus der Organisation, falls vorhanden, andernfalls aus dem Kontakt, z. B. 'Org-0024'
  • $Quote.Discount$ — Rabattbetrag, z. B. '34,56€'
  • $Quote.ExpirationDate$ — Ablaufdatum, z. B. '30.11.2025'
  • $Quote.<Contact>$ — Empfängerkontakt (siehe Kontaktvariablen oben)
  • $Quote.GrossTotal$ — Bruttobetrag nach Rabatt und MwSt, z. B. '34,56€'
  • $Quote.IntroductionHtml$ — Einleitungstext des Angebots als HTML
  • $Quote.NetTotal$ — Nettobetrag vor Rabatt und MwSt, z. B. '32,56€'
  • $Quote.NetTotalAfterDiscount$ — Nettobetrag nach Rabatt und vor MwSt, z. B. '31,56€'
  • $Quote.<Organization>$ — Empfängerorganisation (siehe Organisationsvariablen unten)
  • $Quote.Owner.<Name>$ — Name des Angebotsinhabers (siehe Namensvariablen oben)
  • $Quote.PageFooter$ — Seitenfußzeilentext
  • $Quote.PaymentTermsHtml$ — Zahlungsbedingungen als HTML
  • $Quote.QuoteNumber$ — Angebotsnummer, z. B. 'Q-0014'
  • $Quote.VAT$ — MwSt-Betrag, z. B. '3,56€'

Angebotspositionsvariablen

  • $QuoteLineItem.DescriptionHtml$ — Positionsbeschreibung als HTML
  • $QuoteLineItem.Position$ — Position des Eintrags im Angebot, z. B. '3'
  • $QuoteLineItem.Quantity$ — Menge, z. B. '2,5'
  • $QuoteLineItem.NetPricePerUnit$ — Nettopreis pro Einheit, z. B. '4,78€'
  • $QuoteLineItem.NetPrice$ — gesamter Nettopreis für die Position, z. B. '40,78€'
  • $QuoteLineItem.Product.ProductId$ — Produkt-ID, z. B. 'P-0098'

Benutzervariablen

  • $User.<Name>$ — der Name des aktuell aktiven Benutzers (siehe Namensvariablen oben)

Weitere Variablen

  • $CurrentDate$ — das heutige Datum, z. B. '30.11.2025'
  • $HostName$ — Hostname des aktuellen Unusual Suite-Servers, z. B. 'ds-01.unusual-suite.com'
  • $Language$ — Spracheinstellung des aktuell aktiven Benutzers, z. B. 'en'