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.
Auf dieser Seite
- Bestelleigenschaften
- Eigenschaften von Bestellentwürfen
- Eigenschaften des Zahlungsplans
- Eigenschaften des Zahlungsstatus
- Eigenschaften von Bundle-Komponenten
- Komponenteneigenschaften
- Eigenschaften von Einzelposten
- Eigenschaften von Einzelpostengruppen
- Eigenschaften von Rückerstattungen
- Fulfillment-Eigenschaften
- Eigenschaften vorbereiteter Pakete
- Zustellungseigenschaften
- Eigenschaften von Rabatten
- Abonnementeigenschaften
- Eigenschaften von E-Mail-Benachrichtigungen
- Eigenschaften von Shop-Guthaben
Bestelleigenschaften
Viele Eigenschaften einer Bestellung sind direkt über Liquid und in Vorlagen verfügbar.
| Eigenschaft | Beschreibung |
|---|---|
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
|
email | Die mit der Bestellung verknüpfte E-Mail. |
name |
In der Regel ist dies ein Rautezeichen, gefolgt von der Beispiel: #1004 |
order_name | Identisch 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. |
destination | Das Versandziel, an das die Artikel gesendet werden sollen. |
tags | Gibt 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. |
transactions | Gibt ein Array mit Transaktionen aus der Bestellung zurück. |
tax_price | Die 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.title | Der Name der Steuer. Zum Beispiel QST oder MwSt. |
tax_line.price | Der Steuerbetrag. |
tax_line.rate | Der Steuersatz als Dezimalzahl. Gibt 0,175 zurück, wenn der Satz 17,5 % beträgt. |
tax_line.rate_percentage | Der Steuersatz in einem lesbaren Format. Gibt 17,5 zurück, wenn der Satz 0,175 beträgt. |
customer | Kundenobjekt, das die Attribute der Kund:innen-Ausgabe enthält. |
billing_address | Die Rechnungsadresse. |
billing_address.first_name | Vorname des/der Kund:in. |
billing_address.last_name | Nachname des/der Kund:in. |
billing_address.company | Firmenname für die Rechnungsstellung. |
billing_address.phone | Telefonnummer aus der Rechnungsadresse. |
shop.name | Name deines Shops. |
shop.phone | Die Telefonnummer deines Shops. |
subtotal_price | Summe 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. |
discounts | Eine 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_status | Der 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_price |
Die Versandkosten. Beispiel: |
shipping_address | Die Lieferadresse. |
shipping_address.first_name | Der Vorname für die Lieferadresse. |
shipping_address.company | Firmenname für die Lieferadresse. |
shipping_address.phone | Telefonnummer aus der Lieferadresse. |
line_items | Liste aller Positionen in der Bestellung. |
line_items_including_zero_quantity | Liste 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_count | Die Gesamtmenge aller Artikel. |
fulfillment_status | Der aktuelle Fulfillmentstatus der Bestellung. Einer der folgenden: unfulfilled, partial, fulfilled. |
note | Die 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: |
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: |
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: |
landing_site_ref |
Überprüft die Landing-Page und extrahiert einen Referenzparameter daraus. Referenzparameter können sein: Wenn die
{% if landing_site_ref == 'my-tracking-token' %}
Meine Aktion ...
{% endif %}
|
cancelled | (boolesch) Gibt „true“ zurück, wenn die Bestellung storniert wurde. |
cancelled_at | Der Zeitpunkt, an dem die Bestellung storniert wurde. |
cancel_reason | Der 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: |
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
| Eigenschaft | Beschreibung |
|---|---|
id | Eine eindeutige ID des Bestellentwurfs für den internen Gebrauch. |
invoice_url | Ein 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 Du kannst Daten mit dem Liquid-Datumsfilter formatieren. |
user | Die Person, die den Bestellentwurf zuletzt geändert hat. |
user.name | Der Name der Person, die den Bestellentwurf zuletzt geändert hat. |
user.email | Die E-Mail-Adresse der Person, die den Bestellentwurf zuletzt geändert hat. |
email | Die mit dem Bestellentwurf verknüpfte E-Mail-Adresse. |
name | Die eindeutige number des Bestellentwurfs mit vorangestelltem Rautezeichen #. |
number | Die 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 Du kannst Daten mit dem Liquid-Datumsfilter formatieren. |
tags | Gibt 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_price | Die 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.price | Der Steuerbetrag. |
tax_line.rate | Der Steuersatz in Dezimalform. Ein Steuersatz von 17,5 % gibt beispielsweise 0.175 zurück. |
tax_line.rate_percentage | Der Steuersatz in Prozentform. Eine rate von 0,175 gibt beispielsweise 17.5 zurück. |
customer | Kundenobjekt, das die Attribute der Kund:innen-Ausgabe enthält. |
billing_address | Die Rechnungsadresse für den Bestellentwurf. |
billing_address.first_name | Der Vorname des/der Kund:in. |
billing_address.last_name | Der Nachname des/der Kund:in. |
billing_address.company | Der Unternehmensname in der Rechnungsadresse. |
billing_address.phone | Die Telefonnummer in der Rechnungsadresse. |
shop.name | Der Name deines Shops. |
shop.phone | Die Telefonnummer deines Shops. |
subtotal_price | Summe 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. |
discounts | Eine 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_price | Der Gesamtpreis der Bestellung (Zwischensumme + Versandkosten - Versandrabatt + Steuer). |
amount_due_now | Der auf der Rechnung des Bestellentwurfs geforderte Betrag. |
requires_shipping | Gibt 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.price | Der 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_name | Der Vorname für die Lieferadresse. |
shipping_address.company | Der Unternehmensname in der Lieferadresse. |
shipping_address.phone | Die Telefonnummer in der Lieferadresse. |
line_items | Eine Liste aller Positionen im Bestellentwurf. |
item_count | Eine Summe aller Artikelmengen im Bestellentwurf. |
note | Die 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
| Eigenschaft | Beschreibung |
|---|---|
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
| Eigenschaft | Beschreibung |
|---|---|
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 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)
| Eigenschaft | Beschreibung |
|---|---|
bundle_component.image_url | Die Bild-URL der Bundle-Komponente. |
bundle_component.product.title | Der Titel des Titels des Bundle-Komponenten-Produkts. |
bundle_component.quantity | Menge für die Bundle-Komponente. |
bundle_component.variant.title | Die aktuellen Namen der Optionswerte der Bundle-Komponenten-Variante, verbunden durch Beispiel: Klein / Rot |
Eigenschaften der Komponente
Jede component in der Liste der line_item.components hat die folgenden Eigenschaften. (Nur bei abgebrochenem Checkout)
`
| Eigenschaft | Beschreibung |
|---|---|
component.image_url | Die Bild-URL der Komponente. |
component.product.title | Der Titel des Titels des Komponentenprodukts. |
component.quantity | Menge für die Komponente. |
component.variant.title | Die aktuellen Namen der Optionswerte der Komponentenvariante, verbunden durch Beispiel: Klein / Rot |
Eigenschaften der Position
Jede line in der Liste der line_items oder subtotal_line_items hat die folgenden Eigenschaften.
| Eigenschaft | Beschreibung |
|---|---|
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_agreement | Das mit dieser Position verknüpfte Delivery Agreement. |
line.grams | Gewicht eines einzelnen Artikels. |
line.groups | Die Line item group des Artikels. |
line.image | Gibt 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_price | Der Preis multipliziert mit der Menge für diesen Artikel. |
line.original_line_price | Der Gesamtpreis für die Menge der in der Position enthaltenen Artikel, bevor Rabatte angewendet wurden. |
line.final_line_price | Der Gesamtpreis aller Artikel in der Position, einschließlich aller Rabattbeträge auf Positionsebene. |
line.pre_tax_price | Der Preis der Positionen vor Steuern, multipliziert mit der Menge der gekauften Position. |
line.price | Der Preis für einen einzelnen Artikel. |
line.product.metafields | Alle Metafelder auf Produktebene. Verwende die folgende Syntax: line.product.metafields.NAMESPACE.KEY |
line.product.title | Der aktuelle Name des Produkts. |
line.product.vendor | Der Anbieter für den Artikel. |
line.properties | Gibt 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.quantity | Menge für diesen Artikel. |
line.current_quantity | Die 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_allocation | Gibt 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.url | Die relative URL der Variante der Position. Die relative URL enthält nicht die Stamm-URL deines Shops (mystore.myshopify.com). |
line.variant.barcode | Der mit der Produktvariante verknüpfte Barcode. |
line.variant.compare_at_price | Der mit der Produktvariante verknüpfte Vergleichspreis. |
line.variant.image | Das 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.sku | Die mit der Produktvariante verknüpfte SKU. |
line.variant.title | Die aktuellen Namen der Optionswerte der Variante, die durch 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: |
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.
| Eigenschaft | Beschreibung |
|---|---|
line_item_group.display_title | Der Titel der Positionsgruppe. |
line_item_group.components | Liste der Positionskomponenten, die zur Gruppe gehören. |
line_item_group.image | Das Bild der Positionsgruppe. |
line_item_group.product_id | Die Produkt-ID der Positionsgruppe. |
line_item_group.variant | Das Variantenobjekt der Positionsgruppe. |
line_item_group.variant_id | Die Varianten-ID der Positionsgruppe. |
Eigenschaften von Rückerstattungen
| Eigenschaft | Beschreibung |
|---|---|
amount | Der zurückerstattete Betrag. |
refund_line_items | Eine 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:
| Eigenschaft | Beschreibung |
|---|---|
refund_line.line_item | Die line_item, die zurückerstattet wird. Diese hat Zugriff auf alle Eigenschaften von line_item. |
refund_line.quantity | Die Menge der Position, die zurückerstattet werden soll. |
Fulfillment-Eigenschaften
| Eigenschaft | Beschreibung |
|---|---|
service_name | Der Name des benutzerdefinierten Services, wie auf der Seite Einstellungen > Versand und Zustellung definiert. (Nur Fulfillment-Anfrage) |
fulfillment.estimated_delivery_at | Ein 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_items | Eine Liste der Fulfillment-Positionen, die ausgeführt werden sollen. |
fulfillment.item_count | Eine 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_company | Das Unternehmen, das das Tracking durchführt. |
fulfillment.tracking_numbers | Eine Liste von Trackingnummern. |
fulfillment.tracking_urls | Eine 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.
| Eigenschaft | Beschreibung |
|---|---|
fulfillment_line.line_item | Die line_item, die ausgeführt wird. Diese hat Zugriff auf alle Eigenschaften von line_item. |
fulfillment_line.quantity | Die Menge der Position, die ausgeführt wird. |
Eigenschaften vorbereiteter Pakete
Ein vorbereitetes Paket enthält die Artikel, die als abholbereit markiert sind.
| Eigenschaft | Beschreibung |
|---|---|
item_count | Eine Summe aller Artikelmengen im vorbereiteten Paket. |
prepared_package_line_items | Eine 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.
| Eigenschaft | Beschreibung |
|---|---|
line_item | Die zugehörige line_item. Diese hat Zugriff auf alle Eigenschaften von line_item. |
quantity | Die Menge der Position, die als abholbereit markiert wurde. |
Eigenschaften der Zustellung
| Eigenschaft | Beschreibung |
|---|---|
delivery_agreements | Liste aller Liefervereinbarungen für die Bestellung. |
delivery_instructions | Informationen 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_time | Informationen 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
| Eigenschaft | Beschreibung |
|---|---|
delivery_agreement.delivery_method_type | Die Art der Zustellmethode. |
delivery_agreement.delivery_method_name | Die Art der Zustellmethode, übersetzt in die Sprache des Checkouts, wenn sich diese von der Standard-Shopsprache unterscheidet. |
delivery_agreement.line_item_groups | Liste aller Positionsgruppen, die gebündelte Positionskomponenten in der Liefervereinbarung enthalten. |
delivery_agreement.line_items | Liste 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.
| Eigenschaft | Beschreibung |
|---|---|
discount_allocation.amount | Der 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_application | Die Rabattanwendung, die den Betrag der Position zuweist. |
Eigenschaften von „discount_application“
Jede discount_application in der Liste der discount_applications hat die folgenden Eigenschaften.
| Eigenschaft | Beschreibung |
|---|---|
discount_application.target_selection |
Beschreibt, wie ein Rabatt Positionen im Warenkorb auswählt, die rabattiert werden sollen. Eine von:
|
discount_application.target_type | Der 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_amount | Der Gesamtbetrag, um den der Preis einer Bestellung durch den Rabatt reduziert wird. |
discount_application.type | Die Art des Rabatts. Eine von: automatic, discount_code, manual oder script. |
discount_application.value | Der Wert des Rabatts. |
discount_application.value_type | Der 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
| Eigenschaft | Beschreibung |
|---|---|
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_frequency | Wie 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.
|
customer | Der/die Kund:in des Abonnements. |
line_items | Die Positionen im Zahlungszyklus für Abonnements. |
product_names | Eine Liste der Namen der Produkte, die im Zahlungszyklus für Abonnements enthalten sind. |
update_payment_method_url | Die 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_address | Die Rechnungsadresse des Abonnements. |
subtotal_price | Die Zwischensumme der Abonnementpositionen. |
shipping_price | Die Versandkosten des Abonnements. |
total_tax | Die Gesamtsteuer des Abonnements. |
total_price | Der Gesamtpreis des Abonnements. |
total_discounts | Die Gesamtrabatte des Abonnements. |
customer_self_serve_url | Die Self-Service-URL, die der/die Kund:in zur Verwaltung seiner/ihrer Abonnements verwenden kann. |
billing_attempt_expected_date | Das Rechnungsdatum für diesen Rechnungszyklus. |
next_billing_date | Das nächste nicht übersprungene Rechnungsdatum nach diesem Rechnungszyklus. |
last_attempted_billing_date | Das Datum des letzten Abrechnungsversuchs für den Rechnungszyklus. |
days_overdue | Die Anzahl der Tage, die die Abrechnung für diesen Rechnungszyklus überfällig ist. |
payment_instrument | Das 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 %}| Eigenschaft | Beschreibung |
|---|---|
url | Die URL zur Produktdetailseite für die Produktvariante der Position. |
requires_shipping | Gibt an, ob die Position einen physischen Versand erfordert. |
unit_price_measurement | Die Stückpreismessung der Position. |
selling_plan_allocation | Die 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 %}| Eigenschaft | Beschreibung |
|---|---|
title | Der 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 }}| Eigenschaft | Beschreibung |
|---|---|
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_brand | Die Marke der Kreditkarte. |
credit_card_company | Der Name des Kreditkartenunternehmens. |
credit_card_last_four_digits | Die letzten 4 Ziffern der Kreditkarte. |
Eigenschaften von E-Mail-Benachrichtigungen
| Eigenschaft | Beschreibung |
|---|---|
shop.email_logo_url | Die URL für das Logo, die im Abschnitt „E-Mail-Vorlagen anpassen“ des Adminbereichs angegeben ist. |
shop.email_logo_width | Die Logobreite (in Pixeln), die im Abschnitt „E-Mail-Vorlagen anpassen“ des Adminbereichs angegeben ist. |
shop.email_accent_color | Der 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.
| Eigenschaft | Beschreibung |
|---|---|
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. |
customer | Kundenobjekt, das die Attribute der Kund:innen-Ausgabe enthält. |