Einführung

Platzhalter sind Variablen, die man in diversen Texten einsetzen kann und die dann bei der Verwendung des Textes durch einen konkreten Wert aus einer Bestellung / Rechnung oder aus einem Kunden ersetzt werden.

An diesen Stellen werden Platzhalter unterstützt:


  • Rechnungslayout (Feld Referenz und alle freien Textfelder)
  • Benachrichtigungstexte (Betreff und Nachrichteninhalt)
  • Kundenportal (Begrüßungstext und Wasserzeichen)
  • Versandeinstellungen (Feld Referenz zur Ausgabe auf dem Label)


Hier ist die Liste aller unterstützten Platzhalter

Platzhalter
Beschreibung
{BuyerNickname}
Nickname des Käufers
{BuyerName}
Vollständiger Name des Käufers
{BuyerFirstname}
Vorname des Käufers
{BuyerLastname}
Nachname des Käufers
{Company}
Firmenname des Käufers
{CompanyOrBuyerName}
Firmenname oder voller Name des Käufers
{DeliveryName}
Vollständiger Name aus der Lieferadresse
{DeliveryFirstname}
Vorname aus der Lieferadresse
{DeliveryLastname}
Nachname aus der Lieferadresse
{DeliveryAddress}
Komplette Lieferadresse des Auftrages
{DeliveryZip}
Postleitzahl aus der Lieferadresse
{DeliveryCity}
Stadt aus der Lieferadresse
{DeliveryCountry}
Land aus der Lieferadresse
{DeliveryNoteNumber}
Lieferscheinnummer
{DeliveryTitle}Titel Lieferadresse (Prof., Dr.,...)
{DeliveryFormalSalutation}Formelle Anrede Lieferadresse Sehr geehrter Herr / Sehr geehrte Frau
{DeliverySalutation}Anrede Lieferadresse : Frau/ Herr 
{CurrentDate}
Aktuelles Tagesdatum
{CustomerNumber}
Kundennummer
{DiscountValue}
Der Gesamtrabatt einer Bestellung mit Währung.
{DiscountAvailable} {/DiscountAvailable}
Bereichsmarker. Alles was zwischen den Markern steht, wird nur ausgegeben, wenn die Bestellung einen Rabatt enthält.
{DocType}
Art des erzeugten Dokumentes (Rechnung, Lieferschein, ...)
{DownloadArticles}
Liste der verkauften Downloadartikel mit Anzahl und Preis
{DownloadUrl}
Url, über die der Kunde Zugriff auf das Kundenportal zu dieser Bestellung hat
{DownloadArticleAvailable} {/DownloadArticleAvailable}
Umschließt einen Textblock, der nur ausgegeben wird, wenn der Bestellung mindestens ein Download Artikel zugeordnet ist
{Email}
Email-Adresse des Kunden
{Fax}
Faxnummer des Kunden
{VatId}
UST ID des Kunden
{InvoiceAddress}
Komplette Rechnungsadresse des Auftrages
{InvoiceZip}
Postleitzahl aus der Rechnungsadresse
{InvoiceCity}
Stadt aus der Rechnungsadresse
{InvoiceCountry}
Land aus der Rechnungsadresse
{InvoiceNumber}
Rechnungsnummer
{InvoiceDate}
Rechnungsdatum
{InvoiceOrCreditNote}
Der Text "Gutschrift" bzw. "Rechnung"
{InvoiceDownloadUrl}
Downloadlink der Rechnung
{InvoiceTitle}Titel Rechnungsanschrift (Prof., Dr.,...)
{InvoiceFormalSalutation}Formelle Anrede Rechnung: Sehr geehrter Herr / Sehr geehrte Frau
{InvoiceSalutation}Anrede Rechnung (Herr/ Frau)
{OfferNumber}
Angebotsnummer
{OrderCommitNumber}
Auftragsbestätigungsnummer
{OrderDate}
Bestelldatum
{YYYY}Jahr (Vierstellig)
{YY}Jahr (Zweistellig)
{MM}Monat
{DD}Tag
{KW}Kalenderwoche
{OrderId}
Die Bestell ID
{OrderRef}, {OrderNumber}
Bestellnummer
{OrderStateText}
Status der Bestellung
{PayBy}
Zahlart der Bestellung
{PayDate}
Zahldatum
{PaymentTransactionId}
Transaktions Id der ersten Zahlung, falls vorhanden (Pay Pal)
{PaymentReference}
Eine Zahlreferenz aus dem Shop (sofern unterstützt)
{Phone1}
Telefonnummer des Kunden Feld 1
{Phone2}
Telefonnummer des Kunden Feld 2
{Platform}
Platform (z.B. DaWanda)
{PrivateNote}
Der unter „Eigene Notizen zu der Bestellung“ hinterlegte Text
{SerialNumber}
Seriennummer aus einer Liste einfügen 
{SoldArticles}
Liste der verkauften Artikel mit Anzahl ohne Preis
{SoldArticlesWithPrices}
Liste der verkauften Artikel mit Anzahl und Preis
{SoldArticlesWithPricesMultiLine}
Liste der verkauften Artikel mit Anzahl und Preis mehrzeilig
{SoldArticlesSkuOnly}
Liste der verkauften Artikel nur SKU und Anzahl
{SoldArticlesSkuOnlyMultiline}
Liste der verkauften Artikel nur SKU und Anzahl mehrzeilig
{ShopName}
Name des Shops
{ShipCost}
Versandkosten
{ShipDate}
Versanddatum
{ShippingProductName}
Name des der Bestellung zugeordneten Versandproduktes.
{ShippingProviderName}
Name des der Bestellung zugeordneten Versandanbieters.
{ShippingProductAvailable} {/ShippingProductAvailable}
Bereichsmarker. Alles was zwischen den Markern steht, wird nur ausgegeben, wenn der Bestellung ein Versandprodukt zugeordnet ist.
{TotalSum}
Gesamtsumme der Bestellung mit Währung
{PaidSum}
Zahlungssumme der Bestellung mit Währung
{PaymentTypeName}
Name der Zahlart
{UnpaidSum}
Offener Betrag der Bestellung mit Währung
{UserName}
Der Benutzername des Käufers
{Tags}Die Tags als Text
{TrackingNumber}
Liste der Sendungsnummern, falls vorhanden
{TrackingLink}
Liste der Links zur Sendungsverfolgung
{TrackingNumberAvailable} {/TrackingNumberAvailable}
Bereichsmarker. Alles was zwischen den Markern steht, wird nur ausgegeben, wenn mindestens eine Sendungsnummer vorhanden ist.


