Obiekt zamówienia i najczęstsze zmienne

Każdy dokument powstaje z jednego zamówienia (a w przypadku szablonów zbiorczych z wybranych zamówień). W Liquid pola zamówienia są dostępne bezpośrednio, np. {{ name }}, a także w obiekcie order, np. {{ order.name }}. Oba zapisy działają tak samo. Zmienne są zgodne ze zmiennymi Shopify Order Printer, więc większość szablonów z Order Printer działa w Foliant bez zmian. Karta Zmienne Liquid w edytorze kodu zawiera listę wszystkich zmiennych z wyszukiwarką. Ten artykuł opisuje te, których będziesz używać najczęściej. Kwoty pieniężne są podane w centach (groszach); zobacz Kwoty i waluty w szablonach.

Zamówienie

Zmienna	Co wyświetla
`{{ order_name }}` lub `{{ name }}`	Nazwę zamówienia ze znakiem # (`#1042`)
`{{ order_number }}`	Numer zamówienia (`1042`)
`{{ id }}`	Identyfikator zamówienia
`{{ po_number }}`	Numer zamówienia zakupu (PO)
`{{ date }}` lub `{{ created_at }}`	Datę złożenia zamówienia. Sformatuj ją filtrem `date`.
`{{ processed_at }}`, `{{ updated_at }}`, `{{ cancelled_at }}`, `{{ closed_at }}`	Inne daty zamówienia
`{{ completed_at }}`	Datę ukończenia wersji roboczej zamówienia
`{{ financial_status }}`	Status płatności, np. `paid`, `pending` lub `partially_refunded`
`{{ fulfillment_status }}`	Status realizacji, np. `unfulfilled` lub `fulfilled`
`{{ note }}`	Notatkę do zamówienia
`{{ tags }}`	Tagi zamówienia (lista: przejdź po niej pętlą `{% for tag in tags %}`)
`{{ email }}`	Adres e-mail zamówienia
`{{ customer_locale }}`	Język, w którym klient robił zakupy
`{{ order_status_url }}`	Link do strony statusu zamówienia (zamówienia online)
`{{ total_items }}` lub `{{ item_count }}`	Liczbę pozycji
`{{ total_weight }}`	Łączną wagę; `{{ total_weight_in_grams \| weight_with_unit }}` dodaje jednostkę
`{{ order_currency }}` lub `{{ currency }}`	Kod waluty zamówienia
`{% if pickup_in_store? %}…{% endif %}`	Czy zamówienie jest odbierane w sklepie
`{{ location.name }}`	Lokalizację POS (zamówienia POS), z polami `address1`, `city`, `zip`, `country`, `phone`…

Sumy

Sumy wyświetlaj z filtrem kwot, np. {{ total_price | money }}.

Zmienna	Co oznacza
`subtotal_price`	Suma częściowa
`shipping_price`	Wysyłka
`total_discounts`	Wszystkie rabaty
`order_level_discounts`	Rabaty na całe zamówienie (nieuwzględnione w cenach pozycji)
`total_tax`	Podatek
`total_line_items_tax`, `total_shipping_tax`	Podatek od pozycji i od wysyłki
`total_duties`	Cła
`total_price`	Suma zamówienia
`total_paid`	Zapłacona kwota
`total_refunds`	Zwrócona kwota
`total_gift_cards`	Kwota zapłacona kartami podarunkowymi

Dostępne są też current_subtotal_price, current_total_discounts, current_total_tax i current_total_price.

Klient i adresy

Zmienna	Co wyświetla
`{{ customer.name }}`, `{{ customer.first_name }}`, `{{ customer.last_name }}`	Imię i nazwisko klienta
`{{ customer.email }}`, `{{ customer.phone }}`	Dane kontaktowe
`{{ customer.note }}`	Notatkę o kliencie
`{{ customer.tags }}`	Tagi klienta
`{{ customer.total_spent \| money }}`	Kwotę wydaną przez klienta
`{% if customer.tax_exempt %}`	Czy klient jest zwolniony z podatku
`{{ shipping_address \| format_address }}`	Adres wysyłki z podziałem na wiersze
`{{ billing_address \| format_address }}`	Adres rozliczeniowy

Każdy adres (shipping_address, billing_address i customer.default_address) ma pola name, first_name, last_name, company, address1, address2, street, city, province, province_code, zip, country, country_code, phone i city_province_zip. {% if shipping_address.member_of_eu %} sprawdza, czy kraj należy do UE.

Twój sklep

Zmienna	Co wyświetla
`{{ shop.name }}` lub `{{ shop_name }}`	Nazwę Twojego sklepu
`{{ shop.email }}`, `{{ shop.phone }}`, `{{ shop.domain }}`	Dane kontaktowe
`{{ shop.address1 }}`, `{{ shop.city }}`, `{{ shop.zip }}`, `{{ shop.country }}`…	Twój adres ustawiony w Shopify
`{{ shop_logo_url }}`, `{{ shop_logo_width }}`, `{{ shop_accent_color }}`	Twoje logo i kolor akcentu z Ustawienia › Branding
`{{ shop.vat_number }}`, `{{ shop.eori }}`	Twój numer VAT i EORI z Ustawienia › Podatki i dane prawne
`{{ seller.legal_lines \| join: ' · ' }}`	Twoje dane prawne, każde w osobnym wierszu, w języku dokumentu

Wysyłka, płatności i realizacje

Zmienna	Co wyświetla
`{{ shipping_method.title }}`	Metodę wysyłki
`{% for shipping_line in shipping_lines %}`	Każdą pozycję wysyłki: `title`, `code`, `price`
`{{ payment_method }}`, `{{ gateway }}`	Sposób zapłaty za zamówienie
`{% for transaction in transactions %}`	Każdą transakcję: `amount`, `kind`, `status`, `gateway`, `created_at`
`{% for tax_line in tax_lines %}`	Każdy podatek: `title`, `rate`, `price`
`{% for discount in discounts %}`	Każdy rabat: `code`, `amount`, `savings`
`{% for fulfillment in fulfillments %}`	Każdą realizację: `tracking_number`, `tracking_company`, `created_at`
`{{ latest_fulfillment }}`	Najnowszą realizację
`{% for refund in refunds %}`	Każdy zwrot: `created_at`, `note`, `subtotal`, `total_tax`, `total`, `refund_line_items`
`{{ latest_refund }}`	Najnowszy zwrot (faktury korygujące)
`{{ payment_terms.due_in_days }}`	Warunki płatności (B2B i wersje robocze zamówień), z `payment_schedules` i `current_payment_schedule.due_at`

Przykład

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

Warto wiedzieć

Pusta wartość nic nie wyświetla. Użyj {% if … != blank %}, aby pominąć etykietę, gdy brakuje wartości.
Szablony dla wszystkich wybranych zamówień zamiast pojedynczego zamówienia używają orders (pętla {% for order in orders %}), batch i pick_list. Zobacz sekcję Szablony zbiorcze na karcie Zmienne Liquid.
Informacje o fakturach VAT znajdziesz w sekcji VAT dokumentacji: tax_breakdown, buyer.vat_number, {% include 'vat_breakdown' %} i {% include 'legal_notes' %}. Zobacz Podatki i dane prawne.

Witamy

Pierwsze kroki

Drukowanie

Szablony

Edytor szablonów

Projekty

Dostarczanie plików PDF

Szablony e-maili

Konta klientów

Eksporty

Faktury i numeracja

Podatki i dane prawne

Integracje

Płatności i plany

Ustawienia

Rozwiązywanie problemów

Informacje prawne