Platzhalter

Platzhalter sind Variablen, die an verschiedensten Stellen in Billbee eingesetzt werden können. Mithilfe der Platzhalter kannst du automatisch konkrete Werte aus bspw. einer Bestellung oder eines Kunden in deinen Text in Auftragsdokumenten oder Benachrichtigungstexten einsetzen.

Platzhalter für...

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
{CarrierName} Name des Versanddienstleisters
{Company} Firmenname des Käufers
{CompanyOrBuyerName} Firmenname oder vollständiger 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 in der Lieferadresse (Prof., Dr.,...)
{DeliveryFormalSalutation} Formelle Anrede der Lieferadresse: Sehr geehrter Herr / Sehr geehrte Frau
{DeliverySalutation} Anrede Lieferadresse: Frau bzw. 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} Bereichsmarker: umschließt einen Textblock, der nur ausgegeben wird, wenn der Bestellung mindestens ein Download Artikel zugeordnet ist
{Email} E-Mail-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 Rechnungsadresse
{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"
 {InvoiceOrDeliveryAddressAddressAddition} Adresszusatz einer Bestellung
{InvoiceDownloadUrl} Downloadlink der Rechnung
{InvoiceTitle} Titel aus der Rechnungsanschrift (Prof., Dr.,...)
{InvoiceFormalSalutation} Formelle Anrede der Rechnung
1. wenn keine Anrede eingelesen wird: Sehr geehrte Damen und Herren.
2. 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
{OfferDate} Angebotsdatum
{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 (PayPal)
{PaymentReference} Eine Zahlungsreferenz aus dem Shop (sofern unterstützt)
{Phone1} Telefonnummer des Kunden Feld 1
{Phone2} Telefonnummer des Kunden Feld 2
{Platform} Plattform (z.B. Amazon, Ebay, Etsy,...)
{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 mit SKU und Anzahl
{SoldArticlesSkuOnlyMultiline} Liste der verkauften Artikel nur mit SKU und Anzahl mehrzeilig
{SoldArticlesWithoutSku} Liste der verkauften Artikel mit Anzahl aber ohne SKU
{SoldArticlesSkuOnlyWithoutAmount} Liste der verkauften Artikel mit SKU aber ohne Anzahl
{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
{PackageType} Name des selbst definierten Verpackungstyps, z.B. "Paket klein"
{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 (unbedingt auf Großschreibung achten!)
weitere Platzhalter zum Formatieren von Datumsfeldern findest du weiter unten.

Platzhalter für Artikel

Platzhalter Beschreibung
{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}
Bereichsmarker: Alles zwischen diesen beiden Platzhaltern wird pro Artikel wiederholt.
Platzhalter, welche du innerhalb dieses Bereichs verwendest, beziehen sich auf die jeweilige Bestellposition. {SKU} gibt z.B. die entsprechende SKU des Artikels der Bestellposition aus.
{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

Platzhalter für Datumsfelder

Du kannst jedes Datumsfeld nach deinen Wünschen individualisieren. Hierfür gibst du den Platzhalter sowie das gewünschte Format getrennt durch einen Doppelpunkt an. Um bspw. das Versanddatum nur mit Tag und Monat auszugeben, kannst du folgenden Platzhalter nutzen:  {ShipDate:dd.MM}.

Platzhalter Beschreibung
{datumsFeld:yyyy} Jahr (vierstellig)
{datumsFeld:yy} Jahr (zweistellig)
{datumsFeld:MM} Monat
{datumsFeld:dd} Tag
{datumsFeld:KW} Kalenderwoche
Wichtig: Achte immer auf die Groß- und Kleinschreibung!

Du kannst auch jedes Datumsfeld zeitlich vor oder nach hinten verschieben. Um einen Zeitversatz von dem Datumsfeld zu erhalten, musst du einfach die Anzahl von Stunden und/oder Tagen vom dem Datumsfeld subtrahieren bzw. addieren. Hier ein paar Beispiele:

Was möchtest du machen? korrekter Platzhalter Hinweis
Versanddatum einen Tag in die Vergangenheit schieben {ShipDate-1d}
Versanddatum um einen Tag und 4 Stunden in die Zukunft schieben
{ShipDate+4h+1d}
immer erst die Anzahl der Stunden angeben - sofern benötigt - und erst danach die Anzahl der Tage
Zeitversatz vornehmen UND das Datumsfeld formatieren {ShipDate-1h:dd.MM.yy hh:mm:ss} immer erst den Zeitversatz vornehmen und dann das Datumsformat anpassen

Anwendungsbeispiel

Du hinterlegst z.B. folgenden Benachrichtigungstext, der dann automatisch per Regel gesendet wird, wenn die Bestellung als "verschickt" markiert wurde:

Hallo {BuyerFirstname},

Gute Nachrichten! Die Bestellung ist gepackt und macht sich in Kürze auf den Weg. Deine Rechnung 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 und viel Spaß mit deinem Einkauf,
Max Mustermann Shop

Der Kunde erhält dann folgende Benachrichtigung:

Hallo Johanna,

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

{TrackingNumberAvailable} Ab morgen sollte man die Sendung unter folgendem Link verfolgen können: http://Musterlink-Zur-Sendungsverfolgung.de/suche1234567890
Die Sendungsnummer lautet: 123456789 {/TrackingNumberAvailable}

Schöne Grüße und viel Spaß mit deinem Einkauf,
Max Mustermann Shop

Wurde deine Frage beantwortet? Vielen Dank für dein Feedback Bei der Übermittlung deines Feedback gab es Probleme, bitte probiere es erneut.