Referenz für Benachrichtigungsvariablen

Benachrichtigungen, die von deinem Shop aus versendet werden, werden mit Liquid gerendert. Liquid ist die einfache, benutzerfreundliche Programmiersprache von Shopify. Es ist dieselbe Programmiersprache, auf der die Themes aus dem Theme Store aufbauen.

Um die Benachrichtigungen zu bearbeiten, die von deinem Shop aus gesendet werden, kannst du grundlegende Anpassungen an deinen Benachrichtigungsvorlagen vornehmen. Um auf die vollständige Liste der Benachrichtigungen zuzugreifen, die du anpassen kannst, gehe in deinem Shopify-Adminbereich auf die Seite Benachrichtigungen.

Wenn du Hilfe bei fortgeschritteneren Änderungen benötigst oder Änderungen an benutzerdefinierten Benachrichtigungsvorlagen vornehmen möchtest, kannst du dich in unseren Foren an die Community wenden oder einen Shopify-Partner engagieren, der die Anpassungen für dich vornimmt. Erfahre mehr über das Engagieren eines Shopify-Partners.

Bestelleigenschaften

Viele Eigenschaften einer Bestellung sind direkt über Liquid und in Vorlagen verfügbar.

Beschreibungen von Liquid-Eigenschaften, die du mit dem Bestellobjekt in Benachrichtigungsvorlagen verwenden kannst
EigenschaftBeschreibung
id

Eine systemweit eindeutige ID der Bestellung zur internen Verwendung. Verwende das folgende Beispiel, um einen Link zur Bestellung im Adminbereich deines Shops zu generieren. Du kannst beispielsweise in deiner Vorlage Neue Bestellung den folgenden Code hinzufügen:

Bestellung ansehen
emailDie mit der Bestellung verknüpfte E-Mail.
name

In der Regel ist dies ein Rautezeichen, gefolgt von der order_number.

Beispiel: #1004

order_nameIdentisch mit Name.
order_number

Shop-eindeutige Nummer der Bestellung, ohne das #-Präfix sowie ohne Präfixe oder Suffixe, die von Shop-Inhaber:innen in ihren Shop-Einstellungen zur Bestell-ID hinzugefügt wurden.

Beispiel: 1004

confirmation_number

Eine zufällig generierte alphanumerische ID für die Bestellung, die den Kund:innen anstelle des sequenziellen Bestellnamens angezeigt werden kann. Es ist nicht garantiert, dass dieser Wert einmalig ist.

Beispiel: XPAV284CT

created_at

Datum und Uhrzeit der Erstellung der Bestellung. Du kannst dies mit dem Datumsfilter formatieren.

Beispiel: 2009-05-30T17:43:51+02:00

payment_terms

Zahlungsbedingungen geben das Datum an, an dem die Zahlung für eine Bestellung fällig ist.

Erfahre, wie du Zahlungsbedingungen zu Bestellrechnungen hinzufügst.

Weitere Details findest du in der Liquid-Referenz für payment_terms.

destinationDas Versandziel, an das die Artikel gesendet werden sollen.
tagsGibt ein Array aller Tags der Bestellung zurück. Die Tags werden in alphabetischer Reihenfolge zurückgegeben. Tags, die dynamisch von Apps oder Plattform-Funktionen angewendet werden, wie z. B. das Shopify Collective-Tag, sind beim Generieren der Benachrichtigungs-E-Mail möglicherweise nicht verfügbar. Um Artikel einer bestimmten Funktion zu erkennen, überprüfe stattdessen die Tags auf Produktebene für jede Position. Weitere Informationen findest du in der Liquid-Referenzdokumentation.
transactionsGibt ein Array mit Transaktionen aus der Bestellung zurück.
tax_priceDie gesamten Steuern für alle Artikel in der Bestellung.
tax_lines

Steuern aufgeschlüsselt nach Steuerart:

{% for tax_line in tax_lines %} {{ tax_line.title }} ({{ tax_line.rate_percentage }}%) : {{ tax_line.price | money_with_currency }} {% endfor %}
tax_line.titleDer Name der Steuer. Zum Beispiel QST oder MwSt.
tax_line.priceDer Steuerbetrag.
tax_line.rateDer Steuersatz als Dezimalzahl. Gibt 0,175 zurück, wenn der Satz 17,5 % beträgt.
tax_line.rate_percentageDer Steuersatz in einem lesbaren Format. Gibt 17,5 zurück, wenn der Satz 0,175 beträgt.
customerKundenobjekt, das die Attribute der Kund:innen-Ausgabe enthält.
billing_addressDie Rechnungsadresse.
billing_address.first_nameVorname des/der Kund:in.
billing_address.last_nameNachname des/der Kund:in.
billing_address.companyFirmenname für die Rechnungsstellung.
billing_address.phoneTelefonnummer aus der Rechnungsadresse.
shop.nameName deines Shops.
shop.phoneDie Telefonnummer deines Shops.
subtotal_priceSumme der Preise der Bestellpositionen nach Abzug von Positionsrabatten oder Warenkorbrabatten. Die Zwischensumme enthält keine Steuern (es sei denn, Steuern sind in den Preisen enthalten), Versandkosten oder Trinkgelder.
discountsEine Liste mit Rabatten.
discounts_amount

Der Gesamtbetrag der gewährten Rabatte.

Beispiel: +5,00 $

discounts_savings

Die durch alle Rabatte erzielte Gesamtersparnis.

Beispiel: -5,00 $

total_price

Gesamtsumme der Bestellung (Zwischensumme + Versandkosten - Versandrabatt + Steuer).

financial_statusDer aktuelle Zahlungsstatus. Einer der folgenden: nil, pending, authorized, paid, voided, refunded.
requires_shipping(boolesch) Gibt „true“ zurück, wenn mindestens ein Artikel in der Bestellung versendet werden muss.
shipping_method.title

Der Name des Versandtarifs.

