Tilausobjekti ja yleiset muuttujat

Jokainen asiakirja muodostetaan yhdestä tilauksesta (tai koostemalleissa valituista tilauksista). Liquidissa tilauksen kentät ovat käytettävissä suoraan, esimerkiksi {{ name }}, ja myös order-objektin alla, esimerkiksi {{ order.name }}. Molemmat toimivat samalla tavalla. Muuttujat noudattavat Shopify Order Printerin muuttujia, joten useimmat Order Printer -mallit toimivat Foliantissa sellaisenaan. Koodieditorin Liquid-muuttujat-välilehti listaa ne kaikki, ja voit hakea niistä. Tässä artikkelissa käydään läpi useimmin käytetyt. Rahasummat ovat sentteinä; katso Raha ja valuutta malleissa.

Tilaus

Muuttuja	Mitä se tulostaa
`{{ order_name }}` tai `{{ name }}`	Tilauksen nimi #-merkin kanssa (`#1042`)
`{{ order_number }}`	Tilausnumero (`1042`)
`{{ id }}`	Tilauksen tunnus
`{{ po_number }}`	Ostotilauksen numero
`{{ date }}` tai `{{ created_at }}`	Milloin tilaus tehtiin. Muotoile se `date`-suodattimella.
`{{ processed_at }}`, `{{ updated_at }}`, `{{ cancelled_at }}`, `{{ closed_at }}`	Tilauksen muut päivämäärät
`{{ completed_at }}`	Milloin luonnostilaus valmistui
`{{ financial_status }}`	Maksun tila, esimerkiksi `paid`, `pending` tai `partially_refunded`
`{{ fulfillment_status }}`	Toimituksen tila, esimerkiksi `unfulfilled` tai `fulfilled`
`{{ note }}`	Tilauksen huomautus
`{{ tags }}`	Tilauksen tunnisteet (lista: käy se läpi silmukalla `{% for tag in tags %}`)
`{{ email }}`	Tilauksen sähköpostiosoite
`{{ customer_locale }}`	Kieli, jolla asiakas teki ostoksensa
`{{ order_status_url }}`	Linkki tilauksen tilasivulle (verkkotilaukset)
`{{ total_items }}` tai `{{ item_count }}`	Tuotteiden määrä
`{{ total_weight }}`	Kokonaispaino; `{{ total_weight_in_grams \| weight_with_unit }}` lisää yksikön
`{{ order_currency }}` tai `{{ currency }}`	Tilauksen valuuttakoodi
`{% if pickup_in_store? %}…{% endif %}`	Noudetaanko tilaus myymälästä
`{{ location.name }}`	POS-sijainti (POS-tilaukset), sekä `address1`, `city`, `zip`, `country`, `phone`…

Summat

Tulosta summat rahasuodattimella, esimerkiksi {{ total_price | money }}.

Muuttuja	Mikä se on
`subtotal_price`	Välisumma
`shipping_price`	Toimitus
`total_discounts`	Kaikki alennukset
`order_level_discounts`	Koko tilausta koskevat alennukset (eivät sisälly rivihintoihin)
`total_tax`	Vero
`total_line_items_tax`, `total_shipping_tax`	Tuotteiden vero ja toimituksen vero
`total_duties`	Tullit
`total_price`	Tilauksen kokonaissumma
`total_paid`	Maksettu summa
`total_refunds`	Hyvitetty summa
`total_gift_cards`	Lahjakorteilla maksettu

Käytettävissä ovat myös current_subtotal_price, current_total_discounts, current_total_tax ja current_total_price.

Asiakas ja osoitteet

Muuttuja	Mitä se tulostaa
`{{ customer.name }}`, `{{ customer.first_name }}`, `{{ customer.last_name }}`	Asiakkaan nimi
`{{ customer.email }}`, `{{ customer.phone }}`	Yhteystiedot
`{{ customer.note }}`	Asiakkaan huomautus
`{{ customer.tags }}`	Asiakkaan tunnisteet
`{{ customer.total_spent \| money }}`	Asiakkaan käyttämä summa
`{% if customer.tax_exempt %}`	Onko asiakas vapautettu verosta
`{{ shipping_address \| format_address }}`	Toimitusosoite rivinvaihdoin aseteltuna
`{{ billing_address \| format_address }}`	Laskutusosoite

