Das Bestellobjekt und häufige Variablen

Jedes Dokument wird aus einer Bestellung erstellt (bei Sammelvorlagen aus den ausgewählten Bestellungen). In Liquid stehen die Felder der Bestellung direkt zur Verfügung, etwa {{ name }}, und zusätzlich unter order, etwa {{ order.name }}. Beides funktioniert gleich. Die Variablen entsprechen denen von Shopify Order Printer. Die meisten Order-Printer-Vorlagen funktionieren daher unverändert in Foliant. Der Tab Liquid-Variablen im Code-Editor listet alle Variablen auf, mit Suche. Dieser Artikel behandelt die Variablen, die Sie am häufigsten verwenden. Geldbeträge sind in Cent angegeben. Siehe Geld und Währung in Vorlagen.

Die Bestellung

Variable	Was sie ausgibt
`{{ order_name }}` oder `{{ name }}`	Den Bestellnamen, mit # (`#1042`)
`{{ order_number }}`	Die Bestellnummer (`1042`)
`{{ id }}`	Die Bestell-ID
`{{ po_number }}`	Die Bestellnummer des Käufers (PO-Nummer)
`{{ date }}` oder `{{ created_at }}`	Wann die Bestellung aufgegeben wurde. Formatieren Sie das Datum mit dem Filter `date`.
`{{ processed_at }}`, `{{ updated_at }}`, `{{ cancelled_at }}`, `{{ closed_at }}`	Weitere Bestelldaten
`{{ completed_at }}`	Wann ein Bestellentwurf abgeschlossen wurde
`{{ financial_status }}`	Den Zahlungsstatus, etwa `paid`, `pending` oder `partially_refunded`
`{{ fulfillment_status }}`	Den Ausführungsstatus, etwa `unfulfilled` oder `fulfilled`
`{{ note }}`	Die Bestellnotiz
`{{ tags }}`	Die Tags der Bestellung (eine Liste: Durchlaufen Sie sie mit `{% for tag in tags %}`)
`{{ email }}`	Die E-Mail-Adresse der Bestellung
`{{ customer_locale }}`	Die Sprache, in der der Kunde eingekauft hat
`{{ order_status_url }}`	Den Link zur Bestellstatusseite (Online-Bestellungen)
`{{ total_items }}` oder `{{ item_count }}`	Die Anzahl der Artikel
`{{ total_weight }}`	Das Gesamtgewicht; `{{ total_weight_in_grams \| weight_with_unit }}` fügt die Einheit hinzu
`{{ order_currency }}` oder `{{ currency }}`	Den Währungscode der Bestellung
`{% if pickup_in_store? %}…{% endif %}`	Ob die Bestellung im Geschäft abgeholt wird
`{{ location.name }}`	Den POS-Standort (POS-Bestellungen), mit `address1`, `city`, `zip`, `country`, `phone`…

Summen

Geben Sie Summen mit einem Geldfilter aus, zum Beispiel {{ total_price | money }}.

Variable	Was sie ist
`subtotal_price`	Die Zwischensumme
`shipping_price`	Versand
`total_discounts`	Alle Rabatte
`order_level_discounts`	Rabatte auf die gesamte Bestellung (nicht in den Positionspreisen enthalten)
`total_tax`	Steuern
`total_line_items_tax`, `total_shipping_tax`	Steuern auf Artikel und auf Versand
`total_duties`	Zölle
`total_price`	Die Bestellsumme
`total_paid`	Der bezahlte Betrag
`total_refunds`	Der erstattete Betrag
`total_gift_cards`	Mit Geschenkgutscheinen bezahlt

current_subtotal_price, current_total_discounts, current_total_tax und current_total_price sind ebenfalls verfügbar.

Kunde und Adressen

Variable	Was sie ausgibt
`{{ customer.name }}`, `{{ customer.first_name }}`, `{{ customer.last_name }}`	Den Namen des Kunden
`{{ customer.email }}`, `{{ customer.phone }}`	Kontaktdaten
`{{ customer.note }}`	Die Kundennotiz
`{{ customer.tags }}`	Die Tags des Kunden
`{{ customer.total_spent \| money }}`	Den Betrag, den der Kunde ausgegeben hat
`{% if customer.tax_exempt %}`	Ob der Kunde steuerbefreit ist
`{{ shipping_address \| format_address }}`	Die Lieferadresse, mit Zeilenumbrüchen formatiert
`{{ billing_address \| format_address }}`	Die Rechnungsadresse