In Benachrichtigungen an Kund:innen wird der Name des Versandtarifs in die Sprache übersetzt, in der die Kund:innen den Checkout durchgeführt haben, wenn sich diese Sprache von der Standardsprache des Shops unterscheidet.

Beispiel: Standardversand
shipping_method.price

Die Versandkosten einschließlich etwaiger Versandrabatte.

Beispiel: {{ shipping_method.price | money }}

shipping_price

Die Versandkosten.

Beispiel: {{ shipping_price | money }}

shipping_addressDie Lieferadresse.
shipping_address.first_nameDer Vorname für die Lieferadresse.
shipping_address.companyFirmenname für die Lieferadresse.
shipping_address.phoneTelefonnummer aus der Lieferadresse.
line_itemsListe aller Positionen in der Bestellung.
line_items_including_zero_quantityListe aller Positionen in der Bestellung, einschließlich derjenigen mit einer Menge von null. Positionen haben die Menge null, wenn sie vollständig zurückerstattet wurden.
line_item_groups(Orders and POS only)Liste aller Positionsgruppen, die Positionskomponenten in der Bestellung enthalten.
item_countDie Gesamtmenge aller Artikel.
fulfillment_statusDer aktuelle Fulfillmentstatus der Bestellung. Einer der folgenden: unfulfilled, partial, fulfilled.
noteDie Notiz, die der Bestellung beigefügt ist. Die Notiz kann von Kund:innen stammen und/oder auf der Seite mit den Bestelldetails in deinem Adminbereich bearbeitet werden.
attributes

Alle Attribute, die der Bestellung hinzugefügt wurden.

Beispiel: {{ attributes.gift-note }}

metafields

Alle Metafelder in der Bestellung. Verwende die folgende Syntax:

metafields.NAMESPACE.KEY

referring_site

Enthält die URL des Referrers, über den Kund:innen zu deinem Shop gelangt sind.

Beispiel: https://www.google.com/?s=great+products

landing_site

Enthält den Pfad der Landing-Page, die Kund:innen verwendet haben. Dies ist die erste Seite, die sie beim Besuch des Shops gesehen haben.

Beispiel: /products/great-product?ref=my-tracking-token

landing_site_ref

Überprüft die Landing-Page und extrahiert einen Referenzparameter daraus. Referenzparameter können sein: ref, source, r.

Wenn die landing_site /products/great-product?ref=my-tracking-token ist, dann landing_site_ref ist my-tracking-token. Du kannst eine bestimmte Aktion ausführen, wenn dein ref einem bestimmten Wert entspricht:

{% if landing_site_ref == 'my-tracking-token' %} Meine Aktion ... {% endif %}
cancelled(boolesch) Gibt „true“ zurück, wenn die Bestellung storniert wurde.
cancelled_atDer Zeitpunkt, an dem die Bestellung storniert wurde.
cancel_reasonDer Grund, der beim Stornieren der Bestellung ausgewählt wurde. Einer der folgenden: inventory, customer, declined, fraud oder other.
has_high_risks?(deprecated)

Gibt „true“ zurück, wenn die Bestellung ein hohes Risiko aufweist.

unique_gateways

Gibt eine Liste der einzigartigen Zahlungsanbieter für eine Bestellung zurück. Wenn zum Beispiel jemand mit einer Visa-Karte, einer Mastercard und per Barzahlung bezahlt hat, würde die zurückgegebene Liste Folgendes enthalten: shopify_payments, cash.

location(POS only)

Zeigt den physischen Standort der Bestellung an. Es sind mehrere Standorteigenschaften verfügbar, die hier aufgeführt sind. Du kannst Standorte im Bereich „Standorte“ deines Adminbereichs konfigurieren.

order_status_url

Gibt den Link zur Bestellstatus-Seite für diese Bestellung zurück.

fulfilled_line_items(deprecated)Liste der Positionen, die ausgeführt wurden.
unfulfilled_line_items(deprecated)Liste der Positionen, die nicht vollständig ausgeführt wurden.
b2b?

Gibt „wahr“ (true) zurück, wenn die Bestellung eine B2B-Bestellung ist. Verwende die Eigenschaft mit B2B-Variablen, um relevante Informationen wie den Unternehmensnamen, den Unternehmenssitz und die Adresse in E-Mails anzuzeigen. Bei B2B-Bestellungen kannst du beispielsweise einen Header mit den folgenden Informationen zu einer Vorlage hinzufügen:

{% if b2b? %} <p> Customer: {{ customer.name }} <p> Company: {{ company.name }} <p> Location: {{ company_location.name }} {% endif%}
company

Das Unternehmen, an das du im Rahmen einer B2B-Bestellung verkaufst.

company.name

Der Name des Unternehmens bei einer B2B-Bestellung.

company.id

Die ID des Unternehmens bei einer B2B-Bestellung.

company_location

Der Standort des Unternehmens bei einer B2B-Bestellung. Ein Unternehmen, das bei dir kauft, kann mehr als einen Standort haben.

company_location.name

Der Name des Unternehmenssitzes bei einer B2B-Bestellung.

company_location.id

Die ID-Nummer des Unternehmenssitzes bei einer B2B-Bestellung.

company_location.shipping_address

Die Lieferadresse des Unternehmenssitzes bei einer B2B-Bestellung.

company_location.billing_address

Die Rechnungsadresse des Unternehmenssitzes bei einer B2B-Bestellung.

customer_order_url

Die neue Bestellstatus-Seite einer Bestellung, für die ein:e Kund:in über Kundenkonten eine Rückgabe angefordert hat.

Eigenschaften von Bestellentwürfen

Beschreibungen von Liquid-Eigenschaften, die du mit dem Objekt „Bestellentwurf“ in Benachrichtigungsvorlagen verwenden kannst
EigenschaftBeschreibung
idEine eindeutige ID des Bestellentwurfs für den internen Gebrauch.
invoice_urlEin Link, über den Kund:innen die Rechnung über den sicheren Checkout von Shopify bezahlen können.
reserve_inventory_until