Jokaisella osoitteella (shipping_address, billing_address ja customer.default_address) on kentät name, first_name, last_name, company, address1, address2, street, city, province, province_code, zip, country, country_code, phone ja city_province_zip. {% if shipping_address.member_of_eu %} tarkistaa, onko maa EU:ssa.

Kauppasi

Muuttuja	Mitä se tulostaa
`{{ shop.name }}` tai `{{ shop_name }}`	Kauppasi nimi
`{{ shop.email }}`, `{{ shop.phone }}`, `{{ shop.domain }}`	Yhteystiedot
`{{ shop.address1 }}`, `{{ shop.city }}`, `{{ shop.zip }}`, `{{ shop.country }}`…	Osoitteesi Shopifyssa asetetun mukaisesti
`{{ shop_logo_url }}`, `{{ shop_logo_width }}`, `{{ shop_accent_color }}`	Logosi ja korostusvärisi kohdasta Asetukset › Brändäys
`{{ shop.vat_number }}`, `{{ shop.eori }}`	ALV-numerosi ja EORI-numerosi kohdasta Asetukset › Verot ja oikeudelliset tiedot
`{{ seller.legal_lines \| join: ' · ' }}`	Oikeudelliset tietosi, kukin omalla rivillään, asiakirjan kielellä

Toimitus, maksut ja toimitukset

Muuttuja	Mitä se tulostaa
`{{ shipping_method.title }}`	Toimitustapa
`{% for shipping_line in shipping_lines %}`	Jokainen toimitusrivi: `title`, `code`, `price`
`{{ payment_method }}`, `{{ gateway }}`	Miten tilaus maksettiin
`{% for transaction in transactions %}`	Jokainen tapahtuma: `amount`, `kind`, `status`, `gateway`, `created_at`
`{% for tax_line in tax_lines %}`	Jokainen vero: `title`, `rate`, `price`
`{% for discount in discounts %}`	Jokainen alennus: `code`, `amount`, `savings`
`{% for fulfillment in fulfillments %}`	Jokainen toimitus: `tracking_number`, `tracking_company`, `created_at`
`{{ latest_fulfillment }}`	Viimeisin toimitus
`{% for refund in refunds %}`	Jokainen hyvitys: `created_at`, `note`, `subtotal`, `total_tax`, `total`, `refund_line_items`
`{{ latest_refund }}`	Viimeisin hyvitys (hyvityslaskut)
`{{ payment_terms.due_in_days }}`	Maksuehdot (B2B- ja luonnostilaukset), sekä `payment_schedules` ja `current_payment_schedule.due_at`

Esimerkki

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

Hyvä tietää

Tyhjä arvo ei tulosta mitään. Käytä ehtoa {% if … != blank %}, jos haluat jättää otsikon pois, kun arvoa ei ole.
Kaikkien valittujen tilausten mallit käyttävät yksittäisen tilauksen sijaan muuttujia orders (silmukka {% for order in orders %}), batch ja pick_list. Katso Liquid-muuttujat-välilehden Koostemallit-osio.
ALV-laskuja varten katso viiteaineiston ALV-osio: tax_breakdown, buyer.vat_number, {% include 'vat_breakdown' %} ja {% include 'legal_notes' %}. Katso Verot ja oikeudelliset tiedot.

Tervetuloa

Aloittaminen

Tulostaminen

Mallit

Mallieditori

Mallit

PDF-toimitus

Sähköpostipohjat

Asiakastilit

Viennit

Laskut ja numerointi

Verot ja oikeudelliset tiedot

Integraatiot

Laskutus ja paketit

Asetukset

Vianmääritys

Oikeudelliset tiedot