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)
  • Prefix und Postfix bei den Nummernkreisen


Hier ist die Liste aller unterstützten Platzhalter für Bestellungen

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
{DeliveryHousenumber}
Hausnummer aus der Lieferadresse
{DeliveryStreet}
Straße aus der Lieferadresse
{DeliveryFullStreet}
Straße und Hausnummer aus der Lieferadresse
{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
{CustomerPriceGroupName}
Name der Preisgruppe, welcher der Kunde zugeordnet ist. Wenn keine Preisgruppe zugeordnet ist, wird 'keine Preisgruppe' ausgegeben.
{PriceGroupApplied}{/PriceGroupApplied}
Bereichsmarker. Alles was zwischen den Markern steht, wird nur ausgegeben, wenn der Kunde einer Preisgruppe zugeordnet ist.
{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
{InvoiceHousenumber}
Hausnummer aus der Rechnungsadresse
{InvoiceStreet}
Straße aus der Rechnungsadresse
{InvoiceFullStreet}
Straße und Hausnummer aus der Lieferadresse
{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, wenn keine Anrede eingelesen wird: Sehr geehrte Damen und Herren. Wenn Anrede übermittelt wird: Sehr geehrte Frau XX. (Möglich bei Jimdo, Rakuten, Hood, Idealo, EPages, Real & Shopware)
{InvoiceSalutation}Anrede Rechnung (Herr/ Frau)
{LegalText:agb}Über die Schnittstelle für Rechtstexte eingelesene AGB der jeweiligen Plattform
{LegalText:datenschutz}
Über die Schnittstelle für Rechtstexte eingelesene Datenschutzbedingungen der jeweiligen Plattform
{LegalText:widerruf}
Über die Schnittstelle für Rechtstexte eingelesene Widerrufsbelehrung der jeweiligen Plattform
{OfferNumber}
Angebotsnummer
{OrderCommitNumber}
Auftragsbestätigungsnummer
{OrderDate}
Bestelldatum
{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
{SoldArticlesWithoutSku}
Liste der verkauften Artikel mit Anzahl ohne SKU
{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
{TotalSumNoCurrency}Gesamtsumme der Bestellung ohne 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
{LatestTrackingNumber}neueste Sendungsnummer, falls vorhanden
{TrackingLink}
Liste der Links zur Sendungsverfolgung, falls vorhanden
{LatestTrackingLink}neuester Link zur Sendungsverfolgung, falls vorhanden
{TrackingNumberAvailable} {/TrackingNumberAvailable}
Bereichsmarker. Alles was zwischen den Markern steht, wird nur ausgegeben, wenn mindestens eine Sendungsnummer vorhanden ist.
{TrackingLinkAvailable}
{/TrackingLinkAvailable}
Bereichsmarker. Alles was zwischen den Markern steht, wird nur ausgegeben, wenn mindestens ein Link zur Sendungsverfolgung vorhanden ist.
{OrderWeight}
Gewicht in Kg als Zahl, das in der Bestellung eingetragen ist
{YY} {YYYY} {MM} {DD}Aktuelles Datum. YYYY oder YY für das Jahr, MM für den Monat und DD für den Tag. Hier alle in Großbuchstaben. 
Platzhalter zum Formatieren von Datumsfeldern findest du weiter unten. 


Hier ist die Liste aller unterstützten Platzhalter für Artikel

PlatzhalterBeschreibung
{SKU}Die SKU des Artikels
{Id}Die Billbee ID des Artikels
{Title}Der Titel des Artikels
{InvoiceText}Inhalt aus dem Feld 'Rechnungstext überschreiben' eines Artikels
{StockCurrent}Der aktuelle Bestand des Artikels (mit Komma als Dezimaltrenner)
{Price}Der aktuelle Preis des Artikels (mit Komma als Dezimaltrenner)
Platzhalter zum erzeugen einer eigenen Positionsliste (z.B. Auftragsbestätigung)
{SoldArticlesLoop}
...
{/SoldArticlesLoop}
Alles zwischen diesen beiden Platzhaltern wird pro Artikel wiederholt.
Platzhalter, welche du innerhalb diesen Bereichs verwendest, beziehen sich auf die jeweilige Bestellposition. {SKU} gibt z.B. die entsprechende SKU des Artikels der Bestellposition aus.

Zu den bereits in dieser Tabelle oben stehenden Platzhaltern, stehen dir noch folgende Platzhalter zur Verfügung:
{Index}
Gibt einen Zähler aus, welcher bei 1 startet und pro Position um 1 erhöht wird. (Nützlich falls du deine Positionen durchnummerieren möchtest)
{SinglePrice}
Einzelpreis der Position mit Währung
{TotalPrice}
Gesamtpreis der Position mit Währung
{Quantity}
Bestellte Menge




Formatieren von Datumsfeldern

Du kannst jedes Datumsfeld 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

Wichtig: Du musst die Gross-/Kleinschreibung unbedingt beachten. 



PlatzhalterBeschreibung
{datumsFeld:yyyy}
Jahr (vierstellig)
{datumsFeld:yy}
Jahr (zweistellig)
{datumsFeld:MM}
Monat
{datumsFeld:dd}
Tag
{datumsFeld:KW}
Kalenderwoche


Zeitversatz von Datumsfeldern

Du kannst jedes Datumsfeld zeitlich nach vorn oder hinten verschieben.
Hierfür musst Du einfach die Anzahl von Stunden und/oder Tagen vom Datumsfeld abziehen.

Um z.B. das Versanddatum um einen Tag und 4 Stunden in die Zukunft zu verschieben, musst du folgenden Platzhalter angeben  {ShipDate+4h+1d}.
Hierbei muss zuerst die Anzahl der Stunden (h) angegeben werden, falls vorhanden und erst danach die Anzahl der Tage (d).
Um das Versanddatum um einen Tag in die Vergangenheit zu verschieben, musst Du folgenden Platzhalter angeben {ShipDate-1d}.
Willst Du einen Zeitversatz vornehmen UND das Datumsfeld formatieren, musst Du zuerst den Zeitversatz angeben und erst dann das Datumsformat.
Beispiel: {ShipDate-1h:dd.MM.yy hh:mm:ss}


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.