Formatieren von Datumsfeldern

Du kannst das Datum auch nach eigenen Wünschen formatieren. Hierfür musst du den Namen des Platzhalters sowie das gewünschte Format des Datums mit einem Doppelpunkt getrennt angeben.

Um z.B. das Versanddatum nur mit Tag und Monat auszugeben kannst du folgenden Platzhalter angeben {ShipDate:dd.MM}.  Wäre das Versanddatum der 30.01.2018 würde somit 30.01 ausgegeben werden.

Eine Liste aller möglichen Format Platzhaltern findest du hier: https://msdn.microsoft.com/de-de/library/8kb3ddd4(v=vs.110).aspx



Anwendungsbeispiel

Man hinterlegt z.B. folgenden Benachrichtigungstext, der per Regel gesendet wird, wenn die Bestellung als "Verschickt" markiert wurde:


Hallo {BuyerFirstname},

Die Bestellung ist gepackt und macht sich in Kürze auf den Weg. Deine Rechung kannst du hier herunterladen: {DownloadUrl}

{TrackingNumberAvailable}
Ab morgen sollte man die Sendung unter folgendem Link verfolgen können:
{TrackingLink}
Die Sendungsnummer lautet: {TrackingNumber}
{/TrackingNumberAvailable}

Schöne Grüße.




Der Kunde erhält dann folgenden Text:


Hallo Johanna,

Die Bestellung ist gepackt und macht sich in Kürze auf den Weg. Deine Rechung kannst du hier herunterladen: https://www.billbee.de/dl/abcdefghijk

Ab morgen sollte man die Sendung unter folgendem Link verfolgen können:
http://Musterlink-Zur-Sendungsverfolgung.de/suche1234567890

Die Sendungsnummer lautet: 1234567890

Schöne Grüße.