Das Datum und die Uhrzeit, bis zu denen die Positionen im Entwurf reserviert sind, zum Beispiel 2015-05-30T17:43:51+02:00.

Du kannst Daten mit dem Liquid-Datumsfilter formatieren.

userDie Person, die den Bestellentwurf zuletzt geändert hat.
user.nameDer Name der Person, die den Bestellentwurf zuletzt geändert hat.
user.emailDie E-Mail-Adresse der Person, die den Bestellentwurf zuletzt geändert hat.
emailDie mit dem Bestellentwurf verknüpfte E-Mail-Adresse.
nameDie eindeutige number des Bestellentwurfs mit vorangestelltem Rautezeichen #.
numberDie eindeutige Nummer des Bestellentwurfs ohne Bestellpräfix oder -suffix.
created_at

Das Datum und die Uhrzeit, zu denen der/die Kund:in den Bestellentwurf erstellt hat, zum Beispiel 2009-05-30T17:43:51+02:00.

Du kannst Daten mit dem Liquid-Datumsfilter formatieren.

tagsGibt ein Array mit allen Tags der Bestellung zurück. Die Tags werden in alphabetischer Reihenfolge zurückgegeben. Weitere Details findest du in der Liquid-Referenzdokumentation.
tax_priceDie Summe der Steuern für alle Artikel im Bestellentwurf.
tax_lines

Steuern, aufgeschlüsselt nach Steuerart:

{% for tax_line in tax_lines %} {{ tax_line.title }} ({{ tax_line.rate_percentage }}%) : {{ tax_line.price | money_with_currency }} {% endfor %}
tax_line.title

Der Name der Steuer.

Beispiele: QST oder MwSt.

tax_line.priceDer Steuerbetrag.
tax_line.rateDer Steuersatz in Dezimalform. Ein Steuersatz von 17,5 % gibt beispielsweise 0.175 zurück.
tax_line.rate_percentageDer Steuersatz in Prozentform. Eine rate von 0,175 gibt beispielsweise 17.5 zurück.
customerKundenobjekt, das die Attribute der Kund:innen-Ausgabe enthält.
billing_addressDie Rechnungsadresse für den Bestellentwurf.
billing_address.first_nameDer Vorname des/der Kund:in.
billing_address.last_nameDer Nachname des/der Kund:in.
billing_address.companyDer Unternehmensname in der Rechnungsadresse.
billing_address.phoneDie Telefonnummer in der Rechnungsadresse.
shop.nameDer Name deines Shops.
shop.phoneDie Telefonnummer deines Shops.
subtotal_priceSumme der Preise der Positionen des Bestellentwurfs nach Abzug von Positionsrabatten oder Warenkorbrabatten. Die Zwischensumme enthält keine Steuern (es sei denn, die Steuern sind in den Preisen enthalten) oder Versandkosten.
discountsEine Liste mit Rabatten.
discounts_amount

Gesamtbetrag der angewendeten Rabatte.

Beispiel: +5,00 $

discounts_savings

Betrag der durch alle Rabatte erzielten Ersparnis.

Beispiel: -5,00 $

total_priceDer Gesamtpreis der Bestellung (Zwischensumme + Versandkosten - Versandrabatt + Steuer).
amount_due_now

Der auf der Rechnung des Bestellentwurfs geforderte Betrag.

requires_shippingGibt true zurück, wenn im Bestellentwurf mindestens ein Artikel enthalten ist, der versendet werden muss. Gibt false zurück, wenn kein Artikel im Bestellentwurf versendet werden muss.
shipping_method.title

Der Name des Versandtarifs.

Beispiel: Standardversand

shipping_method.priceDer Preis der Versandart. Gibt dieselben Informationen zurück wie shipping_price.
shipping_price

Die Versandkosten.

Du kannst diesen Betrag mit den Liquid-Geldbetragsfiltern formatieren.

shipping_address

Die Lieferadresse.

Hinweis: Im Gegensatz zu regulären Bestellungen kann die Lieferadresse eines Bestellentwurfs unvollständig sein.

shipping_address.first_nameDer Vorname für die Lieferadresse.
shipping_address.companyDer Unternehmensname in der Lieferadresse.
shipping_address.phoneDie Telefonnummer in der Lieferadresse.
line_itemsEine Liste aller Positionen im Bestellentwurf.
item_countEine Summe aller Artikelmengen im Bestellentwurf.
noteDie dem Bestellentwurf beigefügte Anmerkung. Die Anmerkung kann vom/von der Kund:in stammen und auch auf der Detailseite des Bestellentwurfs in deinem Shopify-Adminbereich bearbeitet werden.
metafields

Alle Metafelder für den Bestellentwurf. Verwende die folgende Syntax:

metafields.NAMESPACE.KEY

location

Der physische Standort der Bestellung. Es sind mehrere Standorteigenschaften verfügbar.

Du kannst Standorte auf der Seite Standorte deines Shopify-Adminbereichs konfigurieren.

b2b?

Gibt „wahr“ (true) zurück, wenn die Bestellung eine B2B-Bestellung ist. Verwende die Eigenschaft mit B2B-Variablen, um relevante Informationen wie den Unternehmensnamen, den Unternehmenssitz und die Adresse in E-Mails anzuzeigen. Bei B2B-Bestellungen kannst du beispielsweise einen Header mit den folgenden Informationen zu einer Vorlage hinzufügen:

{% if b2b? %} <p> Customer: {{ customer.name }} <p> Company: {{ company.name }} <p> Location: {{ company_location.name }} {% endif%}
company

Das Unternehmen, an das du im Rahmen einer B2B-Bestellung verkaufst.

company.name

Der Name des Unternehmens bei einer B2B-Bestellung.

company.id

Die ID des Unternehmens bei einer B2B-Bestellung.

company_location

