Benachrichtigungsvariablen
E-Mail-Benachrichtigungen dienen dazu, dem Kunden und dem Shop-Eigentümer wichtige Bestellinformationen zukommen zu lassen. Diese Benachrichtigungen werden mit Hilfe von HTML- und Freemarker-Tags erstellt und verwenden spezielle Variablen, um aktuelle Bestellinformationen in E-Mails anzuzeigen.
Dieser Artikel behandelt die Liste der verfügbaren Variablen. Beispiele für ihre Verwendung finden Sie im Artikel Bearbeiten von E-Mail-Benachrichtigungen. Sie können auch Variablen in einem benutzerdefinierten Tracking-Code verwenden.
Variablen für Kundeninformationen
| Name | Beschreibung |
| ${customer.name} | Zeigt den Namen des Kunden an. |
| ${customer.email} | Zeigt die E-Mail-Adresse des Kunden an. |
| ${customer.membershipName} | Zeigt den Namen der Kundengruppe an. |
| ${customer.membershipId} | Zeigt die ID der Kundengruppe an. |
Variablen für Bestellinformationen
| Name | Beschreibung |
| <#list order.items as orderItem> </#list> | Zeigt eine Liste bestellter Produkte an. |
| ${orderItem.name} | Zeigt den Namen des Produkts an. |
| ${orderItem.sku} | Zeigt die Artikelnummer (SKU) des Produkts an. |
| ${orderItem.description} | Zeigt die Beschreibung des Produkts an. |
| ${orderItem.customerUrl} | Ruft die URL der Produktseite auf. |
| ${orderItem.imageUrl} | Zeigt das Produktbild an. |
| ${orderItem.quantity} | Zeigt die Menge der bestellten Artikel an. |
| ${orderItem.price} | Zeigt den Produktpreis an. |
| ${orderItem.priceWithoutTax} | Zeigt den Produktpreis ohne Steuer an. |
| ${orderItem.isShippingRequired} | |
| ${orderItem.weight} | Zeigt das Gewicht des bestellten Produkts an. |
| ${orderItem.subtotal} | Zeigt die Zwischensumme der Bestellposition an (Artikelpreis × Menge der bestellten Artikel). |
| ${orderItem.subtotalWithoutTax} | Zeigt die Zwischensumme der Bestellung ohne Steuer an (Artikelpreis ohne Steuer × Menge der bestellten Artikel). |
| <#list orderItem.options as option> </#list> | Zeigt die Liste der für das Produkt ausgewählten Ausführungsvarianten an. |
| ${option.name} | Zeigt den Namen der Ausführungsvariante an. |
| ${option.value} | Zeigt die Auswahl der Ausführungsvarianten an. |
| <#list orderItem.attributes as attribute> </#list> | Zeigt die Liste aller Merkmale an, die für den Produkttyp des Artikels festgelegt wurden. |
| ${attribute.name} | Zeigt den Titel des Merkmals an. |
| ${attribute.value} | Zeigt den Namen des Merkmals an. |
| <#list orderItem.visibleAttributes as visibleAttribute> </#list> | Zeigt die Liste sichtbarer Merkmale an, die für den Produkttyp des Artikels festgelegt wurden. |
| ${visibleAttribute.name} | Zeigt den Titel des sichtbaren Merkmals an. |
| ${visibleAttribute.value} | Zeigt den Namen des sichtbaren Merkmals an. |
| <#list orderItem.files as file> </#list> | Zeigt die Liste der an das Produkt angehängten Dateien an. |
| ${file.description} | Zeigt die Beschreibung der Datei an. |
| ${file.fileName} | |
| ${file.name} | Zeigt den Namen der Datei an. |
| ${file.type} | Zeigt den Typ der Datei an. |
| ${file.size} | Zeigt die Größe der Datei an. |
| ${file.url} | Fügt einen Download-Link für die Datei hinzu. |
| <#list orderItem.taxes as tax> </#list> | Zeigt die Liste der auf das Produkt angewendeten Steuern an. |
| ${tax.name} | Zeigt den Namen der Steuer an. |
| ${tax.percentValue} | Zeigt den prozentualen Wert der Steuer an. |
| ${tax.absoluteValue} | Zeigt den absoluten Wert der Steuer für die Zwischensumme des Produkts an (absoluter Steuerwert × Einheiten des Produkts in der Bestellung). |
| ${orderItem.taxesTotalPercentValue} | Zeigt die Summe aller prozentualen Steuerwerte an, die auf das Produkt angewendet werden. |
| ${orderItem.taxesTotalAbsoluteValue} | Zeigt die Summe aller absoluten Steuerwerte an, die auf das Produkt angewendet werden. |
| ${order.number} | Zeigt die Bestellnummer an. |
| ${order.customerUrl} | Fügt die URL zum Profil des Kunden hinzu. Bleibt leer, wenn die Bestellung anonym aufgegeben wurde. |
| <@orderLink/> | Fügt die Bestellnummer hinzu. Wenn die Bestellung von einem registrierten Kunden aufgegeben wurde, enthält sie eine URL zur Bestellhistorie des Kunden. Wenn der Kunde nicht registriert ist, wird die Bestellnummer als Klartext angezeigt. |
| ${order.adminUrl} | Fügt einen Link zur Bestellung im Steuermenü des Shops hinzu. |
| ${order.dateCreated} | Zeigt das Datum der Bestellaufgabe an. |
| ${order.paymentStatus} | Zeigt den aktuellen Zahlungsstatus der Bestellung an. |
| <@paymentStatusColor/> | Ändert die Farbe des ${order.paymentStatus}-Elements in Abhängigkeit vom Status der Zahlung. |
|
${order.extTransactionId} |
Zeigt die Transaktions-ID für die Bestellung an (falls diese Bestellung eine Transaktions-ID hat). Ein Beispiel für diese Variable im Vorlagencode: |
| ${order.subtotal} | Zeigt die Zwischensumme der Bestellung an. |
| ${order.subtotalWithoutTax} | Zeigt die Zwischensumme der Bestellung ohne Steuern an (ohne Versandkosten). |
| ${order.total} | Zeigt die Gesamtsumme der Bestellung an. |
| ${order.shippingMethod} | Zeigt den Namen der Versandart an. |
| ${order.shippingCost} | Zeigt die Versandkosten für die Bestellung an. |
| ${order.weight} | Zeigt das Gesamtgewicht der bestellten Artikel an. |
| <#list order.taxes as tax> </#list> | Zeigt eine Liste der auf die Bestellung angewendeten Steuern an. |
| ${tax.name} | Zeigt den Namen der Steuer an. |
| ${tax.value} | Zeigt den Wert der Steuer an. |
| <#list order.discounts as discount> </#list> | Zeigt eine Liste der auf die Bestellung angewendeten Rabatte an. |
| ${discount.name} | Zeigt den Namen des Rabatts an. |
| ${discount.value} | Zeigt den Wert des Rabatts an. |
| ${order.couponPercent} | Zeigt den Prozentsatz des auf die Bestellung angewendeten Rabattgutscheins an. |
| ${order.couponName} | Zeigt den Namen des Rabattgutscheins an. |
| ${order.couponCode} | Zeigt den Code des Rabattgutscheins an. |
| ${order.totalDiscount} | Zeigt den Gesamtwert des auf die Bestellung angewendeten Rabatts an. |
| ${order.isShippingRequired} | |
| ${order.shippingAddress} | Zeigt die vollständige Lieferadresse für die Bestellung an. Es ist auch möglich, jedes Element der Lieferadresse separat anzuzeigen. |
| ${order.shippingAddress.name} | Zeigt den Namen des Kunden an. |
| ${order.shippingAddress.companyName} | Zeigt den in der Lieferadresse angegebenen Firmennamen an. |
| ${order.shippingAddress.street} | Zeigt die in der Lieferadresse angegebene Straße an. |
| ${order.shippingAddress.city} | Zeigt die in der Lieferadresse angegebene Stadt an. |
| ${order.shippingAddress.country} | Zeigt das in der Lieferadresse angegebene Land an. |
| ${order.shippingAddress.countryCode} | Zeigt den Code des Landes an, das in der Lieferadresse des Kunden angegeben ist. |
| ${order.shippingAddress.postalCode} | Zeigt die in der Lieferadresse angegebene Postleitzahl an. |
| ${order.shippingAddress.state} | Zeigt das in der Lieferadresse angegebene Bundesland an. |
| ${order.shippingAddress.stateCode} | Zeigt den Code des Bundeslandes an, der in der Lieferadresse des Kunden angegeben ist |
| ${order.shippingAddress.phone} | Zeigt die Telefonnummer des Kunden an. |
| ${order.shippingAddress.province} | Zeigt die in der Lieferadresse angegebene Provinz an. |
| ${order.shippingAddress.provinceCode} | Zeigt den Code der Provinz an, das in der Lieferadresse des Kunden angegeben ist. |
| ${order.shipping.cost} | Zeigt die Versandkosten inklusive Steuern an. |
| ${order.shipping.costWithoutTax} | Zeigt die Versandkosten ohne Steuern an. |
| ${order.shipping.taxesTotalPercentValue} | Zeigt die Summe der Prozentwerte aller Versandsteuern an. |
| ${order.shipping.taxesTotalAbsoluteValue} | Zeigt die Summe der absoluten Werte aller Versandsteuern an. |
| <#list order.shipping.taxes as shippingTax> </#list> | Zeigt eine Liste der auf die Bestellung angewendeten Versandsteuern an. |
| ${shippingTax.name} | Zeigt den Namen der Versandsteuer an. |
| ${shippingTax.percentValue} | Zeigt den prozentualen Wert der Versandsteuer an. |
| ${shippingTax.absoluteValue} | Zeigt den absoluten Wert der Versandsteuer an. |
| ${order.billingAddress} | Zeigt die vollständige Rechnungsadresse für die Bestellung an. Es ist auch möglich, jedes Element der Rechnungsadresse separat anzuzeigen. |
| ${order.billingAddress.name} | Zeigt den Namen des Kunden an. |
| ${order.billingAddress.companyName} | Zeigt den in der Rechnungsadresse angegebenen Firmennamen an. |
| ${order.billingAddress.street} | Zeigt die in der Rechnungsadresse angegebene Straße an. |
| ${order.billingAddress.city} | Zeigt die in der Rechnungsadresse angegebene Stadt an. |
| ${order.billingAddress.country} | Zeigt das in der Rechnungsadresse angegebene Land an. |
| ${order.billingAddress.countryCode} | Zeigt den Code des Landes an, das in der Rechnungsadresse des Kunden angegeben ist. |
| ${order.billingAddress.postalCode} | Zeigt die in der Rechnungsadresse angegebene Postleitzahl an. |
| ${order.billingAddress.state} | Zeigt das in der Rechnungsadresse angegebene Bundesland an. |
| ${order.billingAddress.stateCode} | Zeigt den Code des Bundeslandes an, der in der Rechnungsadresse des Kunden angegeben ist |
| ${order.billingAddress.phone} | Zeigt die in der Rechnungsadresse angegebene Telefonnummer an. |
| ${order.billingAddress.province} | Zeigt die in der Rechnungsadresse angegebene Provinz an. |
| ${order.billingAddress.provinceCode} | Zeigt den Code der Provinz an, das in der Rechnungsadresse des Kunden angegeben ist. |
| ${order.pickupTime} | Zeigt den Zeitpunkt der vom Kunden gewählten Abholung an. |
| ${order.isPaid} | |
| ${order.paymentMethod} | Zeigt den Titel „Zahlungsart:“ und den Namen der Zahlungsart an. |
| ${order.paymentMethod.isOnline} | |
| ${order.paymentMethod.instructionsTitle} | Zeigt den Titel der Zahlungsanweisungen an. |
| ${order.paymentMethod.instructions} | Zeigt den Inhalt der Zahlungsanweisungen an. |
| ${order.paymentMethod.name} | Zeigt den Namen der Zahlungsart an. |
| ${order.orderComments} | Zeigt die Kommentare zur Bestellung an. |
| ${order.privateAdminNotes} | Zeigt die vom Shop-Eigentümer hinzugefügten Bestellnotizen für die Mitarbeiter an. |
| ${order.isPaymentStatusUpdated} | |
| ${order.isFulfillmentStatusUpdated} | |
| ${order.fulfillmentStatus} | Zeigt den aktuellen Erfüllungsstatus der Bestellung an. |
| ${order.trackingNumber} | Zeigt die Trackingnummer an, falls aktiviert. |
| ${order.trackingUrl} | Fügt die URL der Bestellverfolgungsseite für die vom Versandanbieter berechneten Versandoptionen hinzu. |
| ${order.affiliateID} | Zeigt die Partner-ID der Bestellung an. |
| ${order.extraFields} | |
| <#list order.extraFields as extraField> </#list> | Zeigt die Liste der zusätzlichen Bestellfelder an. |
| ${extraField.key} | Zeigt den Schlüssel des Zusatzfeldes an. |
| ${extraField.value} | Zeigt den Wert des Zusatzfeldes an. |
| ${extraField.title} | Optional. Zeigt den Titel des Zusatzfeldes an. |
| ${extraField.orderDisplaySection} | Optional. Zeigt den Titel des Zusatzfeldes an. |
| ${extraField.type} | Zeigt den Typ des Zusatzfeldes an. |
| <#list order.surcharges as surcharge> | Zeigt die Liste der Bestellzuschläge an. |
| ${surcharge.id} | Zeigt die ID des Zuschlages an. |
| ${surcharge.value} | Zeigt den Wert des Zuschlages an. |
| ${surcharge.type} | Zeigt an, ob ein Zuschlag absolut oder prozentual ist. |
| ${surcharge.description} | Zeigt eine Beschreibung eines Zuschlages an. |
| ${surcharge.total} | Zeigt die Summe des Zuschlages an. |
| ${surcharge.taxable} | Zeigt an, ob der Zuschlag steuerpflichtig ist. |
| ${surcharge.showZeroSurchargeInTotal} | Zeigt einen Null-Zuschlag in der Gesamtsumme an. |
Nützliche Funktionen für die Arbeit mit Bestellzusatzfeldern
| Name | Beschreibung |
| getOrderExtraField(key) | Gibt das gesamte ExtraField-Objekt zurück (mit den Feldern Schlüssel, Wert, Titel usw.). |
| getOrderExtraFieldValue(key) | Gibt das Feld Wert des ExtraField-Objekts zurück. |
Variablen für Produktinformationen
| Name | Beschreibung |
| ${product.name} | Zeigt den Produktnamen an. |
| ${product.sku} | Zeigt die Artikelnummer (SKU) des Produkts an. |
| ${product.quantity} | Zeigt die Menge des Produkts an. |
| ${product.adminUrl} | Zeigt die URL der Produktseite im Steuermenü des Shops an. |
| ${product.customerUrl} | Fügt die URL der Produktseite hinzu. |
| ${product.imageUrl} | Zeigt das Produktbild an. |
| ${product.warningLimit} | Zeigt die Menge der auf Lager befindlichen Artikel an, die die „Meldung über niedrige Lagerbestände“ auslöst. |
| ${product.options} | |
| <#list product.options as option> </#list> | Zeigt die Liste der Produktausführungsvarianten an. |
| ${option.name} | Zeigt den Namen der Ausführungsvariante an. |
| ${option.value} | Zeigt den Wert der ausgewählten Ausführungsvariante an. |
| ${product.attributes} | |
| <#list product.attributes as attribute> </#list> | Zeigt die Liste der verborgenen Merkmale an, die für das Produkt festgelegt wurden. |
| ${attribute.name} | Zeigt den Titel des verborgenen Merkmals an. |
| ${attribute.value} | Zeigt den Namen des verborgenen Merkmals an. |
| <#list product.visibleAttributes as visibleAttribute> </#list> | Zeigt die Liste der sichtbaren Merkmale an, die für das Produkt festgelegt wurden. |
| ${visibleAttribute.name} | Zeigt den Titel des Merkmals an. |
| ${visibleAttribute.value} | Zeigt den Namen des Merkmals an. |
Verfügbare Variablen für Shop-Informationen
| Name | Beschreibung |
| ${store.id} | Zeigt die Shop-ID an. |
| ${store.name} | Zeigt den Namen des Shops an. |
| ${store.logoUrl} | Ruft die URL des Shop-Logos auf. |
| <@storeLogo/> | Zeigt das Logo des Shops an. Wenn kein Logo festgelegt ist, wird der Name des Shops angezeigt. |
| ${store.storeUrl} | Ruft die URL des Schaufensters auf. |
| ${store.companyEmail} | Zeigt die Unternehmens-E-Mail-Adresse an, die in den Shop-Einstellungen angegeben ist. |
| ${store.customerOrdersPageUrl} | Ruft die URL zur Seite mit der Bestellhistorie des Kunden auf. |
| <#list store.legalPages as page> </#list> | Zeigt die Liste der rechtlichen Seiten an. |
| ${page.name} | Zeigt den Namen einer bestimmten rechtlichen Seite an. |
| ${page.url} | Ruft die URL einer bestimmten rechtlichen Seite auf. |
| <@legalPages/> | Zeigt die Liste der gesetzlichen Seiten in einer einzigen Zeichenfolge an. |
| ${store.controlPanelUrl} | Fügt der Nachricht die URL des Steuermenüs des Shops hinzu. |
| ${store.egoodsLinkLifetime} | Zeigt die Gültigkeitsdauer des E-Goods-Links an. |
| ${store.egoodsMaxDownloadAttempts} | Zeigt die maximale Anzahl der Downloadversuche für E-Goods-Produkte an. |
| ${store.officeAddress} | Zeigt die physische Adresse des Shops an, die in den Shop-Einstellungen angegeben ist. |
| ${store.resetPasswordUrl} | Fügt der Nachricht die URL zum Zurücksetzen des Passworts eines Kunden hinzu. |
| ${store.businessRegistrationID} | Zeigt die Umsatzsteuer-Identifikationsnummer des Shops an. |
Variablen für Markeninformationen
| Name | Beschreibung |
| ${brand.name} | Zeigt den Namen unserer Marke an. |
| ${brand.logoUrl} | Ruft die URL unseres Logos auf. |