Het order-object en veelgebruikte variabelen

Elk document wordt opgebouwd uit één bestelling (of, bij verzamelsjablonen, de geselecteerde bestellingen). In Liquid zijn de velden van de bestelling direct beschikbaar, zoals {{ name }}, en ook onder order, zoals {{ order.name }}. Beide werken hetzelfde. De variabelen volgen die van Shopify Order Printer, dus de meeste Order Printer-sjablonen werken in Foliant zoals ze zijn. Het tabblad Liquid-variabelen in de code-editor toont ze allemaal, met een zoekfunctie. Dit artikel behandelt de variabelen die je het meest gebruikt. Geldbedragen staan in centen; zie Geld en valuta in sjablonen.

De bestelling

Variabele	Wat het toont
`{{ order_name }}` of `{{ name }}`	De bestelnaam, met # (`#1042`)
`{{ order_number }}`	Het bestelnummer (`1042`)
`{{ id }}`	De bestel-ID
`{{ po_number }}`	Het inkoopordernummer
`{{ date }}` of `{{ created_at }}`	Wanneer de bestelling is geplaatst. Maak het op met de filter `date`.
`{{ processed_at }}`, `{{ updated_at }}`, `{{ cancelled_at }}`, `{{ closed_at }}`	Andere besteldatums
`{{ completed_at }}`	Wanneer een conceptbestelling is voltooid
`{{ financial_status }}`	De betaalstatus, zoals `paid`, `pending` of `partially_refunded`
`{{ fulfillment_status }}`	De uitvoeringsstatus, zoals `unfulfilled` of `fulfilled`
`{{ note }}`	De opmerking bij de bestelling
`{{ tags }}`	De tags van de bestelling (een lijst: loop erdoorheen met `{% for tag in tags %}`)
`{{ email }}`	Het e-mailadres van de bestelling
`{{ customer_locale }}`	De taal waarin de klant heeft gewinkeld
`{{ order_status_url }}`	De link naar de bestelstatuspagina (online bestellingen)
`{{ total_items }}` of `{{ item_count }}`	Het aantal artikelen
`{{ total_weight }}`	Het totale gewicht; `{{ total_weight_in_grams \| weight_with_unit }}` voegt de eenheid toe
`{{ order_currency }}` of `{{ currency }}`	De valutacode van de bestelling
`{% if pickup_in_store? %}…{% endif %}`	Of de bestelling in de winkel wordt opgehaald
`{{ location.name }}`	De POS-locatie (POS-bestellingen), met `address1`, `city`, `zip`, `country`, `phone`…

Totalen

Toon totalen met een geldfilter, bijvoorbeeld {{ total_price | money }}.

Variabele	Wat het is
`subtotal_price`	Het subtotaal
`shipping_price`	Verzending
`total_discounts`	Alle kortingen
`order_level_discounts`	Kortingen op de hele bestelling (niet in de regelprijzen)
`total_tax`	Belasting
`total_line_items_tax`, `total_shipping_tax`	Belasting op artikelen en op verzending
`total_duties`	Douanerechten
`total_price`	Het totaal van de bestelling
`total_paid`	Wat is betaald
`total_refunds`	Wat is terugbetaald
`total_gift_cards`	Betaald met cadeaubonnen

current_subtotal_price, current_total_discounts, current_total_tax en current_total_price zijn ook beschikbaar.

Klant en adressen

Variabele	Wat het toont
`{{ customer.name }}`, `{{ customer.first_name }}`, `{{ customer.last_name }}`	De naam van de klant
`{{ customer.email }}`, `{{ customer.phone }}`	Contactgegevens
`{{ customer.note }}`	De opmerking bij de klant
`{{ customer.tags }}`	De tags van de klant
`{{ customer.total_spent \| money }}`	Wat de klant heeft uitgegeven
`{% if customer.tax_exempt %}`	Of de klant is vrijgesteld van belasting
`{{ shipping_address \| format_address }}`	Het verzendadres, opgemaakt met regeleinden
`{{ billing_address \| format_address }}`	Het factuuradres

Elk adres (shipping_address, billing_address en customer.default_address) heeft name, first_name, last_name, company, address1, address2, street, city, province, province_code, zip, country, country_code, phone en city_province_zip. {% if shipping_address.member_of_eu %} controleert of het land in de EU ligt.

Je winkel

Variabele	Wat het toont
`{{ shop.name }}` of `{{ shop_name }}`	De naam van je winkel
`{{ shop.email }}`, `{{ shop.phone }}`, `{{ shop.domain }}`	Contactgegevens
`{{ shop.address1 }}`, `{{ shop.city }}`, `{{ shop.zip }}`, `{{ shop.country }}`…	Je adres, zoals ingesteld in Shopify
`{{ shop_logo_url }}`, `{{ shop_logo_width }}`, `{{ shop_accent_color }}`	Je logo en accentkleur uit Instellingen › Huisstijl
`{{ shop.vat_number }}`, `{{ shop.eori }}`	Je btw-nummer en EORI uit Instellingen › Belasting & juridisch
`{{ seller.legal_lines \| join: ' · ' }}`	Je juridische gegevens, elk op een eigen regel, in de taal van het document

Verzending, betalingen en uitvoeringen

Variabele	Wat het toont
`{{ shipping_method.title }}`	De verzendmethode
`{% for shipping_line in shipping_lines %}`	Elke verzendregel: `title`, `code`, `price`
`{{ payment_method }}`, `{{ gateway }}`	Hoe de bestelling is betaald
`{% for transaction in transactions %}`	Elke transactie: `amount`, `kind`, `status`, `gateway`, `created_at`
`{% for tax_line in tax_lines %}`	Elke belasting: `title`, `rate`, `price`
`{% for discount in discounts %}`	Elke korting: `code`, `amount`, `savings`
`{% for fulfillment in fulfillments %}`	Elke uitvoering: `tracking_number`, `tracking_company`, `created_at`
`{{ latest_fulfillment }}`	De meest recente uitvoering
`{% for refund in refunds %}`	Elke terugbetaling: `created_at`, `note`, `subtotal`, `total_tax`, `total`, `refund_line_items`
`{{ latest_refund }}`	De meest recente terugbetaling (creditnota’s)
`{{ payment_terms.due_in_days }}`	Betalingsvoorwaarden (B2B- en conceptbestellingen), met `payment_schedules` en `current_payment_schedule.due_at`

Voorbeeld

<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 %}

Goed om te weten

Een lege waarde toont niets. Gebruik {% if … != blank %} om een label weg te laten als er geen waarde is.
Sjablonen voor alle geselecteerde bestellingen gebruiken orders (loop met {% for order in orders %}), batch en pick_list in plaats van één bestelling. Zie de sectie Verzamelsjablonen van het tabblad Liquid-variabelen.
Voor btw-facturen, zie de sectie Btw van het overzicht: tax_breakdown, buyer.vat_number, {% include 'vat_breakdown' %} en {% include 'legal_notes' %}. Zie Belasting en juridisch.

Welkom

Aan de slag

Afdrukken

Sjablonen

Sjablooneditor

Ontwerpen

PDF-levering

E-mailtemplates

Klantaccounts

Exports

Facturen en nummering

Belasting en juridisch

Integraties

Facturering en abonnementen

Instellingen

Problemen oplossen

Juridisch