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 von Kund:innen in deinen Text in Auftragsdokumenten oder Benachrichtigungstexten einsetzen.
Platzhalter für...
Platzhalter für Bestellungen
| Platzhalter | Beschreibung |
| {BuyerNickname} | Nickname des/der Käufer:in |
| {BuyerName} | Vollständiger Name des/der Käufer:in |
| {BuyerFirstname} | Vorname des/der Käufer:in |
| {BuyerLastname} | Nachname des/der Käufer:in |
| {CarrierName} | Name des Versanddienstleisters |
| {Company} | Firmenname des/der Käufer:in |
| {CompanyOrBuyerName} | Firmenname oder vollständiger Name des/der Käufer:in |
| {CurrentTime} | Aktuelle Zeit im Format: HH:MM |
| {CustomerEoriNumber} | Eori Nummer des/der Käufer:in |
| {CustomerVatId} | VatId, welche in der Bestellung hinterlegt ist |
| {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 dem/der Kund:in 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. |
| {DistributionCountry} | Land, aus welchem die Bestellung versendet wird (Versandland) |
| {DocType} | Art des erzeugten Dokumentes (Rechnung, Lieferschein, ...) |
| {DownloadArticles} | Liste der verkauften Downloadartikel mit Anzahl und Preis |
| {DownloadUrl} | URL, über die die Kund:innen Zugriff auf das Kundenportal zu dieser Bestellung haben |
| {DownloadArticleAvailable} ...{/DownloadArticleAvailable} | Bereichsmarker: umschließt einen Textblock, der nur ausgegeben wird, wenn der Bestellung mindestens ein Download Artikel zugeordnet ist |
| {Email} | Standard E-Mail von Kund:innen (als Typ markiert) |
| {EmployeeName} | Mitarbeitername - wird nur dann ausgegeben, wenn die Bestellung dem Mitarbeiter zugewiesen ist, nicht wenn dieser lediglich eine Aktion ausführt. |
| {DefaultEmail} |
E-Mail Adresse (Standard) |
| {CommercialEmail} |
E-Mail Adresse (Kaufm. Dokumente) |
| {StatusUpdatesEmail} |
E-Mail Adresse (Status Änderungen) |
| {Fax} | Standard Fax von Kund:innen (als Typ markiert) |
| {VatId} | USt-ID, welche beim Kunden hinterlegt ist |
| {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, ePages, Kaufland.de & 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 |
| {MerchantVatId} |
Die in der Bestellung hinterlegte VAT-ID des Händlers |
| {OrderArticleCount} | Anzahl der Positionen einer Bestellung |
| {OfferDate} | Angebotsdatum |
| {OfferNumber} | Angebotsnummer |
| {OrderCommitNumber} | Auftragsbestätigungsnummer |
| {OrderDate} | Bestelldatum |
| {OrderId} | Die Bestell-ID |
| {OrderFax} |
Fax in Bestellungen |
| {OrderNetAmount} | Nettogesamtbetrag der Bestellung |
| {OrderPhone1} |
Tel1 in Bestellungen |
| {OrderPhone2} |
Tel2 in Bestellungen |
| {OrderOrCustomerFax} |
Fax oder Standard Fax von Kund:innen für Bestellungen |
| {OrderOrCustomerPhone1} |
Tel1 oder Standard Tel1 von Kund:innen für Bestellungen |
| {OrderOrCustomerPhone2} |
Tel2 oder Standard Tel2 von Kund:innen für Bestellung |
| {OrderRef}, {OrderNumber} | Bestellnummer |
| {OrderStateText} | Status der Bestellung |
| {OrderVatAmount} | Summe der Umsatzsteuer auf die gesamte Bestellung (berechnet Bruttogesamtbetrag - Nettogesamtbetrag) |
| {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} | Standard Tel1 von Kund:innen (als Typ markiert) |
| {Phone2} | Standard Tel2 von Kund:innen (als Typ markiert) |
| {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/der Käufer:in |
| {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. |
| {RetoureTrackingNumber} |
Liste der Sendungsnummer der Retoure, falls vorhanden |
| {RetoureLatestTrackingNumber} |
neueste Sendungsnummer der Retoure, falls vorhanden |
| {RetoureTrackingLink} |
Liste der Links zur Sendungsverfolgung der Retoure, falls vorhanden |
| {RetoureLatestTrackingLink} |
neuester Link zur Sendungsverfolgung der Retoure, falls vorhanden |
| {RetoureTrackingNumberAvailable}... {/RetoureTrackingNumberAvailable} |
Bereichsmarker: Alles, was zwischen den Markern steht, wird nur ausgegeben, wenn mindestens eine Sendungsnummer einer Retoure vorhanden ist. |
| {RetoureTrackingLinkAvailable}... {/RetoureTrackingLinkAvailable} |
Bereichsmarker: Alles, was zwischen den Markern steht, wird nur ausgegeben, wenn mindestens ein Link zur Sendungsverfolgung einer Retoure 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 |
| {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. |
| Der Platzhalter {SoldArticlesLoop} ... {/SoldArticlesLoop} muss verwendet werden, damit die nachfolgenden Platzhalter ausgegeben werden können. |
|
| {Attributes} | Alle Attribute der einzelnen Artikel |
| {Id} | Die Billbee-ID des Artikels |
| {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) |
| {InvoiceText} | Inhalt aus dem Feld "Rechnungstext überschreiben" eines Artikels |
| {Price} | Der aktuelle Preis des Artikels (mit Komma als Dezimaltrenner) |
| {SinglePrice} | Einzelpreis der Position mit Währung |
| {SKU} | Die SKU des Artikels |
| {SourceId} | Id der Quelle (sind mehrere Quellen im Artikel hinterlegt werden diese kommagetrennt ausgegeben) |
| {StockCurrent} | Der aktuelle Bestand des Artikels (mit Komma als Dezimaltrenner) |
| {Title} | Der Titel des Artikels |
| {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.
Aus den folgenden Platzhaltern muss immer das "datumsFeld" durch den entsprechenden Datumsplatzhalter ersetzt werden. Genutzt werden können hier:
- ShipDate
- PayDate
- OrderDate
- OfferDate
- CurrentDate
- InvoiceDate
| 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 von dem Datumsfeld subtrahieren bzw. addieren. Hier ein paar Beispiele:
| Was möchtest du machen? | korrekter Platzhalter | Hinweis |
| Datum einen Tag in die Vergangenheit schieben | {datumsFeld-1d} | |
| Datum um einen Tag und 4 Stunden in die Zukunft schieben |
{datumsFeld+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 | {datumsFeld-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/die Kund:in erhält dann folgende Benachrichtigung:
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:
Schöne Grüße und viel Spaß mit deinem Einkauf,
Max Mustermann Shop
Mailanhänge
Es handelt sich bei den folgenden Platzhaltern nicht um durch Text ersetzte Platzhalter, sondern diese kreieren einen Mailanhang. Daher können sie nur mittels Mailversand per Regel verwendet werden. Möchtest du manuell tätig werden, müsstest du eine Regel mit manuellem Auslöser anlegen.
| Platzhalter | Beschreibung |
| {LatestRetoureDocuments} | Zuletzt in der Bestellung hinterlegtes Retourenlabel. Wird als PDF ausgegeben und kann nur in Mailvorlagen verwendet werden. |
| {LatestRetoureDocumentsQR} | QR Code des zuletzt in der Bestellung hinterlegten Retourenlabels. Wird als PDF ausgegeben und kann nur in Mailvorlagen verwendet werden. |