Objekt objednávky a běžné proměnné

Každý dokument se vykresluje z jedné objednávky (u souhrnných šablon z vybraných objednávek). V Liquidu jsou pole objednávky dostupná přímo, například {{ name }}, a také pod order, například {{ order.name }}. Obojí funguje stejně. Proměnné odpovídají proměnným Shopify Order Printer, takže většina šablon z Order Printer funguje ve Foliantu beze změn. Karta Proměnné Liquid v editoru kódu je uvádí všechny a umožňuje v nich vyhledávat. Tento článek popisuje ty, které budete používat nejčastěji. Peněžní hodnoty jsou v centech; viz Peníze a měna v šablonách.

Objednávka

Proměnná	Co vypíše
`{{ order_name }}` nebo `{{ name }}`	Název objednávky s # (`#1042`)
`{{ order_number }}`	Číslo objednávky (`1042`)
`{{ id }}`	ID objednávky
`{{ po_number }}`	Číslo nákupní objednávky
`{{ date }}` nebo `{{ created_at }}`	Kdy byla objednávka zadána. Naformátujte ho filtrem `date`.
`{{ processed_at }}`, `{{ updated_at }}`, `{{ cancelled_at }}`, `{{ closed_at }}`	Další data objednávky
`{{ completed_at }}`	Kdy byl koncept objednávky dokončen
`{{ financial_status }}`	Stav platby, například `paid`, `pending` nebo `partially_refunded`
`{{ fulfillment_status }}`	Stav vyřízení, například `unfulfilled` nebo `fulfilled`
`{{ note }}`	Poznámka k objednávce
`{{ tags }}`	Štítky objednávky (seznam: projděte ho pomocí `{% for tag in tags %}`)
`{{ email }}`	E-mail objednávky
`{{ customer_locale }}`	Jazyk, ve kterém zákazník nakupoval
`{{ order_status_url }}`	Odkaz na stránku stavu objednávky (online objednávky)
`{{ total_items }}` nebo `{{ item_count }}`	Počet položek
`{{ total_weight }}`	Celková hmotnost; `{{ total_weight_in_grams \| weight_with_unit }}` přidá jednotku
`{{ order_currency }}` nebo `{{ currency }}`	Kód měny objednávky
`{% if pickup_in_store? %}…{% endif %}`	Zda se objednávka vyzvedává na prodejně
`{{ location.name }}`	Pobočka POS (objednávky z POS), s `address1`, `city`, `zip`, `country`, `phone`…

Součty

Součty vypisujte s peněžním filtrem, například {{ total_price | money }}.

Proměnná	Co to je
`subtotal_price`	Mezisoučet
`shipping_price`	Doprava
`total_discounts`	Všechny slevy
`order_level_discounts`	Slevy na celou objednávku (nejsou v cenách položek)
`total_tax`	Daň
`total_line_items_tax`, `total_shipping_tax`	Daň z položek a z dopravy
`total_duties`	Cla
`total_price`	Celková částka objednávky
`total_paid`	Zaplacená částka
`total_refunds`	Refundovaná částka
`total_gift_cards`	Zaplaceno dárkovými kartami

K dispozici jsou také current_subtotal_price, current_total_discounts, current_total_tax a current_total_price.

Zákazník a adresy

Proměnná	Co vypíše
`{{ customer.name }}`, `{{ customer.first_name }}`, `{{ customer.last_name }}`	Jméno zákazníka
`{{ customer.email }}`, `{{ customer.phone }}`	Kontaktní údaje
`{{ customer.note }}`	Poznámka k zákazníkovi
`{{ customer.tags }}`	Štítky zákazníka
`{{ customer.total_spent \| money }}`	Kolik zákazník utratil
`{% if customer.tax_exempt %}`	Zda je zákazník osvobozen od daně
`{{ shipping_address \| format_address }}`	Doručovací adresa, rozdělená do řádků
`{{ billing_address \| format_address }}`	Fakturační adresa

Každá adresa (shipping_address, billing_address a customer.default_address) má name, first_name, last_name, company, address1, address2, street, city, province, province_code, zip, country, country_code, phone a city_province_zip. {% if shipping_address.member_of_eu %} ověří, zda je země v EU.

Váš obchod

Proměnná	Co vypíše
`{{ shop.name }}` nebo `{{ shop_name }}`	Název vašeho obchodu
`{{ shop.email }}`, `{{ shop.phone }}`, `{{ shop.domain }}`	Kontaktní údaje
`{{ shop.address1 }}`, `{{ shop.city }}`, `{{ shop.zip }}`, `{{ shop.country }}`…	Vaše adresa, jak je nastavená v Shopify
`{{ shop_logo_url }}`, `{{ shop_logo_width }}`, `{{ shop_accent_color }}`	Vaše logo a barva zvýraznění z Nastavení › Branding
`{{ shop.vat_number }}`, `{{ shop.eori }}`	Vaše DIČ a EORI z Nastavení › Daně a právní údaje
`{{ seller.legal_lines \| join: ' · ' }}`	Vaše právní údaje, každý na jednom řádku, v jazyce dokumentu

Doprava, platby a odeslání

Proměnná	Co vypíše
`{{ shipping_method.title }}`	Způsob dopravy
`{% for shipping_line in shipping_lines %}`	Každý řádek dopravy: `title`, `code`, `price`
`{{ payment_method }}`, `{{ gateway }}`	Jak byla objednávka zaplacena
`{% for transaction in transactions %}`	Každá transakce: `amount`, `kind`, `status`, `gateway`, `created_at`
`{% for tax_line in tax_lines %}`	Každá daň: `title`, `rate`, `price`
`{% for discount in discounts %}`	Každá sleva: `code`, `amount`, `savings`
`{% for fulfillment in fulfillments %}`	Každé odeslání: `tracking_number`, `tracking_company`, `created_at`
`{{ latest_fulfillment }}`	Poslední odeslání
`{% for refund in refunds %}`	Každá refundace: `created_at`, `note`, `subtotal`, `total_tax`, `total`, `refund_line_items`
`{{ latest_refund }}`	Poslední refundace (dobropisy)
`{{ payment_terms.due_in_days }}`	Platební podmínky (B2B a koncepty objednávek), s `payment_schedules` a `current_payment_schedule.due_at`

Příklad

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

Dobré vědět

Prázdná hodnota nevypíše nic. Pomocí {% if … != blank %} vynecháte popisek, když hodnota chybí.
Šablony pro všechny vybrané objednávky používají místo jedné objednávky orders (procházení pomocí {% for order in orders %}), batch a pick_list. Viz sekci Souhrnné šablony na kartě Proměnné Liquid.
U faktur s DPH viz sekci DPH v referenci: tax_breakdown, buyer.vat_number, {% include 'vat_breakdown' %} a {% include 'legal_notes' %}. Viz Daně a právní údaje.

Vítejte

Začínáme

Tisk

Šablony

Editor šablon

Návrhy

Doručování PDF

Šablony e-mailů

Zákaznické účty

Exporty

Faktury a číslování

Daně a právní údaje

Integrace

Fakturace a tarify

Nastavení

Řešení problémů

Právní informace