Der Standort des Unternehmens bei einer B2B-Bestellung. Ein Unternehmen, das bei dir kauft, kann mehr als einen Standort haben.

company_location.name

Der Name des Unternehmenssitzes bei einer B2B-Bestellung.

company_location.id

Die ID-Nummer des Unternehmenssitzes bei einer B2B-Bestellung.

company_location.shipping_address

Die Lieferadresse des Unternehmenssitzes bei einer B2B-Bestellung.

company_location.billing_address

Die Rechnungsadresse des Unternehmenssitzes bei einer B2B-Bestellung.

payment_methods

Eine Liste gespeicherter Zahlungsmethoden, die zur Verarbeitung der Gesamtsumme des Entwurfs zur Verfügung stehen.

payment_method.payment_instrument

Das Zahlungsmittel, das Details über die gespeicherte Zahlungsmethode enthält.

payment_method.payment_instrument.payment_type

Die Art der gespeicherten Zahlungsmethode. Z. B. „credit_card, apple_pay“.

payment_method.payment_instrument.credit_card_brand

Die Marke der Karte, wenn `payment_type` „credit_card“ ist

payment_method.payment_instrument.credit_card_company

Das Kartenunternehmen, wenn `payment_type` „credit_card“ ist

payment_method.payment_instrument.credit_card_company

Die letzten 4 Ziffern der Karte, wenn `payment_type` „credit_card“ ist

Eigenschaften des Zahlungsplans

Beschreibungen der Liquid-Eigenschaften, die du für das Zahlungsplan-Objekt in Benachrichtigungsvorlagen verwenden kannst
EigenschaftBeschreibung
payment_schedule.amount_due

Der zu zahlende Betrag für einen Zahlungsplan.

Du kannst Beträge mit Währungen mithilfe des Liquid money filter formatieren.

payment_schedule.due_at

Das Fälligkeitsdatum für den Zahlungsplan.

Du kannst Daten mit dem Liquid-Datumsfilter formatieren.

payment_schedule.due_in_days

Die Anzahl der Tage bis zum Fälligkeitsdatum, wenn der Zahlungsplan noch ausstehend (unbezahlt) ist.

payment_schedule.due_later?

Gibt „true“ zurück, wenn ein Zahlungsplan nicht bezahlt wurde und sein Fälligkeitsdatum in der Zukunft liegt.

payment_schedule.number_of_days_overdue?

Die Anzahl der Tage ab dem Fälligkeitsdatum, wenn ein Zahlungsplan überfällig ist.

payment_schedule.overdue?

Gibt „true“ zurück, wenn ein Zahlungsplan nicht bezahlt wurde und das Fälligkeitsdatum überschritten ist.

Eigenschaften des Zahlungsstatus

Beschreibungen der Liquid-Eigenschaften, die du für das Zahlungsstatus-Objekt in Benachrichtigungsvorlagen verwenden kannst
EigenschaftBeschreibung
has_pending_payment

(boolesch) Gibt „true“ zurück, wenn die Bestellung eine Transaktion mit einer ausstehenden Zahlung hat.

Mehr Informationen zu ausstehenden Zahlungen.

buyer_action_required

(boolesch) Gibt „true“ zurück, wenn eine Bestellung eine Transaktion mit einer ausstehenden Zahlung aufweist und eine Aktion des Käufers oder der Käuferin erforderlich ist, um die Zahlung freizugeben. Wenn dieser Wert „true“ zurückgibt und die Zahlungsmethode Zahlungsanweisungen unterstützt, die/der/das buyer_pending_payment_instructions liefert Details, die der Kunde oder die Kundin verwenden kann, um seinen bzw. ihren Kauf offline abzuschließen.

Mehr Informationen zum Liquid-transaction object.

Eigenschaften der Bundle-Komponente

Jede bundle_component in der Liste line_item.bundle_components hat die folgenden Eigenschaften. (Nur für Bestellentwürfe)

Beschreibungen der Liquid-Eigenschaften, die du für das Bundle-Komponenten-Objekt in Benachrichtigungsvorlagen verwenden kannst
EigenschaftBeschreibung
bundle_component.image_urlDie Bild-URL der Bundle-Komponente.
bundle_component.product.titleDer Titel des Titels des Bundle-Komponenten-Produkts.
bundle_component.quantityMenge für die Bundle-Komponente.
bundle_component.variant.title

Die aktuellen Namen der Optionswerte der Bundle-Komponenten-Variante, verbunden durch /-Zeichen.

Beispiel: Klein / Rot

Eigenschaften der Komponente