Jede Adresse (shipping_address, billing_address und customer.default_address) hat name, first_name, last_name, company, address1, address2, street, city, province, province_code, zip, country, country_code, phone und city_province_zip. {% if shipping_address.member_of_eu %} prüft, ob das Land in der EU liegt.

Ihr Shop

Variable	Was sie ausgibt
`{{ shop.name }}` oder `{{ shop_name }}`	Den Namen Ihres Shops
`{{ shop.email }}`, `{{ shop.phone }}`, `{{ shop.domain }}`	Kontaktdaten
`{{ shop.address1 }}`, `{{ shop.city }}`, `{{ shop.zip }}`, `{{ shop.country }}`…	Ihre Adresse, wie in Shopify hinterlegt
`{{ shop_logo_url }}`, `{{ shop_logo_width }}`, `{{ shop_accent_color }}`	Ihr Logo und Ihre Akzentfarbe aus Einstellungen › Branding
`{{ shop.vat_number }}`, `{{ shop.eori }}`	Ihre USt-IdNr. und EORI aus Einstellungen › Steuern & Recht
`{{ seller.legal_lines \| join: ' · ' }}`	Ihre rechtlichen Angaben, je eine Zeile, in der Sprache des Dokuments

Versand, Zahlungen und Ausführungen

Variable	Was sie ausgibt
`{{ shipping_method.title }}`	Die Versandart
`{% for shipping_line in shipping_lines %}`	Jede Versandposition: `title`, `code`, `price`
`{{ payment_method }}`, `{{ gateway }}`	Wie die Bestellung bezahlt wurde
`{% for transaction in transactions %}`	Jede Transaktion: `amount`, `kind`, `status`, `gateway`, `created_at`
`{% for tax_line in tax_lines %}`	Jede Steuer: `title`, `rate`, `price`
`{% for discount in discounts %}`	Jeden Rabatt: `code`, `amount`, `savings`
`{% for fulfillment in fulfillments %}`	Jede Ausführung: `tracking_number`, `tracking_company`, `created_at`
`{{ latest_fulfillment }}`	Die neueste Ausführung
`{% for refund in refunds %}`	Jede Erstattung: `created_at`, `note`, `subtotal`, `total_tax`, `total`, `refund_line_items`
`{{ latest_refund }}`	Die neueste Erstattung (Gutschriften)
`{{ payment_terms.due_in_days }}`	Zahlungsbedingungen (B2B und Bestellentwürfe), mit `payment_schedules` und `current_payment_schedule.due_at`

Beispiel

<h1>{{ 'titles.invoice' | t }} {{ order_name }}</h1>
<p>{{ created_at | date: '%d %B %Y' }}</p>
<p>{{ shipping_address | format_address }}</p>
<p>{{ 'total' | t }}: {{ total_price | money }}</p>
{% if note != blank %}<p>{{ note | escape }}</p>{% endif %}

Gut zu wissen

Ein leerer Wert gibt nichts aus. Verwenden Sie {% if … != blank %}, um eine Beschriftung wegzulassen, wenn kein Wert vorhanden ist.
Vorlagen für alle ausgewählten Bestellungen verwenden statt einer einzelnen Bestellung orders (Schleife mit {% for order in orders %}), batch und pick_list. Siehe den Abschnitt Sammelvorlagen im Tab Liquid-Variablen.
Für Rechnungen mit Umsatzsteuer siehe den Abschnitt Umsatzsteuer der Referenz: tax_breakdown, buyer.vat_number, {% include 'vat_breakdown' %} und {% include 'legal_notes' %}. Siehe Steuern und Recht.

Willkommen

Erste Schritte

Drucken

Vorlagen

Vorlagen-Editor

Designs

PDF-Versand

E-Mail-Vorlagen

Kundenkonten

Exporte

Rechnungen und Nummerierung

Steuern und Recht

Integrationen

Abrechnung und Tarife

Einstellungen

Fehlerbehebung

Rechtliches