> ## Documentation Index
> Fetch the complete documentation index at: https://foliant-help.iforiti.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Tilausobjekti ja yleiset muuttujat

> Liquid-muuttujat, joita mallit käyttävät tilaukselle, asiakkaalle, osoitteille, kaupalle, toimitukselle, maksuille, hyvityksille ja toimituksille.

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](https://foliant-help.iforiti.com/fi/template-editor/liquid-money-and-currency.md).

## 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

```liquid theme={null}
<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](https://foliant-help.iforiti.com/fi/tax-and-legal.md).

## Aiheeseen liittyvät artikkelit

* [Tilausrivit malleissa](https://foliant-help.iforiti.com/fi/template-editor/liquid-line-items.md)
* [Raha ja valuutta malleissa](https://foliant-help.iforiti.com/fi/template-editor/liquid-money-and-currency.md)
* [Liquid-suodattimet](https://foliant-help.iforiti.com/fi/template-editor/liquid-filters.md)
* [Muokkaa mallin koodia](https://foliant-help.iforiti.com/fi/template-editor/code-editor.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.