Jede component in der Liste der line_item.components hat die folgenden Eigenschaften. (Nur bei abgebrochenem Checkout) `

Beschreibungen der Liquid-Eigenschaften, die du für das Komponentenobjekt in Benachrichtigungsvorlagen verwenden kannst
EigenschaftBeschreibung
component.image_urlDie Bild-URL der Komponente.
component.product.titleDer Titel des Titels des Komponentenprodukts.
component.quantityMenge für die Komponente.
component.variant.title

Die aktuellen Namen der Optionswerte der Komponentenvariante, verbunden durch /-Zeichen.

Beispiel: Klein / Rot

Eigenschaften der Position

Jede line in der Liste der line_items oder subtotal_line_items hat die folgenden Eigenschaften.

Beschreibungen der Liquid-Eigenschaften, die du für das Positionsobjekt in Benachrichtigungsvorlagen verwenden kannst
EigenschaftBeschreibung
line.applied_discounts(POS and draft orders only)Liste der auf diesen Artikel angewendeten Rabatte (jeder Rabatt hat die Eigenschaften title, code, amount, savings und type).
line.bundle_components(Draft orders only)Liste der Positionen, die Bundle-Komponenten dieses Artikels sind. Gibt nur dann eine Liste zurück, wenn diese Position ein Bundle-Produkt ist.
line.bundle_parent?(Draft orders only)(boolesch) Gibt „true“ zurück, wenn die Position ein Bundle-Produkt ist.
line.components(Abandoned checkout only)Liste der Positionen, die Komponenten dieses Artikels sind.
line.parent?(Abandoned checkout only)(boolesch) Gibt „true“ zurück, wenn die Position Komponenten hat.
line.custom(Draft orders only)(boolesch) Gibt „true“ zurück, wenn der Artikel eine benutzerdefinierte Position für einen Bestellentwurf ist.
line.delivery_agreementDas mit dieser Position verknüpfte Delivery Agreement.
line.gramsGewicht eines einzelnen Artikels.
line.groupsDie Line item group des Artikels.
line.imageGibt die URL des mit dieser Position verknüpften Bildes zurück. Du kannst auch den img_url filter verwenden, um bestimmte Bildgrößen zu erhalten, z. B. {{ line.image | img_url: 'small' }}
line.line_priceDer Preis multipliziert mit der Menge für diesen Artikel.
line.original_line_priceDer Gesamtpreis für die Menge der in der Position enthaltenen Artikel, bevor Rabatte angewendet wurden.
line.final_line_priceDer Gesamtpreis aller Artikel in der Position, einschließlich aller Rabattbeträge auf Positionsebene.
line.pre_tax_priceDer Preis der Positionen vor Steuern, multipliziert mit der Menge der gekauften Position.
line.priceDer Preis für einen einzelnen Artikel.
line.product.metafields

Alle Metafelder auf Produktebene. Verwende die folgende Syntax:

line.product.metafields.NAMESPACE.KEY

line.product.titleDer aktuelle Name des Produkts.
line.product.vendorDer Anbieter für den Artikel.
line.propertiesGibt ein Array mit benutzerdefinierten Informationen für einen Artikel zurück. Line item properties werden von Kund:innen auf der Produktseite angegeben, bevor sie ein Produkt in den Warenkorb legen.
line.quantityMenge für diesen Artikel.
line.current_quantityDie aktuelle Menge des Artikels nach Entfernungen.
line.requires_shipping(boolesch) Gibt „true“ zurück, wenn für die Variante des Artikels die Einstellung Physisches Produkt auf der Produktseite aktiviert ist.
line.selling_plan_allocationGibt ein selling_plan_allocation-Objekt zurück, das beschreibt, wie sich ein Verkaufsplan, wie zum Beispiel ein Abonnement, auf die Position auswirkt.
line.taxable(boolesch) Gibt „true“ zurück, wenn für die Variante des Artikels das Kontrollkästchen „Für dieses Produkt Steuern erheben“ auf der Produktseite aktiviert ist.
line.title

Der Name des Produkts zum Zeitpunkt des Verkaufs, gefolgt von einem Gedankenstrich und dem Namen der Variante zum Zeitpunkt des Verkaufs. Der Variantenname wird nicht angegeben, wenn es sich um einen „Standardtitel“ handelt.

In Benachrichtigungen für Kund:innen werden der Produktname und der Variantenname in die Sprache übersetzt, in der die Kund:innen den Checkout abgeschlossen haben, wenn sich diese Sprache von der Standard-Shop-Sprache unterscheidet.
line.urlDie relative URL der Variante der Position. Die relative URL enthält nicht die Stamm-URL deines Shops (mystore.myshopify.com).
line.variant.barcodeDer mit der Produktvariante verknüpfte Barcode.
line.variant.compare_at_priceDer mit der Produktvariante verknüpfte Vergleichspreis.
line.variant.imageDas Bild für die Produktvariante. Gibt nur dann ein Bild zurück, wenn der Variante in der Position ein bestimmtes Bild zugewiesen ist.
line.variant.metafields

Alle Metafelder auf Variantenebene. Verwende die folgende Syntax:

line.variant.metafields.NAMESPACE.KEY

line.variant.skuDie mit der Produktvariante verknüpfte SKU.
line.variant.title

Die aktuellen Namen der Optionswerte der Variante, die durch /-Zeichen verbunden sind.

Beispiel: Klein / Rot

line.refunded.quantity(within refund notifications)

Die Menge eines Artikels, der zurückerstattet werden soll. Du kannst diese Eigenschaft verwenden, um zurückerstatteten Artikeln in einer Bestellung eine ID hinzuzufügen.

Zum Beispiel: {% if line.refunded_quantity > 0 %}ID für zurückerstattete Position{% endif %}

Shopify Collective-Artikel in Benachrichtigungsvorlagen erkennen

Das Shopify Collective-Tag wird einer Bestellung hinzugefügt, nachdem die Bestellbestätigungs-E-Mail gesendet wurde. Daher ist {% if tags contains 'Shopify Collective' %} in einer Bestellbestätigungsvorlage niemals true. Um Shopify Collective-Artikel zu erkennen, überprüfe stattdessen die Tags auf Produktebene für jede Position:

{% assign has_collective_item = false %}
{% for line in line_items %}
  {% if line.product.tags contains 'Shopify Collective' %}
    {% assign has_collective_item = true %}
  {% endif %}
{% endfor %}

{% if has_collective_item %}
  <!-- Collective-specific content -->
{% endif %}

Eigenschaften von Positionsgruppen

Jede line_item_group in der Liste der line_item_groups hat die folgenden Eigenschaften.

Beschreibungen von Liquid-Eigenschaften, die du mit dem Positionsgruppenobjekt in Benachrichtigungsvorlagen verwenden kannst
EigenschaftBeschreibung
line_item_group.display_titleDer Titel der Positionsgruppe.
line_item_group.componentsListe der Positionskomponenten, die zur Gruppe gehören.
line_item_group.imageDas Bild der Positionsgruppe.
line_item_group.product_idDie Produkt-ID der Positionsgruppe.
line_item_group.variantDas Variantenobjekt der Positionsgruppe.
line_item_group.variant_idDie Varianten-ID der Positionsgruppe.

Eigenschaften von Rückerstattungen

Beschreibungen von Liquid-Eigenschaften, die du mit dem Rückerstattungsobjekt in Benachrichtigungsvorlagen verwenden kannst
EigenschaftBeschreibung
amountDer zurückerstattete Betrag.
refund_line_itemsEine Liste von Rückerstattungspositionen, die zurückerstattet werden sollen.

Eigenschaften von Refund_line_item

Jede refund_line in der Liste der refund_line_items hat die folgenden Eigenschaften:

Beschreibungen von Liquid-Eigenschaften, die du mit dem Objekt für Rückerstattungspositionen in Benachrichtigungsvorlagen verwenden kannst
EigenschaftBeschreibung
refund_line.line_itemDie line_item, die zurückerstattet wird. Diese hat Zugriff auf alle Eigenschaften von line_item.
refund_line.quantityDie Menge der Position, die zurückerstattet werden soll.

Fulfillment-Eigenschaften

Beschreibungen von Liquid-Eigenschaften, die du mit dem Fulfillment-Objekt in Benachrichtigungsvorlagen verwenden kannst
EigenschaftBeschreibung
service_nameDer Name des benutzerdefinierten Services, wie auf der Seite Einstellungen > Versand und Zustellung definiert. (Nur Fulfillment-Anfrage)
fulfillment.estimated_delivery_atEin voraussichtliches Lieferdatum, das auf der Trackingnummer (sofern verfügbar) von einem der folgenden Versanddienstleister basiert: USPS, FedEx, UPS, Canada Post (nur Kanada). Diese Eigenschaft ist nur verfügbar, wenn vom Versanddienstleister berechnete Tarife verwendet werden.
fulfillment.fulfillment_line_itemsEine Liste der Fulfillment-Positionen, die ausgeführt werden sollen.
fulfillment.item_countEine Summe der Mengen aller Artikel. Die Gesamtzahl der Artikel, die ausgeführt werden.
fulfillment.requires_shipping(boolesch) Gibt „wahr“ zurück, wenn diese Fulfillment-Anfrage einen Versand erfordert.
fulfillment.tracking_companyDas Unternehmen, das das Tracking durchführt.
fulfillment.tracking_numbersEine Liste von Trackingnummern.
fulfillment.tracking_urlsEine Liste von Tracking-URLs.
items_to_fulfill(deprecated)Eine Liste von Positionen, die von diesem bestimmten benutzerdefinierten Fulfillmentdienst ausgeführt werden sollen. (Nur Fulfillment-Anfrage)
items_to_fulfill_count(deprecated)Die Gesamtzahl der Artikel, die mit dieser Anfrage ausgeführt werden sollen. (Nur Fulfillment-Anfrage)

Eigenschaften von Fulfillment_line_item

Jede fulfillment_line in der Liste der fulfillment_line_items hat die folgenden Eigenschaften.

Beschreibungen von Liquid-Eigenschaften, die du mit dem Objekt für Fulfillment-Positionen in Benachrichtigungsvorlagen verwenden kannst
EigenschaftBeschreibung
fulfillment_line.line_itemDie line_item, die ausgeführt wird. Diese hat Zugriff auf alle Eigenschaften von line_item.
fulfillment_line.quantityDie Menge der Position, die ausgeführt wird.

Eigenschaften vorbereiteter Pakete

Ein vorbereitetes Paket enthält die Artikel, die als abholbereit markiert sind.

Beschreibungen von Liquid-Eigenschaften, die du mit dem Objekt für vorbereitete Pakete in Benachrichtigungsvorlagen verwenden kannst
EigenschaftBeschreibung
item_countEine Summe aller Artikelmengen im vorbereiteten Paket.
prepared_package_line_itemsEine Liste von Positionen vorbereiteter Pakete.

Eigenschaften von Prepared_package_line_item

Jede prepared_package_line_item in der Liste der prepared_package_line_items hat die folgenden Eigenschaften.

Beschreibungen von Liquid-Eigenschaften, die du mit dem Objekt für Positionen vorbereiteter Pakete in Benachrichtigungsvorlagen verwenden kannst
EigenschaftBeschreibung
line_itemDie zugehörige line_item. Diese hat Zugriff auf alle Eigenschaften von line_item.
quantityDie Menge der Position, die als abholbereit markiert wurde.

Eigenschaften der Zustellung

Beschreibungen von Liquid-Eigenschaften, die du mit dem Zustellungsobjekt in Benachrichtigungsvorlagen verwenden kannst
EigenschaftBeschreibung
delivery_agreementsListe aller Liefervereinbarungen für die Bestellung.
delivery_instructionsInformationen zur lokalen Zustellung für deine Kundschaft. Diese Informationen werden über das Feld Zustellinformationen in deinen Einstellungen für die lokale Zustellung gesteuert.
consolidated_estimated_delivery_timeInformationen zu den Lieferterminen der Bestellung für deine Kundschaft. Diese Informationen werden über die Einstellung Bearbeitungszeit gesteuert, die du auf deiner Seite Versand und Zustellung einrichtest. Wenn die Bestellung mehrere Zustellmethoden hat, wird eine Liste der Zustellmethoden und -termine angezeigt.
has_multiple_delivery_methods(boolesch) Gibt „wahr“ zurück, wenn die Bestellung mehrere Zustellmethoden hat.

Eigenschaften der Liefervereinbarung

Beschreibungen von Liquid-Eigenschaften, die du mit dem Objekt für Liefervereinbarungen in Benachrichtigungsvorlagen verwenden kannst
EigenschaftBeschreibung
delivery_agreement.delivery_method_typeDie Art der Zustellmethode.
delivery_agreement.delivery_method_nameDie Art der Zustellmethode, übersetzt in die Sprache des Checkouts, wenn sich diese von der Standard-Shopsprache unterscheidet.
delivery_agreement.line_item_groupsListe aller Positionsgruppen, die gebündelte Positionskomponenten in der Liefervereinbarung enthalten.
delivery_agreement.line_itemsListe aller Positionen, die mit dieser Liefervereinbarung verknüpft sind.

Rabatteigenschaften

Es gibt zwei Arten von Rabatteigenschaften.

discount_applications beschreibt, warum und wie ein Artikel rabattiert wurde.

discount_allocations beschreibt, wie sich ein bestimmter Rabatt auf eine Position auswirkt und wie er den Preis reduziert. Du solltest diese Eigenschaft auf Positionsebene verwenden.

Du kannst diese Eigenschaften kombinieren, um Rabattinformationen auf der Ebene der Position oder der Bestellung anzuzeigen.

Beispiel

In diesem Beispiel wird geprüft, ob ein Rabatt auf die Position angewendet wurde. Wenn der Rabatt nicht auf Bestellebene (all) angewendet wurde, werden der Rabattname und der Betrag angezeigt.

{% if line.discount_allocations %}
	{% for discount_allocation in line.discount_allocations %}
    	{% if discount_allocation.discount_application.target_selection != 'all' %}
        	{{ discount_allocation.discount_application.title | upcase }}
        	(-{{ discount_allocation.amount | money }})
    	{% endif %}
	{% endfor %}
{% endif %}

Das Ergebnis könnte so aussehen:

SPRING5 (-$5.00)

Eigenschaften von „discount_allocation“

Jede discount_allocation in der Liste der discount_allocations hat die folgenden Eigenschaften.

Beschreibungen der Liquid-Eigenschaften, die du mit dem Objekt „discount_allocation“ in Benachrichtigungsvorlagen verwenden kannst
EigenschaftBeschreibung
discount_allocation.amountDer Geldbetrag, den der/die Kund:in bei einer Position spart. Muss in einer Schleife eingegeben werden, wenn du mehrere Rabattcodes zulassen möchtest.
discount_allocation.discount_applicationDie Rabattanwendung, die den Betrag der Position zuweist.

Eigenschaften von „discount_application“

Jede discount_application in der Liste der discount_applications hat die folgenden Eigenschaften.

Beschreibungen der Liquid-Eigenschaften, die du mit dem Objekt „discount_application“ in Benachrichtigungsvorlagen verwenden kannst
EigenschaftBeschreibung
discount_application.target_selection

Beschreibt, wie ein Rabatt Positionen im Warenkorb auswählt, die rabattiert werden sollen. Eine von:

  • all: Der Rabatt gilt für alle Positionen.
  • entitled: Der Rabatt gilt für eine bestimmte Teilmenge von Positionen, die oft durch eine Bedingung definiert wird.
  • explicit: Der Rabatt gilt für eine speziell ausgewählte Position oder Versandinformation.
discount_application.target_typeDer Artikeltyp, für den ein Rabatt gilt (line_item oder shipping_line).
discount_application.title

Der für Kund:innen sichtbare Name des Rabatts.

Beispiele: Welcome10 oder CBBWQQAKYBYY

discount_application.total_allocated_amountDer Gesamtbetrag, um den der Preis einer Bestellung durch den Rabatt reduziert wird.
discount_application.typeDie Art des Rabatts. Eine von: automatic, discount_code, manual oder script.
discount_application.valueDer Wert des Rabatts.
discount_application.value_typeDer Werttyp des Rabatts. Eine von: fixed_amount oder percentage.

Abonnementeigenschaften

Details zu einem Abonnementvertrag, dem aktuellen Rechnungszyklus und den zugehörigen Positionen, der Zustellmethode und der Zahlungsmethode sind für alle Abonnement-E-Mail-Vorlagen verfügbar.

Um die Benachrichtigungsvorlagen für Abonnements zu bearbeiten, installiere die Shopify Subscriptions-App und suche dann die Vorlage unter Einstellungen > Benachrichtigungen im Abschnitt Abonnements.

Eigenschaften des Rechnungszyklus für Abonnementverträge

Verwende das Objekt subscription_contract_billing_cycle, um auf die Eigenschaften des Abonnementvertrags und dessen Rechnungszyklus zuzugreifen.

Beispiel

{% assign contract = subscription_contract_billing_cycle %}
This contract is currently {{ contract.status }}.

Ergebnis:

This contract is currently paused.

Eigenschaften

Beschreibungen der Liquid-Eigenschaften, die du mit dem Objekt „subscription_contract_billing_cycle“ in Benachrichtigungsvorlagen verwenden kannst
EigenschaftBeschreibung
status Der Status des Vertrags.

Einer der folgenden: active, paused, cancelled, failed, expired, stale,
delivery_method Die Zustellmethode des Abonnements.

Wenn das Abonnement für eine Dienstleistung oder ein digitales Produkt gilt, wird nil zurückgegeben.
billing_frequencyWie oft das Abonnement abgerechnet wird.
delivery_frequency Wie oft das Abonnement zugestellt wird.
origin_order Die ursprüngliche Bestellung, mit der das Abonnement zuerst erstellt wurde.

Wenn das Abonnement nicht aus einer Shopify-Bestellung erstellt wurde, wird nil zurückgegeben.
customerDer/die Kund:in des Abonnements.
line_items Die Positionen im Zahlungszyklus für Abonnements.
product_namesEine Liste der Namen der Produkte, die im Zahlungszyklus für Abonnements enthalten sind.
update_payment_method_urlDie URL, die der/die Kund:in verwenden kann, um die Zahlungsmethode für diesen Vertrag zu aktualisieren.
shipping_address Die Lieferadresse des Abonnements.

Wenn das Abonnement für eine Dienstleistung oder ein digitales Produkt gilt, wird nil zurückgegeben.
billing_addressDie Rechnungsadresse des Abonnements.
subtotal_priceDie Zwischensumme der Abonnementpositionen.
shipping_priceDie Versandkosten des Abonnements.
total_taxDie Gesamtsteuer des Abonnements.
total_priceDer Gesamtpreis des Abonnements.
total_discountsDie Gesamtrabatte des Abonnements.
customer_self_serve_urlDie Self-Service-URL, die der/die Kund:in zur Verwaltung seiner/ihrer Abonnements verwenden kann.
billing_attempt_expected_dateDas Rechnungsdatum für diesen Rechnungszyklus.
next_billing_dateDas nächste nicht übersprungene Rechnungsdatum nach diesem Rechnungszyklus.
last_attempted_billing_dateDas Datum des letzten Abrechnungsversuchs für den Rechnungszyklus.
days_overdueDie Anzahl der Tage, die die Abrechnung für diesen Rechnungszyklus überfällig ist.
payment_instrumentDas mit dem Abonnementvertrag verknüpfte Zahlungsinstrument. Dieses Zahlungsinstrument wird verwendet, um dem/der Kund:in eine Rechnung zu stellen.

Eigenschaften der Positionen des Abonnementvertrags

Die Eigenschaften für jede im Rechnungszyklus enthaltene Position. Greife über die übergeordnete Eigenschaft subscription_contract_billing_cycle.line_items auf die Eigenschaften der Vertragsposition zu.

Beispiel

{% for line_item in subscription_contract_billing_cycle.line_items %}
  {{ line_item.url }}
{% endfor %}
Beschreibungen der Liquid-Eigenschaften, die du mit dem Objekt für die Position eines Abonnementvertrags in Benachrichtigungsvorlagen verwenden kannst
EigenschaftBeschreibung
urlDie URL zur Produktdetailseite für die Produktvariante der Position.
requires_shippingGibt an, ob die Position einen physischen Versand erfordert.
unit_price_measurementDie Stückpreismessung der Position.
selling_plan_allocationDie Verkaufsplanzuordnung der Position.

Eigenschaften der Zustellmethode für Abonnementverträge

Die Eigenschaften für die Zustellmethode, die in diesem Rechnungszyklus verwendet wird. Der Zugriff auf die Eigenschaften der Zustellmethode erfolgt über die übergeordnete Eigenschaft subscription_contract_billing_cycle.delivery_method.

Beispiel

{% if subscription_contract_billing_cycle.delivery_method != blank %}
  Delivery method: {{ subscription_contract_billing_cycle.delivery_method.title }}
{% endif %}
Beschreibungen von Liquid-Eigenschaften, die du mit dem Objekt für die Zustellmethode des Abonnementvertrags in Benachrichtigungsvorlagen verwenden kannst.
EigenschaftBeschreibung
titleDer Titel der Versandoption, die mit der Zustellmethode verknüpft ist.
type Die Art der Zustellmethode.

Einer der folgenden Werte: shipping, local oder pick-up.

Eigenschaften des Zahlungsinstruments für Abonnementverträge

Details zum Zahlungsinstrument für den Abonnementvertrag. Dieses Zahlungsinstrument wird zur Abrechnung mit Kund:innen verwendet. Der Zugriff auf die Eigenschaften des Zahlungsinstruments erfolgt über die übergeordnete Eigenschaft subscription_contract_billing_cycle.payment_instrument.

Beispiel

{% assign instrument = subscription_contract_billing_cycle.payment_instrument %}

<img src="{{ instrument.payment_type | payment_type_img_url }} "  alt="{{ instrument.credit_card_company }}" />
{{ instrument.credit_card_company }} ending with {{ instrument.credit_card_last_four_digits }}
Beschreibungen von Liquid-Eigenschaften, die du mit dem Objekt für das Zahlungsinstrument des Abonnementvertrags in Benachrichtigungsvorlagen verwenden kannst.
EigenschaftBeschreibung
payment_type Die Art der Zahlungsmethode, die durch das Zahlungsinstrument dargestellt wird.

Verwende Zahlungsfilter, um eine Bild-URL oder eine SVG-Datei auszugeben.
credit_card_brandDie Marke der Kreditkarte.
credit_card_companyDer Name des Kreditkartenunternehmens.
credit_card_last_four_digitsDie letzten 4 Ziffern der Kreditkarte.

Eigenschaften von E-Mail-Benachrichtigungen

Beschreibungen von Liquid-Eigenschaften, die du mit dem Objekt für E-Mail-Benachrichtigungen in Benachrichtigungsvorlagen verwenden kannst.
EigenschaftBeschreibung
shop.email_logo_urlDie URL für das Logo, die im Abschnitt „E-Mail-Vorlagen anpassen“ des Adminbereichs angegeben ist.
shop.email_logo_widthDie Logobreite (in Pixeln), die im Abschnitt „E-Mail-Vorlagen anpassen“ des Adminbereichs angegeben ist.
shop.email_accent_colorDer HEX-Code für die Akzentfarbe, der im Abschnitt „E-Mail-Vorlagen anpassen“ des Adminbereichs angegeben ist.

Eigenschaften von Shop-Guthaben

Die Eigenschaften, die Details über die Ausstellung eines Shop-Guthabens enthalten.

Beschreibungen von Liquid-Eigenschaften, die du mit dem Objekt für ausgestelltes Shop-Guthaben in Benachrichtigungsvorlagen verwenden kannst.
EigenschaftBeschreibung
issued_store_credit.amount

Der Betrag des Shop-Guthabens, das ausgestellt wurde.

Du kannst diesen Betrag mit den Liquid-Geldbetragsfiltern formatieren.

issued_store_credit.expires_at

Das Datum und die Uhrzeit, an dem bzw. zu der das ausgestellte Shop-Guthaben abläuft.

Du kannst diesen Betrag mit Liquid-Datumsfiltern formatieren.

issued_store_credit.balance_after_transaction

Das Guthaben des Shop-Guthabenkontos, nachdem die Gutschrift ausgestellt wurde.

Du kannst diesen Betrag mit den Liquid-Geldbetragsfiltern formatieren.

customerKundenobjekt, das die Attribute der Kund:innen-Ausgabe enthält.